CoolkHz/gptibo

选用指南

AI 根据 README 整理 · 2026/10/21 02:31:47

使用方式

通过网页访问商城、管理后台和代理工作台，支持两种后端部署方式：Go+PostgreSQL 或 Cloudflare Workers+D1。

查看 README 依据

# GPTibo **可自托管的数字商品商城，包含用户前台、管理后台与代理工作台。** [](https://github.com/CoolkHz/gptibo/actions/workflows/verify.yml) [MIT License](LICENSE) · [快速开始](#快速开始) · [后端文档](services/storefront/README.md) · [安全说明](SECURITY.md) GPTibo 将商品展示、下单支付、订单交付、售后处理和代理商店管理整合在同一套系统中。前端使用 React 与 TypeScript，后端提供 Go + PostgreSQL 和 Cloudflare Workers + D1 两种实现，便于按部署环境选择和二次开发。 原站点已停止运营，项目现以 MIT 许可证开放源码。支付与供应商接入使用匿名适配器，需要配置自己的服务后使用。 ## 功能 | 模块 | 能力 | | --- | --- | | 用户商城 | 商品与套餐展示、下单、支付状态、订单查询、售后申请、中英文界面、深浅色主题 |

npx vite --config services/storefront/vite.config.ts ``` 访问 `http://127.0.0.1:5175`。前端会将 `/api` 请求代理到本机 Go API 的 `8093` 端口。 原生启动、管理员登录、邮件服务与接入配置见 [Go 后端文档](services/storefront/README.md)。Windows 用户可使用后端目录中的 `scripts/init-secrets.ps1` 初始化秘密。 ### 方式二：Cloudflare Workers + D1 在仓库根目录执行： ```sh cp .dev.vars.example .dev.vars npx wrangler d1 migrations apply gptibo-local --local npm run preview:worker ``` 默认访问 `http://127.0.0.1:8787`。需要前端热更新时，另开终端运行 `npm run dev`，访问 `http://127.0.0.1:5173`；API 请求会转发到本地 Worker。 `.dev.vars` 保存本地配置，不应提交。远程部署时需创建自己的 Cloudflare 资源，并替换 `wrangler.jsonc` 中的占位配置。

### 页面入口 | 页面 | 路径 | | --- | --- | | 商城 | `/` | | 管理后台 | `/admin` | | 代理工作台 | `/partner` | 管理员登录需要配置自己的管理员身份、TOTP 和邮件验证服务。默认配置不提供可直接登录的管理员账号，也不会发起真实支付、采购或通知。 ## 项目结构 ```text src/ 商城前台、管理后台与代理工作台 services/storefront/ Go API、业务 Worker、迁移与部署配置 worker/ Cloudflare Workers 后端 migrations/ D1 数据库迁移 emails/ 邮件模板 tests/ 前端与 Worker 业务测试 scripts/ 构建与源码检查脚本 public/ 静态资源 .github/workflows/ 持续集成 ``` ## 配置与接入 | 配置文件 | 用途 | | --- | --- |

部署要求

需要 Node.js 24、npm、Git、Python 3；使用 Go 后端需 Docker Compose 或 Go 1.26+ 和 PostgreSQL；使用 Cloudflare 后端需 Wrangler 和 Cloudflare 资源。

查看 README 依据

| 管理后台 | 商品定价、订单与客户管理、退款处理、代理管理、结算与通知配置 | | 代理工作台 | 独立商店、品牌设置、自定义域名、商品管理、订单统计与下级代理管理 | | 业务后端 | 身份验证、支付回调、采购适配、异步任务、邮件通知与交易状态管理 | | 开发与部署 | 数据库迁移、Docker Compose、自动化测试、GitHub Actions 与源码安全扫描 | ## 技术栈 | 层级 | 技术 | | --- | --- | | 前端 | React 19、TypeScript、Vite、Tailwind CSS | | Go 后端 | Go、Gin、PostgreSQL，API 与业务 Worker 分进程运行 | | Cloudflare 后端 | Workers、D1、Wrangler | | 邮件 | React Email | | 验证 | Node.js Test Runner、Go Test、Gitleaks | 两套后端均服务于商城。当前公开版本包含商城侧供应商适配器，**不包含独立供货平台及供应商执行系统**。 ## 快速开始 ### 环境准备 - Node.js 24、npm、Git、Python 3。 - 使用 Go 后端时，准备 Docker Compose；原生开发需要 Go 1.26+ 和 PostgreSQL。

