arch-design-agent-skill-dashboard/design/business-architecture/01-scope-and-goals.md

doc_id	title	version	status	owners	upstream	downstream	updated_at
DOC-BA-001	范围与目标	0.1.0	reviewed	林然		./02-capability-map.csv ./03-value-flows.csv ./04-user-journeys.csv	2026-03-23

范围与目标

项目名称

Arch Design Dashboard

核心问题

管理架构设计过程中：

1. 看不清设计进度——不知道设计到哪一步了，哪些做完了哪些没做
2. 理不清关系——设计文档之间的依赖关系不清晰，改了一个不知道影响哪些

用户

单人使用（林然）。设计产出给 AI agent 用于写代码。

核心功能

1. 多项目管理：支持多个项目切换
2. 可下钻的多层关系图：
   • 全景层：四大架构 + 跨架构的设计部件依赖链（capability → module → entity → runtime component）
   • 架构层：展开某个架构看内部设计文档和关系
   • 对象层：展开某个设计对象看详情
   • 代码层：关联到实际代码结构 + 实现进度
3. 设计进度追踪：每个文档/节点有完成状态，在图上以颜色体现
4. 实现进度追踪：自动扫描代码目录结构 + LLM 辅助评估模块完成度 + 手动覆盖
5. 影响分析：改一个文档时，能看到哪些下游需要同步更新
6. 在线编辑：直接在 dashboard 里编辑 CSV 和 Markdown

关键约束

• 完全围绕 minimal-design-template 目录结构工作
• 如果发现模板不足，先改模板再改工具
• Web 界面（浏览器访问）
• 服务器部署，Docker 支持
• 单人使用，无需多用户认证

目标（Goals）

1. 让架构设计的进度一眼可见，不需要翻文件夹猜
2. 让设计部件之间的关系可视化、可下钻，从全景到代码
3. 让实现进度和设计进度对应起来，知道设计了但没实现的是什么
4. 让修改一处设计时，影响范围立即可见
5. 支持在浏览器中直接编辑设计文件

非目标（Non-Goals）

1. 不做协作功能（多用户同时编辑、权限管理）
2. 不做设计内容的自动生成（那是 arch-design-agent skill 的事）
3. 不做代码生成或代码审查
4. 不做版本控制（Git 已经在做这件事）
5. 不做通知/提醒系统