68 lines
2.2 KiB
Markdown
68 lines
2.2 KiB
Markdown
---
|
||
doc_id: DOC-BA-001
|
||
title: 范围与目标
|
||
version: 0.1.0
|
||
status: reviewed
|
||
owners:
|
||
- 林然
|
||
upstream: []
|
||
downstream:
|
||
- ./02-capability-map.csv
|
||
- ./03-value-flows.csv
|
||
- ./04-user-journeys.csv
|
||
updated_at: 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. 不做通知/提醒系统
|