- 使用 Cloudflare 后端时，通过项目内的 Wrangler 运行本地环境。 ```sh git clone https://github.com/CoolkHz/gptibo.git cd gptibo npm ci ``` 选择下面一种后端方式运行。 ### 方式一：Go + PostgreSQL 在仓库根目录执行以下命令，初始化本地秘密、数据库和运行角色： ```sh cd services/storefront python3 scripts/init-secrets.py cp .env.example .env docker compose config --quiet docker compose build api docker compose up -d --wait postgres docker compose --profile maintenance run --rm maintenance migrate docker compose --profile maintenance run --rm maintenance grant-runtime docker compose up -d --wait api worker ``` 另开终端，在仓库根目录启动前端： ```sh

npx vite --config services/storefront/vite.config.ts ``` 访问 `http://127.0.0.1:5175`。前端会将 `/api` 请求代理到本机 Go API 的 `8093` 端口。 原生启动、管理员登录、邮件服务与接入配置见 [Go 后端文档](services/storefront/README.md)。Windows 用户可使用后端目录中的 `scripts/init-secrets.ps1` 初始化秘密。 ### 方式二：Cloudflare Workers + D1 在仓库根目录执行： ```sh cp .dev.vars.example .dev.vars npx wrangler d1 migrations apply gptibo-local --local npm run preview:worker ``` 默认访问 `http://127.0.0.1:8787`。需要前端热更新时，另开终端运行 `npm run dev`，访问 `http://127.0.0.1:5173`；API 请求会转发到本地 Worker。 `.dev.vars` 保存本地配置，不应提交。远程部署时需创建自己的 Cloudflare 资源，并替换 `wrangler.jsonc` 中的占位配置。

已知限制

当前公开版本不包含独立供货平台及供应商执行系统；默认配置不提供可直接登录的管理员账号，也不会发起真实支付、采购或通知。

查看 README 依据

| 管理后台 | 商品定价、订单与客户管理、退款处理、代理管理、结算与通知配置 | | 代理工作台 | 独立商店、品牌设置、自定义域名、商品管理、订单统计与下级代理管理 | | 业务后端 | 身份验证、支付回调、采购适配、异步任务、邮件通知与交易状态管理 | | 开发与部署 | 数据库迁移、Docker Compose、自动化测试、GitHub Actions 与源码安全扫描 | ## 技术栈 | 层级 | 技术 | | --- | --- | | 前端 | React 19、TypeScript、Vite、Tailwind CSS | | Go 后端 | Go、Gin、PostgreSQL，API 与业务 Worker 分进程运行 | | Cloudflare 后端 | Workers、D1、Wrangler | | 邮件 | React Email | | 验证 | Node.js Test Runner、Go Test、Gitleaks | 两套后端均服务于商城。当前公开版本包含商城侧供应商适配器，**不包含独立供货平台及供应商执行系统**。 ## 快速开始 ### 环境准备 - Node.js 24、npm、Git、Python 3。 - 使用 Go 后端时，准备 Docker Compose；原生开发需要 Go 1.26+ 和 PostgreSQL。

### 页面入口 | 页面 | 路径 | | --- | --- | | 商城 | `/` | | 管理后台 | `/admin` | | 代理工作台 | `/partner` | 管理员登录需要配置自己的管理员身份、TOTP 和邮件验证服务。默认配置不提供可直接登录的管理员账号，也不会发起真实支付、采购或通知。 ## 项目结构 ```text src/ 商城前台、管理后台与代理工作台 services/storefront/ Go API、业务 Worker、迁移与部署配置 worker/ Cloudflare Workers 后端 migrations/ D1 数据库迁移 emails/ 邮件模板 tests/ 前端与 Worker 业务测试 scripts/ 构建与源码检查脚本 public/ 静态资源 .github/workflows/ 持续集成 ``` ## 配置与接入 | 配置文件 | 用途 | | --- | --- |