[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-76341":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":12,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":14,"stars7d":14,"stars30d":15,"stars90d":13,"forks30d":13,"starsTrendScore":16,"compositeScore":17,"rankGlobal":8,"rankLanguage":8,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":8,"pushedAt":8,"updatedAt":23,"readmeContent":24,"aiSummary":25,"trendingCount":13,"starSnapshotCount":13,"syncStatus":12,"lastSyncTime":26,"discoverSource":27},76341,"xu-shop","imShire\u002Fxu-shop","imShire",null,"Go",144,6,2,0,1,74,3,2.54,"GNU Affero General Public License v3.0",false,"main",true,[],"2026-06-12 02:03:41","# xu-shop\n\n**单商家私域电商全栈开源项目**\n\n微信小程序 + H5 + Vue3 后台管理 + Go 后端，开箱即用的私域电商解决方案\n\n[![License: AGPL v3](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-AGPL_v3-blue.svg)](https:\u002F\u002Fwww.gnu.org\u002Flicenses\u002Fagpl-3.0)\n[![Go](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FGo-1.22-00ADD8?logo=go)](https:\u002F\u002Fgolang.org)\n[![Vue](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVue-3.4-4FC08D?logo=vue.js)](https:\u002F\u002Fvuejs.org)\n[![Taro](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTaro-4.x-00C8B5)](https:\u002F\u002Ftaro.zone)\n[![PostgreSQL](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPostgreSQL-15-316192?logo=postgresql)](https:\u002F\u002Fpostgresql.org)\n\n\u003C\u002Fdiv>\n\n---\n\n## 项目简介\n\nxu-shop 是一套面向**单商家私域电商**场景的完整技术方案，覆盖从用户下单到仓库发货的完整业务闭环。\n\n流量入口在微信生态（小程序 \u002F 公众号 H5 \u002F 企微），运营和履约在 Web 后台完成。项目使用 **Go + PostgreSQL** 构建高性能后端，**Taro** 实现\"一套代码跑小程序和 H5\"，**Vue 3 + Element Plus** 搭建功能完善的运营后台。\n\n> **本项目作为完整的生产级参考实现开放源码**，包含详细的 PRD 文档（16 份）、架构设计文档（17 份）和分阶段实施计划，适合用于学习、参考或作为二次开发的起点。\n\n---\n\n## 技术栈\n\n| 层次 | 技术选型 |\n|---|---|\n| **后端** | Go 1.22 · Gin · GORM · PostgreSQL 15 · Redis 7 · asynq |\n| **C 端跨端** | Taro 4 · React 18 · TypeScript · NutUI-React-Taro |\n| **运营后台** | Vue 3.4 · Element Plus 2.7 · Vite 5 · Pinia |\n| **基础设施** | Docker Compose · MinIO · Nginx · OpenTelemetry |\n| **三方对接** | 微信小程序登录 · 微信支付 V3 · 快递鸟电子面单 · 阿里云 OSS |\n\n---\n\n## 功能模块\n\n### C 端（小程序 \u002F H5）\n\n- **账号**：微信一键登录（小程序 code2session + 公众号 OAuth2）、手机号绑定\n- **商品**：分类浏览、SKU 多规格、商品收藏、浏览历史\n- **购物车**：实时库存校验、选中结算\n- **订单**：下单 → 超时自动关单（asynq）→ 支付 → 发货 → 确认收货 → 评价\n- **支付**：微信 JSAPI 支付（小程序）+ 微信 H5 支付\n- **物流**：快递鸟实时轨迹查询、订阅消息推送\n- **消息**：小程序订阅消息 + 公众号模板消息\n\n### 运营后台（Vue3）\n\n- **商品管理**：SPU \u002F SKU 编辑、分类管理、图片上传（OSS）、上下架\n- **库存管理**：调拨记录、低库存预警、Redis Lua 原子扣减防超卖\n- **订单管理**：批量发货、打印电子面单、手工操作退款\n- **用户管理**：用户列表、标签、企微渠道码\n- **数据看板**：GMV、订单量、用户增长（预聚合）\n- **系统设置**：店铺信息、管理员账号、角色权限（RBAC）\n\n---\n\n## 架构亮点\n\n- **防超卖**：Redis Lua 脚本原子扣减库存，支持 100 并发不超卖\n- **ID 防溢出**：所有 API ID 字段统一 `string` 类型，避免 JS BigInt 精度丢失\n- **幂等设计**：三方回调 + 客户端 `Idempotency-Key` 双重幂等保护\n- **状态机**：订单、支付、退款状态机单一入口，禁止散点 UPDATE\n- **安全加固**：JWT 黑名单、HttpOnly Cookie、富文本白名单过滤、SQL 参数化\n\n---\n\n## 快速开始\n\n### 环境要求\n\n- Go 1.22+\n- Node 20+ · pnpm 9+\n- Docker & Docker Compose\n- 微信开发者工具（调试小程序）\n\n### 启动本地依赖\n\n```bash\nmake deps-up        # 启动 PostgreSQL · Redis · MinIO · asynqmon\n```\n\n### 后端\n\n```bash\ncd server\ncp env.example .env   # 填写微信支付、OSS 等配置\nmake migrate-up       # 执行数据库迁移\nmake run-api          # http:\u002F\u002Flocalhost:8080\nmake run-worker       # asynq worker\n```\n\n### 运营后台\n\n```bash\ncd admin\npnpm install\npnpm dev              # http:\u002F\u002Flocalhost:5273\n```\n\n### C 端\n\n```bash\ncd client\npnpm install\npnpm dev:h5           # H5 预览 http:\u002F\u002Flocalhost:10086\npnpm dev:weapp        # 小程序，用微信开发者工具打开 client\u002Fdist\u002Fweapp\n```\n\n---\n\n---\n\n## 参与贡献\n\n欢迎提交 Issue 和 Pull Request！贡献前请先阅读架构文档，保持与现有设计一致。\n\n---\n\n## 许可证\n\n本项目基于 **GNU Affero General Public License v3.0 (AGPL-3.0)** 开源。\n\n- ✅ 允许：学习、研究、个人使用、修改代码\n- ✅ 允许：基于本项目二次开发，但**必须以相同协议开源所有修改**\n- ❌ 禁止：将本项目（或其修改版本）作为商业服务提供，除非同样开源\n- ❌ 禁止：在不开源的商业产品中使用本项目代码\n\n详见 [LICENSE](LICENSE) 文件。\n","xu-shop 是一个面向单商家私域电商的全栈开源项目，提供从用户下单到仓库发货的完整业务闭环。项目采用 Go 语言和 PostgreSQL 构建高性能后端，Taro 实现跨端（小程序\u002FH5）应用，Vue 3 + Element Plus 搭建功能完善的运营后台。它支持微信生态内的流量入口（小程序\u002F公众号 H5\u002F企微），并在 Web 后台完成运营和履约。xu-shop 适合用于学习、参考或作为二次开发的起点，特别适用于希望快速搭建私域电商平台的企业和个人。","2026-06-11 03:54:58","CREATED_QUERY"]