project:
  name: 禅道 ZenTao 协作平台（二次开发）
  code: zentao
  type: 研发项目全流程管理平台（基于禅道开源版的二次开发）
  description: >
    以禅道（ZenTao）开源项目管理系统为底座（zt_* 表结构/实体命名完整保留），
    由 SA 团队二次开发，扩展出运维管理、车辆管理、绩效管理、
    看板协作、月评分等模块，前后端分离 + Electron 桌面端。
  baseProduct: 禅道 ZenTao（开源版，青岛易软天创）
  sourcePaths:
    backend: codes/zentao
    frontend: codes/web_zentao
coreValues:
  - 研发全流程闭环：需求(Story) → 任务(Task) → Bug → 测试(Case/Testtask) → 发布(Release)
  - 禅道数据兼容：完整复用 zt_story/zt_task/zt_bug 等禅道核心表结构与状态机
  - 过程量化：工时(Effort)、月评分(MonthScore)、绩效(Perf)、工作量统计
  - 运维一体化：运维任务/变更/故障/巡检/备份/机房/服务器监控
targetUsers:
  - role: 研发人员
    terminal: Web 管理后台 / Electron 桌面端
    scenario: 接收任务 → 登记工时 → 提交 Bug → 查看迭代
  - role: 产品经理
    terminal: Web 管理后台
    scenario: 录入需求 → 拆分用户故事 → 关联项目/计划 → 跟进验收
  - role: 项目经理
    terminal: Web 管理后台
    scenario: 建项目/执行 → 排任务 → 看板跟踪 → 月评分/绩效核算
  - role: 测试人员
    terminal: Web 管理后台
    scenario: 维护用例 → 执行测试单 → 提交结果 → 关联 Bug
  - role: 运维人员
    terminal: Web 管理后台
    scenario: 运维任务/巡检/变更/备份/故障处理
  - role: 管理员
    terminal: Web 管理后台
    scenario: 用户/角色/菜单权限/车辆/节假日等基础配置
businessModules:
  - name: 需求管理
    service: zentao
    entities: [ZtStory, ZtStoryspec, ZtStoryreview, ZtStoryExpand, ZtStoryFeedback]
    description: 禅道需求核心，含需求描述、评审、反馈、扩展字段
  - name: 任务与工时
    service: zentao
    entities: [ZtTask, ZtTaskestimate, ZtTaskspec, ZtTaskteam, ZtEffort]
    description: 任务拆分、团队任务、工时登记
  - name: 缺陷管理
    service: zentao
    entities: [ZtBug, ZtBugBindUser]
    description: Bug 生命周期（禅道 zt_bug 兼容）
  - name: 测试管理
    service: zentao
    entities: [ZtCase, ZtCasestep, ZtTesttask, ZtTestresult, ZtStoryCase]
    description: 用例库、测试单、测试结果
  - name: 产品与项目
    service: zentao
    entities: [ZtProduct, ZtProject, ZtExecutionproject, ZtProjectproduct, ZtProjectstory, ZtModule, ZtRelease, ZtReleaseDetails]
    description: 禅道产品-项目-执行三层结构、模块树、发布管理
  - name: 看板协作
    service: zentao
    entities: [ZtKanban, ZtKanbanspace, ZtKanbanregion, ZtKanbangroup, ZtKanbanlane, ZtKanbancolumn, ZtKanbancell, ZtKanbancard]
    description: 多空间多区域看板，lane/column/cell/card 四级
  - name: 绩效与评分
    service: zentao
    entities: [ZtPerfConfig, ZtMonthScore]
    description: 绩效配置、月度评分
  - name: 会议与公告
    service: zentao
    entities: [ZtMeeting, ZtNotice]
    description: 会议管理、系统公告
  - name: 运维管理
    service: zentao
    entities: [ZtYwTask, ZtYwChange, ZtYwFault, ZtYwFaultList, ZtYwPatrol, ZtYwMachineRoom, ZtYwBackups, ZtYwFwqsearch, ZtCronDevops, ZtCronDevopsUser]
    description: 运维任务/变更/故障/巡检/机房/备份/服务器监控/定时运维
  - name: 车辆管理
    service: zentao
    entities: [CarManage, CarDrivingLicense, CarFiveType, CarOperatingVehicleLevel]
    description: 车辆台账、驾驶证、车型、营运等级
  - name: 基础与权限
    service: zentao
    entities: [ZtUser, BaseMenu, BaseRole, BaseUserRole, BaseRoleAuthority, VerificationCode, FestivalConfig, ZtFile, ZtSearchindex, ZtAction, ZtActionrecent]
    description: 用户/角色/菜单/权限码、验证码、节假日、文件、搜索索引、操作日志
evidence:
  - type: CODEMAP
    path: assets/zentao/codemap/symbols/java/_symbols_index.yaml
  - type: CODEMAP
    path: assets/zentao/codemap/symbols/vue/_symbols_index.yaml
  - type: 源代码
    path: codes/zentao/src/main/java/com/sa/zentao/
  - type: 源代码
    path: codes/web_zentao/src/