feat: assets资源目录

assets/zentao/codemap/.codemap/state.yaml

@@ -0,0 +1,51 @@
+schema:
+  name: codemap.state
+  version: "1.0"
+project: zentao
+level: L1
+generatedAt: "2026-10-08"
+status: completed
+completedPhases:
+  - phase: 0
+    name: 辅助文档分析
+    status: skipped
+    note: L1 级不扫描辅助文档
+  - phase: 1
+    name: 技术栈检测
+    status: completed
+    output: context/_tech_stack.yaml
+  - phase: 2
+    name: 后端分析（Java）
+    status: completed
+    output: symbols/java/_symbols_index.yaml
+  - phase: 3
+    name: Android 分析（Kotlin）
+    status: skipped
+    note: 无该平台
+  - phase: 4
+    name: iOS 分析（Swift）
+    status: skipped
+    note: 无该平台
+  - phase: 5
+    name: Web 前端分析（Vue）
+    status: completed
+    output: symbols/vue/_symbols_index.yaml
+  - phase: 6
+    name: 交叉引用生成
+    status: skipped
+    note: L1 级不生成
+  - phase: 7
+    name: 外部依赖分析
+    status: skipped
+    note: L1 级不生成
+  - phase: 8
+    name: 调用链生成
+    status: skipped
+    note: L1 级不生成
+  - phase: 9
+    name: 业务知识提取（L4）
+    status: skipped
+    note: L1 级不生成
+resume:
+  supported: true
+  upgradePath: 重新运行并指定 --level L2/L3/L4 可增量生成详情层

assets/zentao/codemap/_index.yaml

@@ -0,0 +1,40 @@
+project: zentao
+name: 禅道 ZenTao 协作平台（二次开发）
+description: 基于禅道（ZenTao）开源项目管理系统的二次开发/集成系统，覆盖需求-任务-Bug-测试-发布全研发流程，扩展运维管理、车辆管理、绩效管理、看板协作等模块
+version: "1.0"
+generatedAt: "2026-10-08"
+analysisLevel: L1
+sourcePaths:
+  backend: codes/zentao
+  frontend: codes/web_zentao
+platforms:
+  - id: java
+    name: 后端 Java
+    language: java
+    basePath: codes/zentao
+    framework: Spring Boot 3.3.0
+    fileCount: 542
+  - id: vue
+    name: 管理后台前端 Vue2
+    language: vue
+    basePath: codes/web_zentao
+    framework: Vue2 + Element UI + Electron
+    fileCount: 621
+statistics:
+  java:
+    controllers: 70
+    services: 143
+    mappers: 69
+    entities: 70
+    qoDto: 67
+    enums: 21
+  vue:
+    views: 446
+    jsModules: 91
+    apiModules: 30
+    routerModules: 7
+sections:
+  context: context/
+  symbols: symbols/
+level: L1
+levelNote: 快速扫描级，仅生成索引；业务知识（公式/决策/错误/阈值）与详情文件需升级 L2-L4 后增量生成

assets/zentao/codemap/context/_project_context.yaml

@@ -0,0 +1,90 @@
+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/

assets/zentao/codemap/context/_tech_stack.yaml

