55 lines
3.2 KiB
Markdown
55 lines
3.2 KiB
Markdown
# YoVision 文档导航
|
||
|
||
YoVision 当前目标是完成默认 16 路的智能视频事件闭环，同时从数据模型、分片、接口和 UI 操作上兼容单站点 128 路横向扩展。
|
||
|
||
## Agent 入口
|
||
|
||
- [`../AGENTS.md`](../AGENTS.md)：仓库级规则与唯一工作入口。
|
||
- [AI 开发入口](00-ai-start-here.md)：固定开工、领取、验证与收尾流程。
|
||
- [Agent 上下文清单](agent-context.md) / [`agent-context.json`](agent-context.json) / [`Schema`](agent-context.schema.json)：按任务类型读取最小上下文。
|
||
- [当前实现状态](current-state.md)：代码现实、可运行命令、blocker。
|
||
- [编码规则](05-coding-rules.md)：写代码前必须遵守的硬约束。
|
||
|
||
## 产品与架构
|
||
|
||
- [项目愿景](01-vision.md)：为什么做、为谁做、产品原则与非目标。
|
||
- [需求](02-requirements.md)：MVP、P0、容量和验收。
|
||
- [技术栈](03-tech-stack.md)：既定组件、待定项、运行与验证矩阵。
|
||
- [架构设计](04-architecture.md)：Sense/Brain/Bell 边界、数据流与扩展约束。
|
||
- [任务路线图](06-tasks.md)：M0–M6 阶段和建议任务；不维护实时状态。
|
||
- [用户故事](07-user-stories.md)：业务目标、价值、验收场景。
|
||
- [交互清单](08-interaction-checklist.md)：Web/App/值班台的状态、反馈和无障碍门禁。
|
||
- [API 合约](api.md)：已冻结事件契约和待冻结内部/外部接口。
|
||
- [路由与页面](routes.md)：页面职责和导航边界。
|
||
- [设计原型约定](design/README.md)：P0 UI 开工前的 HTML 原型输入。
|
||
|
||
## 任务与协作
|
||
|
||
- [任务文件](tasks/README.md)：`docs/tasks/T-<编号>.md` 保存规格与长期证据；实时状态在 Gitea Issue。
|
||
- [Gitea MCP](gitea-mcp.md)：本机私有配置、工具审批和断连降级。
|
||
- [Gitea 协作协议](gitea-collaboration.md)：Issue、claim、工作分支、PR 和写路径防撞。
|
||
- [收尾清单](clean-state-checklist.md)：保证下一轮可恢复。
|
||
- [方法对照表](method-map.md)：失败模式到首要治理工件。
|
||
- [评审评分表](evaluator-rubric.md)：单次交付质量评审。
|
||
- [质量文档](quality-document.md)：长期健康度追踪。
|
||
|
||
## 原始与追溯资料
|
||
|
||
- [`raw/01-需求收集.md`](raw/01-需求收集.md)：完整需求条目与待确认问题。
|
||
- [`raw/02-需求分析.md`](raw/02-需求分析.md)：分层、领域模型、状态机、容量与风险推导。
|
||
- [`raw/03-通用场景应用方案.md`](raw/03-通用场景应用方案.md)：组件选型、NVR 决策、部署与演进方案。
|
||
- [`raw/08-三系统职责划分.md`](raw/08-三系统职责划分.md)：Sense/Brain/Bell 的详细目录和七条边界。
|
||
- [`raw/contracts/README.md`](raw/contracts/README.md)：事件契约 v0.1 的冻结说明与代码级断言。
|
||
|
||
`raw/04` 至 `raw/06` 是目标客户方案，`raw/07` 是 silver_pose 契约比对。`其他项目的文档/` 只作历史参考，不是当前实现依据。
|
||
|
||
## 权威性
|
||
|
||
- 实现入口：本文列出的 harness 文档。
|
||
- 决策追溯：`docs/raw/`。
|
||
- 事件字段与语义：`docs/raw/contracts/`。
|
||
- 实时任务状态：Gitea Issue。
|
||
- 任务规格与证据：`docs/tasks/T-<编号>.md`。
|
||
|
||
发现冲突时先修正文档和任务，不得靠聊天记忆继续实现。
|