niuniu/gaokao-volunteer-system
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
261 Commits 3 Branches 1 Tag
61ba0ca9878d9060427f70c8b9cdf4d2fbf3d3f8
Commit Graph

14 Commits

Author SHA1 Message Date
Hermes
2893a45d8b feat(6/19): 保留期门禁 + 支付失败持久化 + 文档校准
Some checks failed
CI / pytest (Python 3.10) (push) Has been cancelled
Details
CI / pytest (Python 3.11) (push) Has been cancelled
Details
CI / pytest (Python 3.12) (push) Has been cancelled
Details 
A1 删除/匿名化 180 天保留期门禁 (P0):
- admin/errors/codes.py + BIZ_ORDER_RETENTION_NOT_EXPIRED (E02002) -> HTTP 409
- admin/config.py + retention_days / GAOKAO_RETENTION_DAYS (默认 180)
- admin/routes/orders.py + _assert_retention_expired 守卫
- data/orders/deletion_service.py + RETENTION_GUARDED_STATUSES
- admin/tests/test_order_deletion.py + _expire_retention_window + 3 测试

B1 支付失败 webhook 持久化 (P1):
- data/payments/dao.py + failed_at/failure_reason/provider_trade_no/callback_payload
- data/payments/models.py + PaymentRecord 新字段
- data/payments/service.py handle_webhook 失败分支持久化
- data/payments/tests/test_webhook.py test_handle_webhook_persists_failed_status

A2 文档校准 (P1):
- README / PRD / ROADMAP / TECH_ARCHITECTURE 顶部对齐 6/19

B2 真相源分层 (P1):
- 6/13 整改板/执行板加历史快照前缀
- 新建 6/19 整改板/执行板
- CURRENT_STATE 顶部加 6/19 增量段 (在 6/13 真相源之上叠加)

dev-verify: 1175 passed (A1+B1+A2+B2) -> 1179 passed (+ T12-C),
coverage overall=85.05% / core=100%
 2026-06-20 00:27:15 +08:00
Hermes Agent
af7ae3c6ce docs: align product positioning with current system truth 2026-06-18 14:14:20 +08:00
Hermes Agent
246f21c7f2 feat(review): land unified remediation and rules evidence closure
Some checks failed
CI / pytest (Python 3.10) (push) Has been cancelled
Details
CI / pytest (Python 3.11) (push) Has been cancelled
Details
CI / pytest (Python 3.12) (push) Has been cancelled
Details
2026-06-18 10:21:38 +08:00
Hermes Agent
93fa527f64 docs(review): reconcile completed-stage issues from 2026-06-13 alignment review
Some checks failed
CI / pytest (Python 3.10) (push) Has been cancelled
Details
CI / pytest (Python 3.11) (push) Has been cancelled
Details
CI / pytest (Python 3.12) (push) Has been cancelled
Details
2026-06-14 10:12:03 +08:00
Hermes Agent
cb9728fb4e feat: complete web self-service mvp flow
Some checks failed
CI / pytest (Python 3.10) (push) Has been cancelled
Details
CI / pytest (Python 3.11) (push) Has been cancelled
Details
CI / pytest (Python 3.12) (push) Has been cancelled
Details
2026-06-14 05:26:27 +08:00
Hermes Agent
3f46811e49 release: cut v2.1
Some checks failed
CI / pytest (Python 3.10) (push) Has been cancelled
Details
CI / pytest (Python 3.11) (push) Has been cancelled
Details
CI / pytest (Python 3.12) (push) Has been cancelled
Details
2026-06-13 14:49:58 +08:00
Hermes Agent
a146fe942c feat(audit): 完整审核+修订版实施计划 
【审核工作】
基于 plan-audit skill 对 11 份文档（5874行）做完整审核：
- 文档完整性: A级 ✅
- 业务对齐: A级 ✅
- 差异化策略: A级 ✅
- 技术选型: A级 ✅
- 任务分解: A级 ✅
- 行业实践: C级 🔴 (5/10)
- 实施可执行: B级 🟡 (62.5%)

