331 lines
10 KiB
Markdown
331 lines
10 KiB
Markdown
# 现场互动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日 |