产品文档（Admin / Canvas / Agent / Backend）

现行代码为准。旧设计文见 docs/design/*、docs/architecture/*，本目录作测试与交付用的统一产品册。 主图/详情「品类×风格」改造实现草案：docs/design/主图详情风格改造.md。

阅读顺序

新手 / 测试入门：

1. 新手上手指南 — 怎么把系统跑起来
2. 产品需求总览 — 全系统功能全景 + 近期新增
3. 业务流程图集 — 跨模块端到端流程（mermaid）

深入开发：

1. 术语表
2. 数据模型
3. 会员 · 代理 · 销售 · 积分分佣说明书
4. 会员体系总表（终版）
5. Backend 设计 → 功能 → 接口 → 测试需求
6. Admin / Agent / Canvas（各含 requirements / functional / design / api-mapping）
7. 跨系统流程
8. 测试矩阵 + E2E 场景

文档树

docs/product/
  README.md
  shared/
    glossary.md
    data-model.md          # 总览 + 约定 + 全表索引
    data-model/            # 分域字段详解（users/billing/product/…）
    membership-agent-sales-guide.md  # 会员/代理/销售/积分分佣（人话说明）
    membership-tiers.md
    cross-system-flows.md
  backend/
    design.md | functional.md | api.md | requirements.md
  admin/
    design.md | functional.md | api-mapping.md | requirements.md
  agent/
    design.md | functional.md | api-mapping.md | requirements.md
  canvas/
    design.md | functional.md | api-mapping.md | requirements.md
  test/
    test-matrix.md | scenarios.md

系统速查

系统	代码	端口	文档
Backend	src/backend	8001	backend/
Admin	src/admin-system	5175	admin/
Agent	src/agent-system	5174	agent/
Canvas	src/infinitecanvas	5173	canvas/
Chat	src/chat	5178	Hermes/Chat Runbook

接口字段级定义以 backend/api.md 为唯一权威；前端仅维护页面→路径映射。

与旧文档关系

旧文	用法
docs/design/图现AI后台详细设计_v3.md	已归档至 docs/archive/，仅作历史背景
docs/design/canvas-admin.md	已归档至 docs/archive/，被本目录 admin/ 取代
docs/design/用户体系设计方案.md	已归档至 docs/archive/，被 membership-agent-sales-guide.md 取代
docs/design/会员系统技术设计.md、积分会员账本与对账保障方案.md	目标架构（非现行实现），保留并标注关系
docs/architecture/*	部署与分层架构补充
docs/product/shared/membership-agent-sales-guide.md	会员/代理/销售/积分分佣人话说明（现行权威）
docs/product/shared/data-model/billing.md	计费与代理表结构
docs/runbooks/billing-agent-flows.md、membership-billing-e2e.md	计费运维步骤与验收清单

维护约定

• 改表：同步 shared/data-model.md 与对应 shared/data-model/*.md 分域页
• 改路由：同步 backend/api.md 与对应前端 api-mapping.md
• 改页面：同步各系统 functional.md / requirements.md 与 test/*