@@ -0,0 +1,66 @@
+backend:
+  language: Java 17
+  framework: Spring Boot 3.3.0
+  groupId: com.sa
+  artifactId: zentao
+  build: Maven (pom.xml)
+  orm: MyBatis-Plus + MyBatis XML (resources/mapper/)
+  pagination: PageHelper (com.github.pagehelper.PageInfo)
+  excel: Alibaba EasyExcel（导入/导出，含超链接单元格、自适应列宽）
+  pdf: iText 5.5.12 + xmlworker（模板渲染 resources/templates/scope/）
+  utils: hutool-all 4.6.3, commons-lang3, spring-core
+  validation: spring-boot-starter-validation（@Validated）
+  database: MySQL（禅道 zt_* 表结构 + base_* / car_* 扩展表）
+  packageRoot: com.sa.zentao
+  packages:
+    conf: 配置类
+    constants: 常量（如 ExportConstants）
+    controller: 70 个前端控制器
+    dao: DAO 层
+    entity: 70 个实体（zt_* 禅道兼容 + base_*/car_* 扩展）
+    enums: 21 个业务枚举（状态机）
+    mapper: 69 个 MyBatis Mapper
+    qo: 查询/请求对象（SearchQo, StoryQo, ZtProjectQo 等 67 个）
+    service: 业务接口（IXxxService）
+    service/impl: 业务实现（XxxServiceImpl）
+    service/perf: 绩效计算专项
+    task: 定时/异步任务
+    utils: 工具类
+frontend:
+  language: JavaScript (ES6+)
+  framework: Vue 2 + Element UI 2.13
+  desktop: Electron（electron-builder 打包，electron-updater 自动更新）
+  projectName: sa-cc
+  build: vue-cli-service（modes: local / alpha / prod）
+  state: Vuex (store/modules/)
+  router: vue-router（modules: devops/implement/perf/product/project/territory/user）
+  http: axios 0.19
+  realtime: @stomp/stompjs（WebSocket，WebsocketTool.js）
+  editor: quill / toast-ui image-editor / markdown-it
+  charts: echarts 4.9
+  media: flv.js（视频）、g726（音频编码，话机录音相关）
+  telephony: util/phoneSystem + components/phoneRecord/HeaderCall（呼叫中心话务能力）
+  excel: file-saver + jszip + excel 静态模板（assets/excel/）
+  misc: crypto-js, dayjs, lodash, mathjs, exif-js, hotkeys-js, image-conversion, lsbridge
+  k8s: k8s/ 目录含部署清单
+  sourceDirs:
+    api: 30 个接口模块（action/auth/base/baseMenus/count/devlopFeedback/devops/holiday/index/kanban/meeting/module/perf/product/productStory/productUserStory/project/projectList/recruited/release/resource/task/test/user/userStory/usertask + WebsocketTool）
+    views: 446 个页面（dashboard/devops/error-page/fault/implement/login/perf/product/project/projectList/redirect/resource/task/territory/test/user/worktime）
+    components: 21 类公共组件（table/pagination/select/upload/cascader/commonTable/quill-editor 等）
+    layout: 主布局 + header-call 话务头部
+integrations:
+  - name: 禅道 ZenTao
+    type: 数据结构兼容（zt_* 表）
+    direction: 底座
+  - name: 呼叫中心
+    type: 前端集成（phoneSystem + g726 + flv.js）
+    direction: 前端
+  - name: WebSocket 推送
+    type: STOMP
+    direction: 后端 → 前端
+  - name: Jenkins
+    type: CI/CD
+    direction: Jenkinsfile
+  - name: K8s
+    type: 部署
+    direction: 前端 k8s/ 清单

assets/zentao/codemap/symbols/java/_symbols_index.yaml

