ErtiPrenci/inventory-public
GitHub: ErtiPrenci/inventory-public
一个基于 Go 和 AWS Lambda 的库存管理 REST API 演示项目,集成了产品目录、销售订单、PDF 文档生成和 JWT 认证功能。
Stars: 0 | Forks: 0
# 📦 inventory-public - 简单库存管理 API 演示
[](https://github.com/ErtiPrenci/inventory-public/releases)
## 🚀 什么是 inventory-public?
inventory-public 是一个演示应用程序,展示了如何使用 API 管理产品库存。它处理诸如使用安全 token 进行用户登录、自动生成报价单和发票的 PDF,以及在 AWS Lambda 云端运行等任务。您可以试用它,以了解这些部分如何协同工作以有效地管理库存。
此应用程序使用 Go 语言构建,这是一种快速且可靠的编程语言。它使用 PostgreSQL 存储数据,并使用 Terraform 设置云服务。虽然它是为开发者设计的,但本指南将帮助您(即使您没有编程经验)在 Windows 电脑上下载并运行它。
## 🎯 关键特性
- 使用基于 JWT 的登录身份验证保护数据。
- 自动创建 PDF 报价单和发票。
- 连接 PostgreSQL 数据库以保存产品和订单详情。
- 在 AWS Lambda 上运行,这意味着它在云中工作而无需服务器。
- 使用 GitHub Actions 进行自动设置和更新。
- 支持常见的库存操作,如添加、查看和更新产品。
## 💻 系统要求
要使用 inventory-public,您的 Windows PC 需要:
- Windows 10 或更高版本(64 位)
- 至少 4 GB 内存 (RAM)
- 2 GHz 或更快的处理器
- 1 GB 可用磁盘空间
- 用于下载和云功能的互联网连接
- 可选:如果您想尝试云部署,需要 AWS 账户(本地使用不需要)
## 🌐 涵盖的主题
inventory-public 涉及:
- API 和 RESTful 服务
- 管理库存和产品数据
- 使用 JWT (JSON Web Tokens) 进行安全登录
- 自动生成业务文档的 PDF
- 使用 AWS Lambda 进行 Serverless 云部署
- 使用 Terraform 进行基础设施自动化
- 使用 GitHub Actions 进行持续集成
- PostgreSQL 数据库处理
## 🔽 下载 inventory-public
点击下方的绿色按钮访问发布页面,并获取该应用程序的最新 Windows 版本:
[](https://github.com/ErtiPrenci/inventory-public/releases)
在该页面上,查找名为 `inventory-public-windows.zip` 或 `inventory-public.exe` 的文件。下载适合您系统的文件。
## 🛠️ 如何在 Windows 上安装和运行
按照以下步骤让 inventory-public 在您的 PC 上运行。
### 1. 下载文件
- 前往 [Releases 页面](https://github.com/ErtiPrenci/inventory-public/releases)。
- 按日期查找最新的发布版本。
- 将 Windows 版本的 zip 文件(或 `.exe`)下载到您的 PC。
- 如果是 zip 文件,右键单击并选择“全部解压缩”以解压。
### 2. 验证您的环境
inventory-public 需要 Go runtime 的最新版本才能运行。您不需要编写代码,但应用程序需要 Go 库。
- 访问 [https://go.dev/dl/](https://go.dev/dl/) 并下载 Go 的 Windows 安装程序(1.20 或更高版本)。
- 运行安装程序并按照提示完成安装。
### 3. 准备 PostgreSQL 数据库
inventory-public 使用 PostgreSQL 来保存您的库存数据。
- 从 [https://www.postgresql.org/download/windows/](https://www.postgresql.org/download/windows/) 下载 Windows 版的 PostgreSQL。
- 使用默认设置安装 PostgreSQL。为“postgres”用户设置密码。
- 打开“pgAdmin”应用程序并创建一个名为 `inventory` 的新数据库。
- 记住用户名、密码和数据库名称;您很快就会用到它们。
### 4. 配置应用程序
- 导航到您解压 inventory-public 的文件夹。
- 找到名为 `config.example.json` 的文件。
- 复制它并将新文件重命名为 `config.json`。
- 使用记事本打开 `config.json`。
- 更改数据库设置以匹配您的 PostgreSQL 配置:
```
{
"database": {
"host": "localhost",
"port": 5432,
"user": "postgres",
"password": "your_password",
"dbname": "inventory"
},
"jwtSecret": "yourSecretKey"
}
```
- 将 `"your_password"` 替换为您在 PostgreSQL 安装期间设置的密码。
- 将 `"yourSecretKey"` 替换为您想要用于登录安全的任何强密钥。
- 保存并关闭文件。
### 5. 运行应用程序
- 打开 Windows 命令提示符(在开始菜单中输入 `cmd`)。
- 使用 `cd` 命令进入您的应用程序文件夹,例如:
```
cd C:\Users\YourName\Downloads\inventory-public
```
- 通过键入以下命令启动应用程序:
```
inventory-public.exe
```
- 应用程序将启动并显示一条消息,例如 `Server running on http://localhost:8080`。
### 6. 尝试使用 API
inventory-public 在您的 PC 上作为 Web 服务运行。您可以使用 Web 浏览器或 Postman 等 API 工具对其进行测试。
- 打开浏览器并访问 [http://localhost:8080](http://localhost:8080)。
- 您将看到有关 API 的基本信息。
- 要登录并使用系统,请使用用户名和密码向 `/login` 发送 POST 请求(使用文档中提供的示例凭据)。
## 🔍 无需编程使用 inventory-public
您不需要编程技能即可试用此应用程序。但是,一些工具可以帮助您使用 API:
- **Postman:** 一个用于发送和接收 API 请求的免费应用程序。在 https://www.postman.com/downloads/ 下载。
- **curl:** Windows 10 及更高版本中包含的命令行工具。在命令提示符中使用它发送命令。
使用 curl 登录的示例:
```
curl -X POST http://localhost:8080/login -d "{\"username\":\"demo\",\"password\":\"demo\"}" -H "Content-Type: application/json"
```
这将返回您在调用 API 其他部分时使用的 token。
## 🔧 故障排除提示
- 如果您看到有关数据库连接的错误,请仔细检查您的 `config.json` 文件以确保设置正确。
- 确保 PostgreSQL 服务器正在运行。
- 确认 Go runtime 已正确安装。
- 检查您是否以足够的权限运行命令提示符。
- 防火墙或杀毒软件可能会阻止该应用程序。如有必要,请允许它。
## 📖 了解更多
inventory-public 在发布包内的 `docs` 文件夹中包含有关 API 端点、设置和配置的文档。您也可以访问 GitHub 仓库获取源代码和更新:
https://github.com/ErtiPrenci/inventory-public
## 🔽 再次下载 inventory-public
[](https://github.com/ErtiPrenci/inventory-public/releases)
标签:API开发, AWS Lambda, DNS解析, ECS, ERP Demo, EVTX分析, GitHub Actions, Go语言, JWT认证, PDF生成, PostgreSQL, REST API, Terraform, Web后端, 中间件, 产品目录, 企业资源计划, 发票系统, 库存管理, 开源项目, 报价单, 数据库管理, 日志审计, 测试用例, 程序破解, 网络测绘, 自动笔记, 销售订单