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: {}