学员档案 → 排课 → 销课扣课时 → 课堂记录与影像 → IEP → 家长查看。微信小程序(员工端 + 家长端)+ PC 管理后台三端原型,配套需求规格、领域模型、权限矩阵、接口契约与研发计划。技术选型:微信原生小程序 + Go 单体服务 + PostgreSQL + Redis + MinIO。
现场作业工具:看今日课表 → 上课 → 销课 → 写课堂记录 → 上传影像。只处理自己名下学员,跨学员访问返回 403 并告警。从 微信授权登录 进入。
定位「看得见、看得懂、不打扰」:只看自己孩子的课表、课时、影像与 IEP,不做任何档案写操作。家长必须主动授权订阅才能收到微信服务通知,未授权时消息仍保留在消息中心。
官网品牌色为 #a0c511(黄绿 / chartreuse),全站唯一品牌色。该色亮度极高——白底上白字对比度仅 2.00:1,无法承载白字。 因此采用亮底深字策略:主按钮用亮黄绿渐变 #b1d333 → #a0c511 做底、深绿 #22380a 做字,对比度 4.98:1 ✅; 需要白字的场景(hero 横幅、状态栏)才退到 #44770e(白字 5.88:1 ✅)。这样整屏以明亮黄绿为主,而不是被深色压暗。
#2f7d5f、警示 #8f5a06、危险 #b3261e、信息 #2563a8。
中性色带极淡绿灰调(正文 #1a2016、辅助文字 #6b7263),使整套界面与品牌色协调而不显脏。
需求与研发的正式依据,可直接用于需求评审、开发对接与合同附件。
| 文档 | 主要内容 | 用途 |
|---|---|---|
| 01 概念设计 | 系统定位与边界、三端职责、技术架构与 6 条关键架构决策(ADR)、领域模型、4 个关键流程时序、非功能设计(合规 / 成本 / 性能 / 降级) | 架构对齐 |
| 02 需求规格说明书 | 一期范围、13 个模块的 FR 功能项与 BR 业务规则(含销课撤销、课时账本、IEP 版本、审计合规)、非功能硬性要求、验收口径(AC-01~AC-15) | 需求冻结 |
| 03 领域模型与数据库设计 | 枚举字典、全部表结构 DDL、索引与分区策略、IEP 保护触发器、课时对账 SQL、审计表权限收敛、数据保留策略 | 开发输入 |
| 04 权限矩阵 | 5 角色数据范围、60 权限点清单、矩阵总表、字段级权限(敏感字段)、前端可见性、越权拦截与告警阈值、14 条越权测试用例 | 安全验收 |
| 05 接口契约 | 统一响应与 40+ 错误码、幂等与限流规范、108 个接口清单、29 个核心接口完整定义(含销课 / 撤销 / IEP 发布 / 预签名 URL)、异步任务、微信对接 | 联调依据 |
| 06 研发计划 | 阶段 0~6 排期与甘特图、WBS 任务分解、资源与 292 人天汇总、14 条风险登记册、修正后的成本测算、35 条测试用例、上线检查清单、变更单模板 | 项目管理 |
| 07 媒体容量与保留策略 | 实测参数(ffmpeg/Pillow)、四档拍摄强度容量模型、分级保留策略(精选永久 / 常规图片 24 个月 / 常规视频 90 天)、MinIO 分层前提、14 项容量控制措施、对象键结构与成本修正 | 成本关键 |
| 08 ADR·媒体存储与出网路径 | 「企业内网自建主机存媒体」方案的成本论证:出网单价对比(CDN ¥0.175 vs 云主机出口 ¥0.80)、实际带宽需求推算、盈亏平衡分析、本地主机的正确定位(归档灾备)、7 条复核清单 | 架构决策 |
诊断信息、手机号列级加密(AES-256-GCM);家长端永不返回诊断原文;图片上传剥离 EXIF 定位信息;越权访问 403 并告警。
覆盖敏感字段读取、文件下载、导出、销课与撤销、档案与 IEP 修改、权限变更、登录失败、越权尝试;只增不改删,保留 ≥ 1 年。
流水只增不改;撤销生成反向流水;余额 = 流水汇总,每日对账任务校验,不一致立即冻结账户并告警。
新增版本时旧版永久归档只读;数据库触发器禁止对已生效 / 已归档版本执行 UPDATE 或 DELETE。
实测年增量 281~2,650 GB(视拍摄频次,原估算偏低 3~6 倍)。分级保留可省 40% 存储费:常规视频 90 天删、常规图片 24 个月归档、精选永久。云资源年费约 ¥1.5~1.8 万,需与开发费分列。
家长须主动授权订阅;未授权时消息仍保留在消息中心;频次上限每人每日 5 条、静默时段 21:00–08:00;失败降级站内消息。