@@ -0,0 +1,88 @@
+schema:
+  name: codemap.symbols.index
+  version: "1.0"
+  level: L1
+  note: 快速扫描级索引，仅符号清单与模块归属；方法级签名/位置需升级 L2+
+
+platform: java
+basePath: codes/zentao/src/main/java/com/sa/zentao
+statistics:
+  controllers: 70
+  serviceInterfaces: 73
+  serviceImpls: 70
+  mappers: 69
+  entities: 70
+  qoDto: 67
+  enums: 21
+
+modules:
+  - name: 需求管理
+    controllers: [ZtStoryController, ZtStoryreviewController, ZtStoryspecController, ZtStoryExpandController, ZtStoryFeedbackController, ZtStoryUserController, ZtStoryUserspecController, ZtStoryUserTaskController, ZtStoryMonthWorkloadController]
+    services: [IZtStoryService, IZtStoryreviewService, IZtStoryspecService, IZtStoryExpandService, IZtStoryFeedbackService, IZtStoryUserService, IZtStoryUserspecService, IZtStoryUserTaskService, IZtStoryMonthWorkloadService]
+    entities: [ZtStory, ZtStoryspec, ZtStoryreview, ZtStoryExpand, ZtStoryFeedback, ZtStoryUser, ZtStoryUserspec, ZtStoryUserTask, ZtStoryMonthWorkload]
+    enums: [StoryStageEnums, StoryStatusEnums, UserStoryEnums]
+
+  - name: 任务与工时
+    controllers: [ZtTaskController, ZtTaskestimateController, ZtTaskspecController, ZtTaskteamController, ZtEffortController]
+    services: [IZtTaskService, IZtTaskestimateService, IZtTaskspecService, IZtTaskteamService, IZtEffortService]
+    entities: [ZtTask, ZtTaskestimate, ZtTaskspec, ZtTaskteam, ZtEffort]
+    enums: [TaskStatus, TaskType]
+
+  - name: 缺陷管理
+    controllers: [ZtBugController, ZtBugBindUserController]
+    services: [IZtBugService, IZtBugBindUserService]
+    entities: [ZtBug, ZtBugBindUser]
+    enums: [BugTypeEnums]
+
+  - name: 测试管理
+    controllers: [ZtCaseController, ZtCasestepController, ZtTesttaskController, ZtTestresultController, ZtStoryCaseController]
+    services: [IZtCaseService, IZtCasestepService, IZtTesttaskService, IZtTestresultService, IZtStoryCaseService]
+    entities: [ZtCase, ZtCasestep, ZtTesttask, ZtTestresult, ZtStoryCase]
+
+  - name: 产品与项目
+    controllers: [ZtProductController, ZtProjectController, ZtExecutionprojectController, ZtProjectproductController, ZtProjectstoryController, ZtModuleController, ZtReleaseController, ZtReleaseDetailsController]
+    services: [IZtProductService, IZtProjectService, IZtExecutionprojectService, IZtProjectproductService, IZtProjectstoryService, IZtModuleService, IZtReleaseService, IZtReleaseDetailsService]
+    entities: [ZtProduct, ZtProject, ZtExecutionproject, ZtProjectproduct, ZtProjectstory, ZtModule, ZtRelease, ZtReleaseDetails]
+    enums: [ProjectTypeEnums]
+
+  - name: 看板协作
+    controllers: [ZtKanbanController, ZtKanbanspaceController, ZtKanbanregionController, ZtKanbangroupController, ZtKanbanlaneController, ZtKanbancolumnController, ZtKanbancellController, ZtKanbancardController]
+    services: [IZtKanbanService, IZtKanbanspaceService, IZtKanbanregionService, IZtKanbangroupService, IZtKanbanlaneService, IZtKanbancolumnService, IZtKanbancellService, IZtKanbancardService]
+    entities: [ZtKanban, ZtKanbanspace, ZtKanbanregion, ZtKanbangroup, ZtKanbanlane, ZtKanbancolumn, ZtKanbancell, ZtKanbancard]
+    enums: [KanbanCellType, KanbanColumnType]
+
+  - name: 绩效与评分
+    controllers: [ZtPerfController, ZtMonthScoreController, ZtCountController]
+    services: [IZtPerfConfigService, IZtPerfReportService, IZtMonthScoreService, IZtCountService]
+    entities: [ZtPerfConfig, ZtMonthScore]
+
+  - name: 会议与公告
+    controllers: [ZtMeetingController, ZtNoticeController]
+    services: [IZtMeetingService, IZtNoticeService]
+    entities: [ZtMeeting, ZtNotice]
+    enums: [MeetingTypeEnums]
+
+  - name: 运维管理
+    controllers: [ZtYwTaskController, ZtYwChangeController, ZtYwFaultController, ZtYwFaultListController, ZtYwPatrolController, ZtYwMachineRoomController, ZtYwBackupsController, ZtYwFwqsearchController, ZtCronDevopsController, ZtCronDevopsUserController]
+    services: [IZtYwTaskService, IZtYwChangeService, IZtYwFaultService, IZtYwFaultListService, IZtYwPatrolService, IZtYwMachineRoomService, IZtYwBackupsService, IZtYwFwqsearchService, IZtCronDevopsService, IZtCronDevopsUserService]
+    entities: [ZtYwTask, ZtYwChange, ZtYwFault, ZtYwFaultList, ZtYwPatrol, ZtYwMachineRoom, ZtYwBackups, ZtYwFwqsearch, ZtCronDevops, ZtCronDevopsUser]
+
+  - name: 车辆管理
+    controllers: [CarManageController, CarDrivingLicenseController, CarFiveTypeController, CarOperatingVehicleLevelController]
+    services: [CarManageService, ICarDrivingLicenseService, ICarFiveTypeService, ICarOperatingVehicleLevelService]
+    entities: [CarDrivingLicense, CarFiveType, CarOperatingVehicleLevel]
+    note: CarManage 实体在 dao 层/qp 层以 QO/自定义查询为主
+
+  - name: 基础与权限
+    controllers: [ZtUserController, BaseMenuController, BaseRoleController, BaseUserRoleController, VerificationCodeController, FestivalConfigController, ZtFileController, ZtSearchindexController, ZtActionController, ZtActionrecentController, ZtComputerSourceController, ZtDevelopFeedbackController, CommonsController]
+    services: [IZtUserService, IBaseMenuService, IBaseRoleService, IBaseUserRoleService, IBaseRoleAuthorityService, IVerificationCodeService, IFestivalConfigService, IZtFileService, IZtSearchindexService, IZtActionService, IZtActionrecentService, IZtComputerSourceService, IZtDevelopFeedbackService, IZtDocCheckService, IZtTeamService]
+    entities: [ZtUser, BaseMenu, BaseRole, BaseRoleAuthority, BaseUserRole, VerificationCode, FestivalConfig, ZtFile, ZtSearchindex, ZtAction, ZtActionrecent, ZtComputerSource, ZtDocCheck, ZtTeam, BaseSalaryToVxError]
+    enums: [BaseMenuLevelEnum, DeleteFlagEnum, UserType, ActionStatus, ActionType, FileTypes, PickEnum, ProductBug, ProductStoryStatus]
+
+qoObjects:
+  note: qo/ 目录下 67 个查询/请求对象
+  examples: [SearchQo, StoryQo, ZtProjectQo]
+
+mappers:
+  count: 69
+  note: 与实体基本一一对应，XML 在 resources/mapper/

