新增项目启动规划和AGENTS文档，详细描述现场互动SaaS平台的项目概述、团队配置、预算规划、产品功能及运营策略

2026-01-31 19:30:39 +08:00
commit 0d9d6e7a8f
3 changed files with 1178 additions and 0 deletions
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -0,0 +1,331 @@
+# 现场互动SaaS平台 - 项目上下文
+
+## 项目概述
+
+这是一个创业项目，旨在打造轻量化现场大屏幕互动SaaS平台，专注500元以下小型活动市场。项目对标Hi现场（https://www.hixianchang.com/），以极致性价比和稳定性抢占下沉市场。
+
+### 核心定位
+- **目标市场**：小型活动主办方（部门年会、小型沙龙、公司年会、经销商会等）
+- **差异化策略**：低价、轻量、专注小B客户
+- **核心优势**：技术自主（2名程序员）、轻量部署、抖音获客、快速响应
+
+### 团队配置（3人）
+- **程序员A**：后端开发+部署运维
+- **程序员B**：前端开发+大屏幕
+- **推广客服C**：抖音运营+客户对接
+
+### 预算规划
+- **启动资金**：3-5万元
+- **最大亏损底线**：不超过3万元
+- **验证期**：最多12个月
+
+---
+
+## 技术栈（已确定）
+
+### 后端
+- **语言**：Go 1.21+ LTS
+- **Web框架**：Gin（轻量高性能）
+- **ORM**：GORM
+- **数据库**：MySQL 8.0
+- **实时通信**：HTTP长轮询（暂不用WebSocket）
+- **配置管理**：Viper
+- **日志**：Zap
+- **JWT**：golang-jwt/jwt
+
+### 前端
+- **框架**：Vue 3
+- **构建工具**：Vite
+- **UI组件库**：
+  - 管理后台：Element Plus
+  - 移动端：Vant
+- **动画**：Canvas 2D（不用WebGL，保持轻量）
+
+### 部署
+- **云服务**：阿里云ECS（2核4G）
+- **Web服务器**：Nginx（反向代理 + 静态文件）
+- **数据库**：MySQL 8.0（本地部署）
+- **监控**：阿里云免费监控 + Server酱微信推送
+
+---
+
+## 项目结构（规划中）
+
+```
+live_cloud/
+├── backend/                    # 后端项目（Go + Gin）
+│   ├── cmd/
+│   │   └── server/
+│   │       └── main.go        # 程序入口
+│   ├── internal/
+│   │   ├── api/               # HTTP路由和控制器
+│   │   ├── model/             # 数据模型
+│   │   ├── service/           # 业务逻辑层
+│   │   ├── repository/        # 数据访问层
+│   │   ├── middleware/        # 中间件
+│   │   ├── pkg/               # 工具包
+│   │   └── config/            # 配置
+│   ├── config/
+│   │   ├── config.yaml        # 配置文件
+│   │   └── config.prod.yaml   # 生产环境配置
+│   ├── scripts/
+│   │   ├── build.sh           # 构建脚本
+│   │   └── deploy.sh          # 部署脚本
+│   ├── go.mod
+│   └── go.sum
+├── frontend/                   # 前端项目（Vue 3）
+│   ├── admin/                 # 管理后台
+│   ├── screen/                # 大屏幕
+│   └── mobile/                # 移动端H5
+├── 规划/                       # 项目规划文档
+│   └── 项目启动规划.md
+└── AGENTS.md                   # 本文件
+```
+
+---
+
+## MVP功能规划（V1.0）
+
+### 核心功能（4个）
+1. **扫码签到**
+   - 用户扫码填写：姓名 + 手机号
+   - 大屏幕实时显示：头像 + 姓名
+   - 管理后台：查看签到列表 + 导出Excel
+
+2. **弹幕互动**
+   - 用户扫码发送弹幕
+   - 大屏幕实时显示弹幕池（最近50条）
+   - 后台敏感词过滤
+
+3. **头像滚动抽奖**
+   - 支持设置：奖品名称、数量、单次抽取人数
+   - 大屏幕动画：Canvas 2D滚动
+   - 中奖结果：弹窗显示 + 自动保存 + 防重复中奖
+
+4. **数钱游戏**
+   - 比拼手速的游戏玩法
+   - 大屏幕实时显示排名
+   - 游戏结束后导出成绩
+
+### 管理后台功能
+- 活动管理：创建、编辑、删除
+- 数据查看：签到人数、中奖记录、弹幕列表
+- 导出功能：签到名单、中奖名单
+
+### 砍掉的功能（暂不开发）
+- ❌ 3D签到墙（兼容性问题多）
+- ❌ 红包功能（涉及支付，合规复杂）
+- ❌ 复杂游戏功能（开发周期长）
+- ❌ 投票功能（需求频次低）
+- ❌ 多主题切换（维护成本高）
+
+---
+
+## 数据库设计（规划中）
+
+### 核心表
+- **users**：用户表
+- **activities**：活动表
+- **checkins**：签到表
+- **danmakus**：弹幕表
+- **lotteries**：抽奖表
+- **lottery_winners**：中奖记录表
+- **money_games**：数钱游戏表
+- **money_game_records**：游戏记录表
+- **orders**：订单表
+
+### 技术要点
+- 单库单表，无分库分表（简化架构）
+- 合理设计索引（activity_id, user_id）
+- 使用GORM ORM框架
+- 支持软删除（deleted_at字段）
+
+---
+
+## 产品定价
+
+| 套餐 | 价格 | 人数限制 | 核心功能 |
+|-----|------|---------|---------|
+| **体验版** | 0元 | ≤30人 | 签到+1轮抽奖（带水印） |
+| **单次版** | 199元 | ≤100人 | 签到+3轮抽奖+弹幕 |
+| **月度版** | 399元 | ≤300人 | 全功能+导出数据，不限场次，30天 |
+| **年度版** | 1999元 | ≤500人 | 全功能，不限场次，365天 |
+
+---
+
+## 运营策略
+
+### 获客渠道
+- **主要渠道**：抖音运营（客服C执行）
+- **内容策略**：
+  - 客户案例展示（60%）
+  - 功能演示（30%）
+  - 优惠活动（10%）
+- **关键词布局**：年会抽奖软件、现场互动、大屏幕抽奖、地域词（北京年会、上海活动等）
+
+### 客户服务
+- **响应时间**：3分钟内
+- **服务时间**：7×24小时
+- **交付流程**：付款后30分钟内创建活动，活动前1天发送操作手册，活动前1小时客服在线值班
+
+---
+
+## 稳定性保障方案
+
+### 三道防线
+1. **架构简化**：单体应用、HTTP轮询、单库单表、无Redis、Canvas 2D
+2. **冗余备份**：离线版HTML文件、手机热点+本地服务器、PPT抽奖动画
+3. **监控告警**：CPU > 80%告警、响应时间 > 2秒告警、错误日志推送、心跳检测
+
+### 活动前检查
+- 24小时前：服务器余额、数据库备份、功能测试、离线文件生成
+- 1小时前：操作手册确认、大屏幕设备测试、数据清空、客服在线
+
+### 应急预案
+- 服务器宕机：启动离线版，重启服务器，退款50%
+- 抽奖卡顿：关闭动画，降低帧率，赠送免费活动
+- 数据误删：从备份恢复，电话指导
+
+---
+
+## 开发计划（8周）
+
+### 第1周：准备工作
+- 确定技术栈（已确定Go）
+- 注册阿里云账号
+- 注册域名
+- 创建GitHub私有仓库
+
+### 第2-3周：后端开发
+- 搭建Go项目骨架
+- 设计数据库表
+- 实现用户注册登录（JWT）
+- 实现活动CRUD接口
+- 实现签到、弹幕、抽奖、数钱游戏接口
+
+### 第4-5周：前端开发
+- 搭建Vue 3管理后台
+- 实现活动管理页面
+- 实现大屏幕Canvas动画
+- 实现移动端H5扫码页
+
+### 第6周：联调与测试
+- 前后端接口联调
+- 压力测试（100人并发）
+- 兼容性测试
+- 灾难恢复测试
+
+### 第7周：内测与优化
+- 三人内部测试
+- 3-5个朋友公司免费试用
+- 收集反馈，修复Bug
+- 完善操作手册
+
+### 第8周：上线准备
+- 部署到阿里云
+- 配置监控告警
+- 设置数据库自动备份
+- 准备抖音内容
+
+---
+
+## 成功关键要素
+
+### 产品层面
+- **稳定性 > 功能丰富度**：宁可功能少，不能出故障
+- **简单易用**：3步完成活动创建
+- **快速响应**：客服5分钟内回复
+
+### 运营层面
+- **抖音获客**：持续输出内容，建立信任
+- **口碑传播**：每个客户都变成推荐者
+- **数据驱动**：每周复盘，优化转化率
+
+### 团队层面
+- **明确分工**：各司其职，不越界
+- **充分沟通**：每日同步进展
+- **共担风险**：收益共享，亏损共担
+
+---
+
+## 风险控制
+
+### 退出条件（满足任一）
+- 连续3个月收入 < 1000元
+- 出现2次以上重大故障
+- 核心成员退出且无法补充
+
+### 止损底线
+- **最大亏损**：不超过3万元
+- **时间投入**：最多12个月
+- **机会成本**：如全职工作收入更高，可转为兼职
+
+---
+
+## 关键里程碑
+
+### 第一个月
+- V1.0 MVP上线
+- 3-5个种子用户免费试用
+- 系统可用性 > 95%
+
+### 第三个月
+- 首单付费订单（199元）
+- 累计服务10场活动
+- 0重大投诉
+
+### 第六个月
+- 月收入 > 3000元
+- 累计服务50场活动
+- 考虑扩充兼职设计
+
+### 第十二个月
+- 月收入 > 10,000元
+- 累计服务200场活动
+- 决策是否全职投入/融资扩张
+
+---
+
+## 重要说明
+
+1. **成本控制**：月度服务器成本 ≤ 500元，单活动成本 ≤ 5元
+2. **协作模式**：重大决策三人投票，简单多数通过；每周一次线上会议复盘
+3. **退出机制**：任意成员可随时退出，需提前1个月告知
+4. **技术原则**：极简架构，降低故障率；HTTP轮询替代WebSocket；Canvas 2D替代WebGL
+
+---
+
+## 参考资源
+
+- **对标产品**：https://www.hixianchang.com/
+- **Vue 3文档**：https://cn.vuejs.org/
+- **Gin文档**：https://gin-gonic.com/docs/
+- **GORM文档**：https://gorm.io/docs/
+- **Canvas动画**：https://developer.mozilla.org/zh-CN/docs/Web/API/Canvas_API
+
+---
+
+## 模块开发流程
+1. **需求澄清阶段**
+   - 列出所有关键问题，尽量考虑周全。同时你可以提供一些你的建议和思路
+   - 等待用户逐一回答或确认，一些不合理或有漏洞的设计你可以提出质疑和一些优化建议
+   - 在讨论过程中的一些细节设计需要记录文档到doc/thinking文件夹，后续完成模块设计讨论之后将内容同步到正式的设计文档中（文档使用utf-8进行编码，避免乱码）
+
+2. **方案与计划阶段**
+   - 技术选型对比（如有必要）
+   - 模块边界划分
+   - 文件清单与职责
+   - 核心数据结构/接口定义
+   - 任务拆分（建议拆到能2-30行代码完成的粒度）
+   - 同时需要输出到对应的模块设计文档中
+
+3. **计划确认**
+   - 明确询问："以上计划是否确认可以开始编码？如有修改请指出。"
+   - 只有得到明确"是"、"确认"、"可以开始"、"go"、 "ok"等词才可进入编码
+
+4. **编码阶段**
+   - 严格按照设计文档中的要求执行
+   - 编码过程中有必要在一些关键地方增加一些日志说明
+   - 完成编码任务之后需要同步更新相关设计文档。如有必要需要更新相关的使用文档和注意事项。
+
+**最后更新**：2026年1月31日