---
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. 不做通知/提醒系统