⚡ 本项目是一个完整的 Vibe Coding 示例项目
使用 Claude Code (claude-sonnet-4.5 模型) 从零到一完整生成,展示了 AI 辅助开发的完整流程和最佳实践。
这个项目旨在展示:
-
📚 AI 辅助全栈开发的完整流程
- 从需求分析到系统设计
- 从后端 API 到前端界面
- 从数据库设计到部署方案
-
🚀 Claude Code 的实际应用能力
- 复杂业务逻辑实现(积分系统、充值营销)
- 高并发场景处理(库存控制、分布式锁)
- 完整的前后端集成
-
💡 Vibe Coding 开发模式
- 快速迭代、敏捷开发
- AI 与开发者协作
- 高质量代码生成
| 指标 | 数据 |
|---|---|
| 开发模型 | Claude Sonnet 4.5 |
| 开发工具 | Claude Code CLI |
| 总开发时间 | ~8 小时(传统开发需 3-4 周) |
| 代码行数 | 后端 ~15,000 行 / 前端 ~8,000 行 |
| API 端点 | 35 个 RESTful 接口 |
| 前端页面 | 8 个功能模块 |
| 数据库表 | 20+ 张表,完整的关系设计 |
| 测试覆盖 | 包含完整的 API 测试脚本 |
| 文档产出 | 15+ 份技术文档 |
- ✅ 100% 后端代码:Go + Gin 框架,DDD 架构
- ✅ 100% 前端代码:Vue 3 + Element Plus,完整管理后台
- ✅ 100% 数据库设计:MySQL 表结构、索引、迁移脚本
- ✅ 100% 项目文档:API 文档、部署文档、测试文档
- ✅ 配置文件:Docker、Nginx、CI/CD 配置
- ✅ 测试脚本:自动化测试、集成测试
通过 AI 辅助开发,本项目实现了:
- 高并发场景:积分兑换无超卖(验证 10000+ 并发)
- 数据一致性:充值事务 100% 原子性保证
- 分布式架构:Redis 缓存、RabbitMQ 消息队列
- 安全性:JWT 认证、RBAC 权限、操作审计
- 性能优化:乐观锁、分布式锁、缓存策略
详细开发笔记: 查看 AI_DEVELOPMENT_NOTES.md
MemberHub(会员通)是一个专为连锁门店设计的统一会员管理系统,支持跨店积分共享、充值营销、优惠券推送等核心功能。
- 🏪 统一会员体系:用户在所有门店共享积分和余额
- 🎯 分店自主管理:每个分店可独立设置兑换规则和活动
- 💰 营销闭环:充值送、优惠券、特价商品等完整营销工具
- 📱 微信小程序:完整的会员端小程序支持
- 🎨 管理后台:现代化、响应式的 Web 管理界面
- 微信小程序一键登录
- 会员等级体系(普通/白银/黄金/VIP)
- 会员资产概览(积分/余额/优惠券)
- 手动调整积分/余额(带备注和审计)
- 消费自动积分(可配置积分比例)
- 跨店积分统一管理
- 分店独立设置兑换规则
- 积分兑换商品/服务
- 兑换码核销系统
- 每日限兑控制
- 高并发库存控制(Redis + 乐观锁)
- 充值送活动配置(如:充 200 送 50)
- 微信支付集成
- 充值订单管理
- 赠送积分支持
- 余额消费记录
- 三种券类型:满减券、折扣券、代金券
- 批量推送(全部会员/指定等级/指定用户)
- 站内领取
- 微信模板消息通知
- 优惠券使用记录
- 异步任务处理(RabbitMQ)
- 门店 CRUD 操作
- 门店位置配置(经纬度)
- 附近门店查询(Haversine 公式)
- 营业时间设置
- 特价商品管理
- 按门店配置促销
- 促销时间范围控制
- 库存管理
- 现代化响应式界面
- 侧边栏折叠/展开
- 全屏显示模式
- 数据统计看板
- 权限控制(RBAC)
- 操作日志审计
| 技术 | 版本 | 说明 |
|---|---|---|
| Go | 1.21+ | 编程语言 |
| Gin | 1.9+ | Web 框架 |
| GORM | 1.25+ | ORM 框架 |
| MySQL | 8.0+ | 主数据库 |
| Redis | 7.0+ | 缓存 + 分布式锁 |
| RabbitMQ | 3.12+ | 消息队列 |
| JWT | - | 认证方案 |
| Viper | - | 配置管理 |
| Zap | - | 结构化日志 |
| 技术 | 版本 | 说明 |
|---|---|---|
| Vue | 3.4+ | 前端框架 |
| Element Plus | 2.6+ | UI 组件库 |
| Pinia | 2.1+ | 状态管理 |
| Vue Router | 4.3+ | 路由管理 |
| Axios | 1.6+ | HTTP 客户端 |
| Vite | 5.4+ | 构建工具 |
- DDD 领域驱动设计:清晰的分层架构
- RESTful API:标准化接口设计
- 微服务友好:易于拆分为微服务
- 高并发优化:Redis 缓存、分布式锁、乐观锁
- 事件驱动:RabbitMQ 异步处理
- 容器化部署:Docker + Docker Compose
- Go 1.21+
- Node.js 16+
- MySQL 8.0+
- Redis 7.0+
- RabbitMQ 3.12+
# 1. 克隆项目
git clone https://github.com/YazaiHu/MemberHub.git
cd memberhub
# 2. 测试后端API(自动检测是否运行)
./test_system.sh
# 3. 测试前端API对接
./test_frontend_api.sh
# 4. 启动前端服务
cd web/admin
npm install
npm run dev访问:
- 前端地址: http://localhost:3000
- 后端地址: http://localhost:8080
- 默认账号: admin / admin123
# 启动所有服务
docker-compose up -d
# 查看日志
docker-compose logs -f
# 停止服务
docker-compose down# 安装依赖
go mod download
# 配置数据库
cp configs/config.dev.yaml configs/config.yaml
# 编辑 config.yaml,配置数据库连接
# 创建数据库并执行迁移
mysql -h127.0.0.1 -uroot -proot -e "CREATE DATABASE membership_dev CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
mysql -h127.0.0.1 -uroot -proot membership_dev < migrations/001_create_users_and_admins.up.sql
mysql -h127.0.0.1 -uroot -proot membership_dev < migrations/002_create_stores.up.sql
mysql -h127.0.0.1 -uroot -proot membership_dev < migrations/003_create_points.up.sql
mysql -h127.0.0.1 -uroot -proot membership_dev < migrations/004_create_recharge.up.sql
mysql -h127.0.0.1 -uroot -proot membership_dev < migrations/005_create_coupons.up.sql
mysql -h127.0.0.1 -uroot -proot membership_dev < migrations/006_create_promotions_and_logs.up.sql
# 启动后端服务
make run
# 或:CONFIG_PATH=configs/config.dev.yaml go run cmd/api/main.gocd web/admin
npm install
npm run devmemberhub/
├── cmd/ # 应用入口
│ ├── api/main.go # API 服务
│ └── worker/main.go # 后台 Worker
├── internal/ # 内部代码
│ ├── domain/ # 领域层(核心业务逻辑)
│ │ ├── member/ # 会员领域
│ │ ├── points/ # 积分领域
│ │ ├── recharge/ # 充值领域
│ │ ├── coupon/ # 优惠券领域
│ │ └── store/ # 门店领域
│ ├── application/ # 应用层(用例编排)
│ ├── infrastructure/ # 基础设施层
│ │ ├── persistence/ # 数据持久化(MySQL/Redis)
│ │ ├── messaging/ # 消息队列(RabbitMQ)
│ │ └── wechat/ # 微信集成
│ └── interfaces/ # 接口层
│ ├── http/ # HTTP 接口
│ └── worker/ # Worker 任务
├── web/ # 前端代码
│ └── admin/ # 管理后台
│ ├── src/
│ │ ├── api/ # API 封装
│ │ ├── views/ # 页面组件
│ │ ├── components/ # 公共组件
│ │ ├── stores/ # Pinia 状态
│ │ ├── layouts/ # 布局组件
│ │ └── router/ # 路由配置
│ └── public/
├── migrations/ # 数据库迁移文件
├── configs/ # 配置文件
├── scripts/ # 脚本工具
├── docs/ # 文档
│ ├── FULL_SYSTEM_REPORT.md # 完整系统报告
│ ├── API_TESTING_GUIDE.md # API 测试指南
│ ├── LAYOUT_OPTIMIZATION.md # 布局优化文档
│ └── AI_DEVELOPMENT_NOTES.md # AI 开发笔记(即将发布)
├── test_system.sh # 系统测试脚本
├── test_frontend_api.sh # 前端API测试脚本
└── README.md # 本文件
访问 http://localhost:3000,使用默认账号登录:
- 用户名:
admin - 密码:
admin123
2. 功能模块
Scan report · 2026-09-11
- ✓ Prohibited terms or links
- ✓ Repository eligibility
- ✓ slopscore.md paperwork
- ✓ Content policy
- ✓ Risk review







0 comments
log in to comment.