【发现14项差距】
4项重大缺失:
  G-01: Web端完全未在实施计划
  G-02: 管理后台(432行设计)无对应实施
  G-03: 分享功能(274行设计)无对应实施
  G-04: AI审核PRD标P1但实际应P0

4项中等缺失:
  G-05: 测试覆盖仅6用例(需≥80%)
  G-06: 渠道SDK集成未设计
  G-07: 错误处理体系缺失
  G-08: CI/CD流程未设计

3项设计偏差:
  D-01: data/crowd_db目录不存在
  D-02: 性能目标无验证任务
  D-03: 数据加密未实施

3项建议优化

【关键产出】
1. docs/AUDIT_REPORT_2026-06-11.md (382行)
   - 完整审核报告
   - 行业最佳实践对照
   - 风险评估
   - 行动建议

2. docs/REMEDIATION_TASK_BOARD_2026-06-11.md (386行)
   - 14项修复任务清单
   - 最短闭环路径
   - 决策记录

3. docs/IMPLEMENTATION_PLAN_v2.md (412行)
   - 11个核心任务（原5个+新增6个）
   - 工期30天→40天
   - 强制TDD覆盖率门槛
   - 6周详细时间表

【已修复P0】
- PRD: F020 AI审核 P1→P0
- 创建 data/crowd_db/ 目录（D-01修复）
- 修订IP为v2版（10.1→11任务）
- 加入测试覆盖率门槛

【决策记录】
D-01: AI审核提升至P0
D-02: 管理后台/分享纳入MVP
D-03: Web端推迟到v2.3
D-04: 测试覆盖设硬指标
D-05: CI/CD简化版

【行业实践差距】
标准达标: 5/10 (50%)
- 测试覆盖: 🔴
- 错误处理: 🔴
- CI/CD: 🔴
- 降级策略: 🔴
- API版本: 🔴
- 日志审计: 🟡
- 性能监控: 🟡
- 数据备份: 🟡
- 安全认证: 🟡
- 文档: 🟡

【下一步】
启动T1 AI审核服务实施(10天)
 2026-06-12 10:05:13 +08:00
Hermes Agent
8f64e0f0c3 feat: 根据竞品分析深度优化产品规划设计 
核心优化：差异化功能设计 + 定价策略 + 推广话术

1. docs/BUSINESS_SCENE.md（新增197行）
   - 反扎堆推荐功能设计
   - AI方案审核功能（49元版）⭐核心差异化
   - 数据溯源展示设计
   - 服务流程和审核报告模板

2. docs/COMPETITIVE_ANALYSIS.md（新增111行）
   - 小红书标题模板（5个）
   - 小红书内容结构（完整模板）
   - 知乎回答模板
   - 闲鱼商品标题和描述模板
   - 微信朋友圈话术模板

3. product/PRD.md（优化77行）
   - 新增功能：
     * F018 反扎堆推荐（P0）
     * F019 数据溯源（P1）
     * F020 AI方案审核（P1）⭐核心
   - 服务版本重新设计：
     * AI审核版 49元（承接大厂用户）⭐新增
     * 基础版 99元
     * 标准版 199元（主推）
     * 尊享版 299元
   - 新增版本对比表（vs大厂免费）
   - 新增核心话术（AI审核版/标准版/尊享版）

4. product/ROADMAP.md（新增83行）
   - 差异化功能开发计划（6-7月）
   - AI方案审核服务详细计划（6月15-20日）
   - 反扎堆推荐功能开发（6月15-25日）
   - 数据溯源功能开发（6月20-30日）
   - 产品优化计划（7-8月）

关键决策：
- 49元AI方案审核：承接大厂用户的核心产品
- 升级转化：49元→99元补差价模式
- 反扎堆：主动提示AI推荐扎堆风险
- 数据溯源：每所院校数据来源透明

推广策略：
- 小红书：大厂AI避坑内容
- 知乎：真实体验对比回答
- 闲鱼：AI方案审核商品
- 朋友圈：政策/扎堆/数据三大痛点
 2026-06-12 09:06:52 +08:00
Hermes Agent
1f8c51aa64 feat: 竞品分析(大厂AI入场)与差异化策略 
基于2026年6月10日大厂集体入场事件（千问/元宝/百度/豆包），
深入分析竞品，明确产品差异化与推广差异化：

