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

31 Commits

Author SHA1 Message Date
Hermes Agent
2f4eabf681 ops: add backup verification script
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 19:36:57 +08:00
Hermes Agent
ccf93c0b15 feat: add delivery status tracking and crowd quality levels
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 19:34:43 +08:00
Hermes Agent
a16fa07ba5 docs: sync historical snapshots and crowd db quality
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 17:46:34 +08:00
Hermes Agent
08148fe282 feat: add consent gating and dev verify
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 13:02:03 +08:00
Hermes Agent
a128fcda0d feat: tighten portal delivery gating and add compliance baselines
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:44:04 +08:00
Hermes Agent
3e88d00f9a docs(exec): add current execution board for only-active issues
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:23:04 +08:00
Hermes Agent
cc1b674b9a docs(review): keep only active remediation items and sync truth sources
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:19:02 +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
85605716b7 feat: add alipay simulation verification
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 07:48:17 +08:00
Hermes Agent
e7706e3b11 chore: harden real payment onboarding gate
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 06:50:21 +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
ca480ebf84 chore(quality): close T5.5 coverage gate
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 22:31:40 +08:00
Hermes Agent
9510fd16ec chore(release): finalize T5.5 coverage gate artifacts
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 16:25:54 +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
eb4f3e1e96 docs(channel-sync): add T8 truth docs and status 2026-06-12 18:00:05 +08:00
coder
ef4bb46295 docs(orders): T4.2 DAO 文档 + 实施记录 + CHANGELOG 
- data/orders/README.md: 增加 DAO API 一览表 + 加密透明化边界表
- docs/plans/T4-2-orders-dao.md: 实施记录 (设计原则 / DoD / 验证 / 风险)
- CHANGELOG.md: T4.2 条目（51 用例 / 163 总 / 386 data 全绿）
 2026-06-12 16:36:32 +08:00
Hermes Agent
a11480cf10 feat(orders): add encrypted sqlite order model 2026-06-12 15:24:20 +08:00
hermes-coder
c2eb4ce4da docs(share): T7.1 短链接生成设计 + CHANGELOG 记录 
- 新增 docs/plans/T7-sharing-mvp.md：T7 5 个子任务整体设计
  - T7.1 详细设计：base62 短码、SQLite schema、Python API、CLI、路由辅助
  - T7.2 海报 / T7.3 权限 / T7.4 撤销统计 / T7.5 WebUI 设计草案
- CHANGELOG 记录 T7.1 已完成（25 测试通过）
 2026-06-12 15:19:50 +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
56a9327e78 feat: 技术架构设计 + 详细实施计划 
根据产品规划设计完成技术设计和实施分解：

1. docs/TECH_ARCHITECTURE.md（新，587行）
   - 分层架构图（接入层/网关/服务/数据/基础设施）
   - 技术栈选型（Python + SQLite + FastAPI）
   - 核心模块设计：
     * AI审核服务（49元版）
     * 反扎堆检测
     * 数据溯源
     * 订单管理
   - 数据架构与目录结构
   - 安全设计（脱敏/权限/审计）
   - 性能指标
   - 11项技术决策记录

2. docs/IMPLEMENTATION_PLAN.md（新，432行）
   - 5大开发任务（30天）
   - T1: AI审核服务（10天，P0核心）
   - T2: 反扎堆检测（5天，P0）
   - T3: 数据溯源（5天，P1）
   - T4: 订单管理（5天，P1）
   - T5: 集成测试（5天，P0）
   - 详细周计划（4周）
   - 每个Task的DoD
   - 风险与应对

3. docs/plans/ 新增3份详细计划：
   - T1-1-crowd-db-setup.md (扎堆数据库，3个子任务)
   - T1-2-audit-skill-and-parser.md (Skill+解析器)
   - T1-4-to-1-10-audit-completion.md (T1.4-1.8完整代码)

4. docs/NAVIGATION.md 更新
   - 添加新文档索引

每个实施计划都包含：
- TDD流程（写测试→失败→实现→通过→提交）
- 完整可复制代码
- 精确文件路径
- 验证命令和预期输出
- 提交步骤

