feat: assets资源目录

2026-10-08 16:16:07 +08:00
parent e98660ce4e
commit 3df2603e6f
12 changed files with 1065 additions and 0 deletions
@@ -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/
@@ -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/ 清单