1. docs/COMPETITIVE_ANALYSIS.md（新文档，530行）
   - 4大竞品详细分析（千问/元宝/百度/豆包）
   - 9维度功能对比矩阵
   - 市场洞察（同质化/扎堆风险/用户痛点）
   - 6大产品差异化策略
   - 6大推广差异化策略
   - SWOT分析（更新版）
   - 行动建议（短/中/长期）
   - 风险应对与关键决策

2. product/PRD.md（新增8.5节竞品分析）
   - 大厂服务对比表
   - 差异化定位
   - 6大产品差异化
   - 6大推广差异化

3. product/ROADMAP.md（新增大厂应对策略）
   - 6月10-25日应对窗口
   - 渠道/内容/服务差异化行动

4. product/MARKET_RESEARCH.md（新增5.5节）
   - 大厂AI入场影响分析
   - 正面/负面影响
   - 5点应对策略

5. docs/NAVIGATION.md（更新文档导航）

核心洞察：
- 大厂免费入场 = 普及市场，但创造差异化空间
- 反AI推荐 = 我们最大的差异化
- 真人服务+政策合规+反扎堆 = 市场空白
- 闲鱼/微信/学校 = 大厂做不了的渠道

决策：
- 不正面竞争大厂通用市场
- 专注专业版细分市场
- 99-299元 vs 大厂免费
- 6月窗口期全力推广反扎堆理念
 2026-06-12 07:35:12 +08:00
Hermes Agent
979f3d765d feat: 明确区分闲鱼/微信与Web系统两种业务流程 
根据用户明确要求，完善业务流程设计：

核心区别：
- 闲鱼/微信流程：用户先在渠道内付款 → 提供资料 → 管理端录入资料 → 生成方案
- Web系统流程：用户进系统 → 付款 → 填资料 → 自动/人工生成方案

更新 docs/BUSINESS_SCENE.md：
1. 顶部新增关键业务流程区分表，明确本质区别
2. 场景A（闲鱼/微信/学校）流程重新设计：
   - 步骤1: 用户下单/加微信
   - 步骤2: 用户提供资料
   - 步骤3: 管理端录入订单（手动）
   - 步骤4: 龙老师服务
   - 步骤5: 方案交付
   - 步骤6: 管理端完成订单
3. 场景B（Web系统）流程重新设计：
   - 步骤1-2: 访问、选择版本
   - 步骤3: 支付（先付费）
   - 步骤4: 填写资料（付费后才显示）
   - 步骤5: 生成方案
   - 步骤6-7: 交付、完成
4. 管理后台订单录入界面详细设计
5. 新增两种模式对比表
6. 新增异常处理（信息不完整、退款）

更新 product/PRD.md：
- 9.1 重写为两种核心业务流程对比表
- 9.2 推广渠道矩阵按业务流程分类
- 9.3 订单管理区分两种订单来源
- 9.4 服务版本保留

关键决策：
- 闲鱼/微信：先给资料→管理端录入→生成方案（人工服务）
- Web系统：先付费→填资料→生成方案（自助服务）
- 订单统一管理（手动+自动）
 2026-06-11 22:45:05 +08:00
Hermes Agent
df1a073650 feat: 新增多渠道业务场景设计 
基于用户推广需求，设计完整的商业化场景：

1. docs/BUSINESS_SCENE.md - 业务场景与推广设计（新）
   - 推广渠道矩阵（闲鱼/小红书/知乎/学校）
   - 三种交易场景设计：
     * 闲鱼交易：平台内下单→获取信息→咨询服务→发方案
     * 微信私域：加微信→收款码收款→咨询→发方案
     * Web系统：自助访问→支付→系统生成报告
   - 多渠道订单管理（闲鱼/微信/Web统一录入）
   - 服务版本：基础版99元/标准版199元/尊享版299元
   - 运营SOP：闲鱼话术、朋友圈内容、客户跟进
   - 实施路线图：Phase1启动期（2026.6-7）

2. product/PRD.md - 新增业务场景章节
   - 9.1 推广渠道矩阵
   - 9.2 交易场景支持（3种场景）
   - 9.3 订单管理（多渠道统一）
   - 9.4 服务版本与价格