技术决策：
- 选用SQLite（本地优先，零配置）
- FastAPI作为Web框架
- 扎堆数据库手动维护（合规考虑）
- 数据溯源JSON文件存储（Git友好）
 2026-06-12 09:18:52 +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
c53e74efc6 ux: 新增用户体验设计文档 
详细回答用户提出的产品设计问题：

1. 多端支持策略
   - 当前(v2.0): Hermes对话 + 命令行（已支持）
   - 2027 Q2: Web端（响应式，PWA）
   - 2027 Q3: 微信小程序/支付宝小程序
   - 长期: 原生App（待定）

2. 不注册登录支持
   - ✅ 完全支持匿名咨询
   - ✅ 所有功能可用
   - ⚠️ 报告仅本地保存
   - 智能引导注册（但不强制）

3. 自动注册机制
   - 触发条件：提供姓名+手机号+省份+分数
   - 软注册：先创建临时档案，确认后升级
   - 极简3步：确认信息 → 设置密码 → 完成
   - 注册后权益：云端保存、跨设备同步、历史查看

4. 主动信息补充提示
   - 信息完善度评分（0-100%）
   - 适时询问策略（最多3轮1次）
   - 报告中的待完善标注
   - 方案生成前检查清单
   - 非打扰式设计（带跳过选项）

核心设计原则：
• 先服务，后注册 - 降低使用门槛
• 智能引导，不强制 - 尊重用户选择
• 适时提示，有价值 - 平衡体验与信息完整
 2026-06-11 21:54:35 +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
Hermes Agent
b402ad2f33 docs: 补充项目完整文档体系 
新增8份核心文档，完善项目文档体系：

新增文档:
- INSTALL.md - 详细安装指南（含常见问题）
- CONTRIBUTING.md - 贡献指南（流程+规范+测试）
- FAQ.md - 30个常见问题解答
- LICENSE.md - MIT许可证+中文免责条款
- docs/API.md - API接口文档（规范检查器API）
- docs/AUTHORS.md - 作者与贡献者
- docs/RELEASE.md - 版本发布说明(v2.0)
- docs/NAVIGATION.md - 文档导航索引

文档体系现已完整:
- 项目入门：README + INSTALL + TUTORIAL
- 规则参考：provinces + ERRORS
- 开发指南：DEVELOPMENT + ARCHITECTURE + API
- 用户支持：FAQ + NAVIGATION
- 项目管理：CHANGELOG + CONTRIBUTING + LICENSE
- 版本信息：RELEASE + AUTHORS

总计23+份文档，约145KB
 2026-06-11 20:03:25 +08:00
Hermes Agent
d786b8ee96 docs+tests: 完善文档体系，添加自动化测试 
新增文档：
- docs/ARCHITECTURE.md - 系统架构设计
- docs/DEVELOPMENT.md - 开发指南
- docs/TUTORIAL.md - 使用教程（导航+快速上手+API参考）

新增测试：
- tests/test_all.py - 自动化测试脚本
  - 省份简称识别（5个）
  - 方案检查（5个用例）
  - 所有测试通过
- tests/cases/hunan-578.md - 湖南测试用例
- tests/cases/zhejiang-630.md - 浙江测试用例

测试结果：所有6个测试用例通过
- 湘/浙/鲁/粤/鄂简称识别
- 湖南错误版方案检测
- 湖南修正版方案通过
- 浙江错误模式检测
- 山东正确方案通过
- 未提供省份处理
 2026-06-11 16:14:46 +08:00
Hermes Agent
6b067d9c24 v2.0: 初始化项目，建立完整目录结构 
- 创建项目目录 /home/long/projects/gaokao-volunteer-system/
- 迁移3个Skills（gaokao-college-advisor, gaokao-spec-checker, zhangxuefeng-skillset）
- 迁移独立脚本（5个当前版本+4个legacy版本）
- 复制所有文档和示例
- 创建规则库（rules/）
  - provinces/ 省份规则
  - errors/ 错误模式库（15种）
- 创建文档体系（docs/）
  - case-studies/ 真实案例
  - optimization-log/ 优化日志
  - future-plan.md 未来规划
- 添加 .gitignore 排除临时文件
- 添加 README.md 和 CHANGELOG.md
- 已支持27个省份自动适配
- 已识别15种错误模式
 2026-06-11 16:06:34 +08:00