140 lines
5.1 KiB
YAML
140 lines
5.1 KiB
YAML
requirement_id: REQ-001
|
||
title: arch-design-agent-skill-dashboard：项目管理性能优化（首次打开更快、切换项目更快）
|
||
status: draft
|
||
source_type: manual_entry
|
||
source_reference:
|
||
- nextcloud-talk:room:鉴需 message:25798
|
||
- nextcloud-talk:room:鉴需 message:25800
|
||
- nextcloud-talk:room:鉴需 message:25805
|
||
request_owner: 林然
|
||
target_users:
|
||
- 开发团队
|
||
- 架构师/设计人员
|
||
problem_statement: |
|
||
当前 arch-design-agent-skill-dashboard 的“项目管理”存在明显的性能体感问题：
|
||
- 首次打开项目管理页面加载慢
|
||
- 在已有项目之间切换慢
|
||
|
||
这会降低日常使用效率，影响项目注册/切换与后续扫描、图谱浏览、编辑等工作流的连续性。
|
||
expected_outcome: |
|
||
在不改变现有「项目管理配置」语义的前提下，优化项目管理相关的加载/切换体验：
|
||
- 首次打开“项目管理”页面更快达到可操作状态
|
||
- 切换项目更快达到可操作状态
|
||
|
||
说明：本需求强调“复用现有项目管理配置”，不引入新的配置体系。
|
||
business_value: |
|
||
提升工作台的日常可用性与操作效率：减少等待时间，提升项目注册、切换与浏览的流畅度，
|
||
间接提升设计扫描、图谱分析、编辑等能力的使用频率与满意度。
|
||
urgency_level: medium
|
||
impact_scope_summary: |
|
||
涉及范围：项目管理相关前后端接口/页面的性能优化与体验优化。
|
||
不涉及：新增一套项目管理配置、改变现有配置字段含义。
|
||
created_at: 2026-04-03T04:33:33Z
|
||
updated_at: 2026-04-03T04:33:33Z
|
||
original_request: |
|
||
1：复用现在的项目管理的配置。
|
||
2：a和b
|
||
|
||
a和b指的是首次打开要快，切换项目要快
|
||
relations:
|
||
parent: null
|
||
relation_type: independent
|
||
children: []
|
||
associated: []
|
||
depends_on: []
|
||
evolved_from: null
|
||
conflict_warnings: []
|
||
primary_capability: ""
|
||
secondary_capabilities: []
|
||
related_contexts: []
|
||
related_modules: []
|
||
clarification:
|
||
known_facts:
|
||
- 需求明确：复用现有项目管理配置（不需要新配置体系）。
|
||
- 需求目标：首次打开更快、切换项目更快。
|
||
questions:
|
||
- question: 性能口径是否按 P95（多次操作取 95 分位）衡量？
|
||
status: proposed
|
||
answer: 默认按 P95 口径；如需调整为平均值/最大值可再改。
|
||
- question: 验收环境是否以 Docker Compose 标准部署为准？
|
||
status: proposed
|
||
answer: 默认以项目标准部署方式（Docker Compose）在同等硬件条件下验证。
|
||
- question: “可操作状态”的判定口径是什么？
|
||
status: proposed
|
||
answer: 默认以列表/主要内容渲染完成且按钮可交互、无 loading 为准。
|
||
assumptions:
|
||
- 可通过前端埋点或浏览器性能面板/Network 统计来验证“可操作”的时间点。
|
||
- 项目切换对应 API 调用完成且页面主要内容渲染完成后视为可操作。
|
||
constraints:
|
||
- 不改变现有项目管理配置语义；仅做性能/体验层优化。
|
||
acceptance:
|
||
criteria:
|
||
- criterion_id: AC-001-01
|
||
description: 首次打开“项目管理”页面达到可操作状态的耗时（P95）不超过 2s
|
||
verification_method: user_test
|
||
status: pending
|
||
checklist:
|
||
- item: 进入项目管理页面后，列表/按钮可交互（不再显示加载中）
|
||
passed: false
|
||
- item: 连续多次测试统计 P95 ≤ 2s
|
||
passed: false
|
||
evidence: []
|
||
verdict: pending
|
||
verdict_reasoning: ""
|
||
- criterion_id: AC-001-02
|
||
description: 切换项目达到可操作状态的耗时（P95）不超过 1s
|
||
verification_method: user_test
|
||
status: pending
|
||
checklist:
|
||
- item: 从项目列表点击进入某项目（或侧栏切换）后，页面主要内容可交互
|
||
passed: false
|
||
- item: 连续多次切换统计 P95 ≤ 1s
|
||
passed: false
|
||
evidence: []
|
||
verdict: pending
|
||
verdict_reasoning: ""
|
||
- criterion_id: AC-001-03
|
||
description: 复用现有项目管理配置；不新增/不要求用户迁移到新的配置体系
|
||
verification_method: review
|
||
status: pending
|
||
checklist:
|
||
- item: 现有项目列表仍可正常读取/保存（对用户无破坏性变更）
|
||
passed: false
|
||
evidence: []
|
||
verdict: pending
|
||
verdict_reasoning: ""
|
||
bugs: []
|
||
design_progress:
|
||
overall_status: in_progress
|
||
current_phase: clarification
|
||
context_scan:
|
||
status: done
|
||
completed_at: 2026-04-03T04:33:00.238Z
|
||
requirement_intake:
|
||
status: done
|
||
completed_at: 2026-04-03T04:36:06.127Z
|
||
clarification:
|
||
status: in_progress
|
||
acceptance_definition:
|
||
status: not_started
|
||
capability_mapping:
|
||
status: not_started
|
||
domain_design:
|
||
status: not_started
|
||
engineering_planning:
|
||
status: not_started
|
||
ui_design:
|
||
status: not_started
|
||
review:
|
||
status: not_started
|
||
implementation_plan_write:
|
||
status: not_started
|
||
implementation_execution:
|
||
status: not_started
|
||
ac_checking:
|
||
status: not_started
|
||
next_action:
|
||
phase: clarification
|
||
task: 执行 clarification 阶段
|
||
artifact_index: {}
|