assets/zentao/codemap/symbols/vue/_symbols_index.yaml

@@ -0,0 +1,110 @@
+schema:
+  name: codemap.symbols.index
+  version: "1.0"
+  level: L1
+  note: 快速扫描级索引，仅页面/模块清单；组件级 props/事件与 API 调用明细需升级 L2+
+
+platform: vue
+basePath: codes/web_zentao/src
+projectName: sa-cc
+statistics:
+  vueFiles: 530
+  views: 446
+  jsModules: 91
+  apiModules: 30
+  routerModules: 7
+  storeModules: unknown(L1未展开)
+  componentDirs: 21
+
+router:
+  modules: [devops.js, implement.js, perf.js, product.js, project.js, territory.js, user.js]
+  authPattern: meta.auth 权限码数组（如 ['devops-ywtask']）
+  topRoutes:
+    - path: /devops
+      title: 运维任务
+      auth: [devops-ywtask]
+      children: [/devops/holiday 节假日, /devops/hjzxxj 职场巡检, /devops/backups 数据备份, /devops/machineroom 机房巡检, /devops/change 运维变更, /devops/fwq 系统运维监控, /devops/task 运维管理]
+    - path: /implement
+      title: 项目迭代
+      auth: [implement-list]
+      children: [/implement/story/:id 需求, /implement/story-info/:id 需求详情, /implement/task/:id 任务, /implement/task-info/:id 任务详情, /implement/bug/:id bug, /implement/bug-info/:id bug详情]
+
+apiModules:
+  count: 30
+  list: [action, auth, base, baseMenus, count, devlopFeedback, devops, holiday, index, kanban, meeting, module, perf, product, productStory, productUserStory, project, projectList, recruited, release, resource, task, test, user, userStory, usertask, WebsocketTool]
+
+views:
+  - module: dashboard
+    path: views/dashboard
+    pages: [index.vue]
+    note: 工作台首页（含 components/ dialog/）
+  - module: devops（运维）
+    path: views/devops
+    pages: [backups, change, fwq, hjzxxj, holiday, machineroom, task, ywtask]
+    note: 对应路由 /devops/* 8 个子模块
+  - module: fault（故障记录）
+    path: views/fault
+    pages: [record]
+  - module: implement（项目迭代）
+    path: views/implement
+    pages: [index.vue, story/, storyinfo/, task/, taskinfo/, bug/, buginfo/, look/, testtask/, components/, dialog/, tab/]
+    note: 迭代维度聚合 需求/任务/bug/测试单
+  - module: perf（绩效）
+    path: views/perf
+    pages: [config.vue, docCheck.vue, manualScoreDialog.vue, report.vue]
+  - module: product（产品）
+    path: views/product
+    pages: [index.vue, story/, storyinfo/, userstory/, userstoryinfo/, feedback/, feedbackinfo/, devlopfeedback/, meeting/, components/, dialog/, tab/]
+  - module: project（项目）
+    path: views/project
+    pages: [index.vue, child/, tab/, components/, dialog/]
+  - module: projectList（项目列表）
+    path: views/projectList
+    pages: [index.vue, info/, tab/, components/, dialog/]
+  - module: resource（资源）
+    path: views/resource
+    pages: [index.vue, tab/, dialog/]
+  - module: task（任务）
+    path: views/task
+    pages: [index.vue, tab/, components/, dialog/]
+  - module: territory（地域/辖区）
+    path: views/territory
+    pages: [index.vue, story/, storyinfo/, task/, bug/, buginfo/, feedback/, feedbackinfo/, search/, components/, dialog/]
+  - module: test（测试）
+    path: views/test
+    pages: [index.vue, case/, bug/]
+  - module: user（用户/权限）
+    path: views/user
+    pages: [user/, role/, menu/]
+  - module: worktime（工时）
+    path: views/worktime
+    pages: [count]
+  - module: login
+    path: views/login
+  - module: error-page
+    path: views/error-page
+
+components:
+  dirs: [HeaderCall, MdPreview, Picker, StatusTag, buttons, cascader, commonTable, layout, map, pageInfos, pagination, phoneRecord, popoverConfirm, quill-editor, saCell, select, table, upload, vueEditor]
+  notable:
+    - HeaderCall: 话务头部（呼叫中心）
+    - phoneRecord: 通话录音（g726 音频）
+    - commonTable: 通用表格（业务列表基座）
+    - StatusTag: 禅道状态标签映射
+
+layout:
+  main: layout/（含 home/ header-call/ float-drag/）
+  note: 主布局 + 话务悬浮头
+
+telephony:
+  dirs: [util/phoneSystem, components/HeaderCall, components/phoneRecord, common/g726]
+  note: Electron 桌面端呼叫中心能力（软电话/录音/话务）
+
+store:
+  path: store/modules/
+  note: Vuex 模块（L1 未展开清单）
+
+realtime:
+  tool: api/WebsocketTool.js
+  protocol: STOMP
+  lib: "@stomp/stompjs"