wangdongpo/live_cloud
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
live_cloud/AGENTS.md

10 KiB
Raw Permalink Blame History

现场互动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

参考资源

模块开发流程

  1. 需求澄清阶段

    • 列出所有关键问题，尽量考虑周全。同时你可以提供一些你的建议和思路
    • 等待用户逐一回答或确认，一些不合理或有漏洞的设计你可以提出质疑和一些优化建议
    • 在讨论过程中的一些细节设计需要记录文档到doc/thinking文件夹，后续完成模块设计讨论之后将内容同步到正式的设计文档中（文档使用utf-8进行编码，避免乱码）

  2. 方案与计划阶段

    • 技术选型对比（如有必要）
    • 模块边界划分
    • 文件清单与职责
    • 核心数据结构/接口定义
    • 任务拆分（建议拆到能2-30行代码完成的粒度）
    • 同时需要输出到对应的模块设计文档中

  3. 计划确认

    • 明确询问："以上计划是否确认可以开始编码？如有修改请指出。"
    • 只有得到明确"是"、"确认"、"可以开始"、"go"、 "ok"等词才可进入编码

  4. 编码阶段

    • 严格按照设计文档中的要求执行
    • 编码过程中有必要在一些关键地方增加一些日志说明
    • 完成编码任务之后需要同步更新相关设计文档。如有必要需要更新相关的使用文档和注意事项。

最后更新：2026年1月31日

Reference in New Issue View Git Blame Copy Permalink