3. product/ROADMAP.md - 新增商业化启动
   - 闲鱼渠道建设
   - 微信私域配置
   - 小红书/知乎内容运营
   - 学校地推对接
   - 交付物：闲鱼10+单、微信50+人

4. docs/NAVIGATION.md - 更新文档列表
   - 新增BUSINESS_SCENE.md链接
 2026-06-11 22:36:53 +08:00
Hermes Agent
ecaccf37d5 feat: 新增分享功能和后台管理设计 
新增功能设计文档：

1. docs/SHARING_DESIGN.md - 用户分享功能设计
   - 分享方式：链接/图片/PDF
   - 权限控制：只读/评论/编辑三级权限
   - 隐私保护：数据脱敏分级
   - 撤销分享与访问统计
   - 短链接系统技术方案

2. docs/ADMIN_DESIGN.md - 管理后台设计
   - 仪表盘：核心指标与实时告警
   - 用户管理：查看/筛选/导出
   - 案例管理：CRUD与审核
   - 规则管理：省份规则配置
   - 数据监控：用户行为与地域分布
   - 系统日志：操作审计
   - RBAC权限：5级角色权限矩阵

3. 更新PRD：新增F016分享、F017管理后台功能
4. 更新Roadmap：v2.3阶段集成分享与后台功能

目标时间：2027年Q2 (v2.3阶段)
 2026-06-11 22:14:27 +08:00
Hermes Agent
083b65f780 ux: 调整产品规划，不做小程序，专注Web端响应式设计 
根据用户明确要求，更新产品规划：

1. 移除所有小程序规划
   - 不做微信小程序
   - 不做支付宝小程序
   - 原因：审核限制多、功能受限、扩展困难

2. 调整Web端定位
   - PC端 + 手机端：一套代码（响应式）
   - PWA支持：可添加到桌面，接近原生体验
   - 优势：无审核、跨平台、浏览器即用

3. 更新未来规划
   - 短期：响应式Web端 (PC+手机)
   - 长期：根据需求启动原生App (2028+)
   - 不做小程序作为中间形态

4. 更新文档
   - UX_DESIGN.md: 调整多端策略
   - PRD.md: 移除小程序功能
   - ROADMAP.md: 调整v2.3里程碑
   - 后续优化方向.md: 移除小程序选项
   - future-plan.md: 调整长期规划
   - 完整实现总结.md: 调整移动端规划

核心决策：
- Web端是主战场（PC + 手机浏览器）
- PWA已能满足移动端需求
- 小程序限制多，跳过这一阶段
- 按需启动原生App
 2026-06-11 22:04:45 +08:00
Hermes Agent
2ac7eb8275 product: 完善产品规划设计体系 
作为产品经理角色，补充完整的市场调研分析和产品规划设计：

新增产品规划文档（4份）：

1. product/PRD.md - 产品需求文档
   - 产品定位与目标用户
   - 功能需求（P0/P1/P2/P3分级）
   - 20个功能清单（验收标准）
   - 非功能需求（性能/安全/可用性）
   - 风险评估

2. product/MARKET_RESEARCH.md - 市场调研报告
   - 市场规模：20-40亿元/年
   - 竞品分析：张雪峰/掌上高考/优志愿等
   - 用户需求：4大痛点分析
   - SWOT分析
   - 竞争策略与市场机会

3. product/ROADMAP.md - 产品路线图
   - 2026年：MVP发布+增长（v2.0-v2.1）
   - 2027年：商业化+完善（v2.2-v2.3）
   - 2028年：生态建设（v3.0）
   - 里程碑与决策检查点
   - 资源需求与风险评估

4. product/README.md - 产品规划目录
   - 规划体系说明
   - 工作流定义
   - 与其他文档关联

关键数据：
- 市场规模：1,290万考生/年，市场20-40亿元
- 差异化：唯一具备27省自动规范检查的产品
- 目标：2026年服务500+考生，2027年商业化验证

竞品空白点：
- 免费+专业+合规市场几乎空白
- 政策合规性是独特优势
- 标准化+个性化结合
 2026-06-11 21:43:09 +08:00