From 3df2603e6f5db796eeea962c5f90dcbb924c41f0 Mon Sep 17 00:00:00 2001 From: guoqibing Date: Thu, 8 Oct 2026 16:16:07 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20assets=E8=B5=84=E6=BA=90=E7=9B=AE?= =?UTF-8?q?=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- assets/zentao/codemap/.codemap/state.yaml | 51 +++++ assets/zentao/codemap/_index.yaml | 40 ++++ .../codemap/context/_project_context.yaml | 90 ++++++++ .../zentao/codemap/context/_tech_stack.yaml | 66 ++++++ .../codemap/symbols/java/_symbols_index.yaml | 88 ++++++++ .../codemap/symbols/vue/_symbols_index.yaml | 110 ++++++++++ assets/zentao/domainmap/.domainmap/state.yaml | 51 +++++ assets/zentao/domainmap/_index.yaml | 34 +++ .../domainmap/entities/_entities_index.yaml | 207 ++++++++++++++++++ .../domainmap/glossary/_glossary_index.yaml | 136 ++++++++++++ .../domainmap/processes/_processes_index.yaml | 75 +++++++ .../zentao/domainmap/rules/_rules_index.yaml | 117 ++++++++++ 12 files changed, 1065 insertions(+) create mode 100644 assets/zentao/codemap/.codemap/state.yaml create mode 100644 assets/zentao/codemap/_index.yaml create mode 100644 assets/zentao/codemap/context/_project_context.yaml create mode 100644 assets/zentao/codemap/context/_tech_stack.yaml create mode 100644 assets/zentao/codemap/symbols/java/_symbols_index.yaml create mode 100644 assets/zentao/codemap/symbols/vue/_symbols_index.yaml create mode 100644 assets/zentao/domainmap/.domainmap/state.yaml create mode 100644 assets/zentao/domainmap/_index.yaml create mode 100644 assets/zentao/domainmap/entities/_entities_index.yaml create mode 100644 assets/zentao/domainmap/glossary/_glossary_index.yaml create mode 100644 assets/zentao/domainmap/processes/_processes_index.yaml create mode 100644 assets/zentao/domainmap/rules/_rules_index.yaml diff --git a/assets/zentao/codemap/.codemap/state.yaml b/assets/zentao/codemap/.codemap/state.yaml new file mode 100644 index 0000000..e2f4a28 --- /dev/null +++ b/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 可增量生成详情层 diff --git a/assets/zentao/codemap/_index.yaml b/assets/zentao/codemap/_index.yaml new file mode 100644 index 0000000..d3310f7 --- /dev/null +++ b/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 后增量生成 diff --git a/assets/zentao/codemap/context/_project_context.yaml b/assets/zentao/codemap/context/_project_context.yaml new file mode 100644 index 0000000..2c74375 --- /dev/null +++ b/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/ diff --git a/assets/zentao/codemap/context/_tech_stack.yaml b/assets/zentao/codemap/context/_tech_stack.yaml new file mode 100644 index 0000000..358ba5c --- /dev/null +++ b/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/ 清单 diff --git a/assets/zentao/codemap/symbols/java/_symbols_index.yaml b/assets/zentao/codemap/symbols/java/_symbols_index.yaml new file mode 100644 index 0000000..fb8c02a --- /dev/null +++ b/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/ diff --git a/assets/zentao/codemap/symbols/vue/_symbols_index.yaml b/assets/zentao/codemap/symbols/vue/_symbols_index.yaml new file mode 100644 index 0000000..52ff06c --- /dev/null +++ b/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" diff --git a/assets/zentao/domainmap/.domainmap/state.yaml b/assets/zentao/domainmap/.domainmap/state.yaml new file mode 100644 index 0000000..e5e1f42 --- /dev/null +++ b/assets/zentao/domainmap/.domainmap/state.yaml @@ -0,0 +1,51 @@ +schema: + name: domainmap.state + version: "1.0" +project: zentao +level: D1 +generatedAt: "2026-10-08" +status: completed +completedPhases: + - phase: -1 + name: 交互式初始化 + status: completed + note: 等级 D1（用户指定，与 CodeMap L1 对齐） + - phase: 0 + name: 文档扫描与分类 + status: completed + note: 无业务文档输入，领域知识从代码枚举/路由/表结构提取 + - phase: 1 + name: 业务实体提取 + status: completed + output: entities/_entities_index.yaml + - phase: 2 + name: 业务流程提取 + status: completed + output: processes/_processes_index.yaml + - phase: 3 + name: 业务规则提取 + status: completed + output: rules/_rules_index.yaml + - phase: 4 + name: 术语表构建 + status: completed + output: glossary/_glossary_index.yaml + - phase: 5 + name: 页面流程分析（D4） + status: skipped + note: D1 级不生成 + - phase: 6 + name: 配置影响分析（D4） + status: skipped + note: D1 级不生成 + - phase: 7 + name: 运行态采集（D4） + status: skipped + note: D1 级不生成，需 chrome-devtools MCP + - phase: 8 + name: CodeMap 深度交叉引用（D4） + status: skipped + note: D1 级不生成 +resume: + supported: true + upgradePath: 重新运行并指定 --level D2/D3/D4 可增量生成详情层 diff --git a/assets/zentao/domainmap/_index.yaml b/assets/zentao/domainmap/_index.yaml new file mode 100644 index 0000000..e4469d9 --- /dev/null +++ b/assets/zentao/domainmap/_index.yaml @@ -0,0 +1,34 @@ +schema: + name: domainmap.index + version: "1.0" + +project: + id: "zentao" + name: "禅道 ZenTao 协作平台（二次开发）" + description: "基于禅道开源版的研发全流程管理平台，扩展运维/车辆/绩效/看板" + domain: "研发项目管理" + baseProduct: "禅道 ZenTao（开源版）" + +level: D1 +levelNote: 快速扫描级，仅索引；实体/流程/规则详情与运行态采集需升级 D2-D4 + +source: + code: + backend: codes/zentao + frontend: codes/web_zentao + codemap: assets/zentao/codemap + +statistics: + entities: 70 + processes: 9 + ruleSets: 12 + glossaryTerms: 40 + +sections: + entities: entities/ + processes: processes/ + rules: rules/ + glossary: glossary/ + +xrefs: + note: D1 级不生成深度交叉引用；升级 D4 后生成 entity-to-code / process-to-api / screen-to-api 等 diff --git a/assets/zentao/domainmap/entities/_entities_index.yaml b/assets/zentao/domainmap/entities/_entities_index.yaml new file mode 100644 index 0000000..302a8c9 --- /dev/null +++ b/assets/zentao/domainmap/entities/_entities_index.yaml @@ -0,0 +1,207 @@ +schema: + name: domainmap.entities.index + version: "1.0" + level: D1 + note: 实体清单与模块归属；字段级详情需升级 D2+（依据：codes/zentao 70 个 entity 类 + 禅道 zt_* 表结构） + +count: 70 +domains: + - domain: 需求域 + entities: + - name: ZtStory + table: zt_story + role: 需求主表（禅道兼容） + - name: ZtStoryspec + table: zt_storyspec + role: 需求描述（多版本） + - name: ZtStoryreview + table: zt_storyreview + role: 需求评审记录 + - name: ZtStoryExpand + table: zt_story_expand(扩展) + role: 需求扩展字段 + - name: ZtStoryFeedback + table: zt_story_feedback(扩展) + role: 需求反馈 + - name: ZtStoryUser + table: zt_story_user(扩展) + role: 需求-用户关联 + - name: ZtStoryUserspec + role: 用户故事描述 + - name: ZtStoryUserTask + role: 用户故事-任务关联 + - name: ZtStoryMonthWorkload + role: 需求月度工作量 + + - domain: 任务工时域 + entities: + - name: ZtTask + table: zt_task + role: 任务主表 + - name: ZtTaskestimate + table: zt_taskestimate + role: 任务工时估算 + - name: ZtTaskspec + table: zt_taskspec + role: 任务描述 + - name: ZtTaskteam + table: zt_taskteam + role: 团队任务成员 + - name: ZtEffort + table: zt_effort + role: 工时登记 + + - domain: 缺陷域 + entities: + - name: ZtBug + table: zt_bug + role: 缺陷主表 + - name: ZtBugBindUser + role: Bug-用户绑定 + + - domain: 测试域 + entities: + - name: ZtCase + table: zt_case + role: 用例主表 + - name: ZtCasestep + table: zt_casestep + role: 用例步骤 + - name: ZtTesttask + table: zt_testtask + role: 测试单 + - name: ZtTestresult + table: zt_testresult + role: 测试结果 + - name: ZtStoryCase + role: 需求-用例关联 + + - domain: 产品项目域 + entities: + - name: ZtProduct + table: zt_product + role: 产品 + - name: ZtProject + table: zt_project + role: 项目/执行（禅道合一） + - name: ZtExecutionproject + role: 执行-项目关联 + - name: ZtProjectproduct + table: zt_projectproduct + role: 项目-产品关联 + - name: ZtProjectstory + table: zt_projectstory + role: 项目-需求关联 + - name: ZtModule + table: zt_module + role: 模块树 + - name: ZtRelease + table: zt_release + role: 发布 + - name: ZtReleaseDetails + role: 发布明细 + + - domain: 看板域 + entities: + - name: ZtKanban + role: 看板 + - name: ZtKanbanspace + role: 看板空间 + - name: ZtKanbanregion + role: 看板区域 + - name: ZtKanbangroup + role: 看板组 + - name: ZtKanbanlane + role: 泳道 + - name: ZtKanbancolumn + role: 看板列 + - name: ZtKanbancell + role: 单元格 + - name: ZtKanbancard + role: 卡片 + + - domain: 绩效域 + entities: + - name: ZtPerfConfig + role: 绩效配置 + - name: ZtMonthScore + role: 月度评分 + + - domain: 会议公告域 + entities: + - name: ZtMeeting + role: 会议 + - name: ZtNotice + role: 公告 + + - domain: 运维域 + entities: + - name: ZtYwTask + role: 运维任务 + - name: ZtYwChange + role: 运维变更 + - name: ZtYwFault + role: 故障 + - name: ZtYwFaultList + role: 故障清单 + - name: ZtYwPatrol + role: 巡检 + - name: ZtYwMachineRoom + role: 机房 + - name: ZtYwBackups + role: 数据备份 + - name: ZtYwFwqsearch + role: 服务器搜索 + - name: ZtCronDevops + role: 定时运维任务 + - name: ZtCronDevopsUser + role: 定时运维-用户 + + - domain: 车辆域 + entities: + - name: CarManage + role: 车辆台账（QO/DAO 为主） + - name: CarDrivingLicense + role: 驾驶证 + - name: CarFiveType + role: 五类车型 + - name: CarOperatingVehicleLevel + role: 营运车辆等级 + + - domain: 基础权限域 + entities: + - name: ZtUser + table: zt_user + role: 用户 + - name: BaseMenu + role: 菜单 + - name: BaseRole + role: 角色 + - name: BaseUserRole + role: 用户-角色 + - name: BaseRoleAuthority + role: 角色权限码 + - name: VerificationCode + role: 验证码 + - name: FestivalConfig + role: 节假日配置 + - name: ZtFile + table: zt_file + role: 文件 + - name: ZtSearchindex + table: zt_searchindex + role: 搜索索引 + - name: ZtAction + table: zt_action + role: 操作日志 + - name: ZtActionrecent + role: 近期操作 + - name: ZtComputerSource + role: 电脑资源 + - name: ZtDocCheck + role: 文档检查（绩效） + - name: ZtTeam + table: zt_team + role: 团队 + - name: BaseSalaryToVxError + role: 薪资推送错误记录 diff --git a/assets/zentao/domainmap/glossary/_glossary_index.yaml b/assets/zentao/domainmap/glossary/_glossary_index.yaml new file mode 100644 index 0000000..5973e7d --- /dev/null +++ b/assets/zentao/domainmap/glossary/_glossary_index.yaml @@ -0,0 +1,136 @@ +schema: + name: domainmap.glossary.index + version: "1.0" + level: D1 + note: 术语索引；口径/边界详情需升级 D2+ + +count: 40 +terms: + - term: 需求（Story） + domain: 需求域 + definition: 禅道 zt_story 需求，产品经理录入，可拆分为用户故事 + code: ZtStory + - term: 用户故事（UserStory） + domain: 需求域 + definition: 需求面向用户的拆分形态，14 态状态机（reviewing→released） + code: ZtStoryUser + - term: 需求评审 + domain: 需求域 + definition: 需求确认前的评审环节，zt_storyreview 记录 + code: ZtStoryreview + - term: 任务（Task） + domain: 任务工时域 + definition: 开发执行单元，7 态状态机，9 种类型 + code: ZtTask + - term: 工时（Effort） + domain: 任务工时域 + definition: 每日工时日历登记，zt_effort + code: ZtEffort + - term: 团队任务 + domain: 任务工时域 + definition: 多人协作任务，zt_taskteam + code: ZtTaskteam + - term: 缺陷（Bug） + domain: 缺陷域 + definition: 禅道 zt_bug，分 dev/prod/releaseBug 三类 + code: ZtBug + - term: 用例（Case） + domain: 测试域 + definition: 测试用例主表 zt_case + code: ZtCase + - term: 测试单（Testtask） + domain: 测试域 + definition: 一轮测试的执行单，zt_testtask + code: ZtTesttask + - term: 测试结果（Testresult） + domain: 测试域 + definition: 用例执行结果，zt_testresult + code: ZtTestresult + - term: 产品（Product） + domain: 产品项目域 + definition: 禅道产品线 zt_product + code: ZtProduct + - term: 项目（Project） + domain: 产品项目域 + definition: 禅道项目/执行 zt_project + code: ZtProject + - term: 执行（Execution） + domain: 产品项目域 + definition: 禅道迭代/冲刺概念，zt_executionproject 关联 + code: ZtExecutionproject + - term: 模块（Module） + domain: 产品项目域 + definition: 树形分类节点 zt_module，用于产品/需求/Bug 归类 + code: ZtModule + - term: 发布（Release） + domain: 产品项目域 + definition: 产品版本发布 zt_release + code: ZtRelease + - term: 看板空间（KanbanSpace） + domain: 看板域 + definition: 看板最高组织单元 + code: ZtKanbanspace + - term: 泳道（Lane） + domain: 看板域 + definition: 看板横向泳道 + code: ZtKanbanlane + - term: 看板列（Column） + domain: 看板域 + definition: 看板纵向列（如 待办/进行中/完成） + code: ZtKanbancolumn + - term: 卡片（Card） + domain: 看板域 + definition: 看板卡片，承载需求/任务 + code: ZtKanbancard + - term: 绩效配置（PerfConfig） + domain: 绩效域 + definition: 绩效规则配置 + code: ZtPerfConfig + - term: 月评分（MonthScore） + domain: 绩效域 + definition: 月度绩效评分 + code: ZtMonthScore + - term: 文档检查（DocCheck） + domain: 绩效域 + definition: 绩效维度的文档检查项 + code: ZtDocCheck + - term: 运维任务（YwTask） + domain: 运维域 + definition: 运维作业任务 + code: ZtYwTask + - term: 运维变更（YwChange） + domain: 运维域 + definition: 生产变更记录 + code: ZtYwChange + - term: 故障（YwFault） + domain: 运维域 + definition: 故障工单 + 故障清单 + code: ZtYwFault, ZtYwFaultList + - term: 巡检（YwPatrol） + domain: 运维域 + definition: 职场/机房巡检 + code: ZtYwPatrol, ZtYwMachineRoom + - term: 数据备份（YwBackups） + domain: 运维域 + definition: 备份作业记录 + code: ZtYwBackups + - term: 定时运维（CronDevops） + domain: 运维域 + definition: 定时触发的运维任务及执行人 + code: ZtCronDevops, ZtCronDevopsUser + - term: 操作日志（Action） + domain: 基础权限域 + definition: 禅道 zt_action 全量操作历史 + code: ZtAction + - term: 权限码 + domain: 基础权限域 + definition: 前端路由 meta.auth 与 BaseRoleAuthority 对应 + code: BaseRoleAuthority + - term: 逻辑删除 + domain: 基础权限域 + definition: DeleteFlagEnum 标记删除而非物理删 + code: DeleteFlagEnum + - term: 节假日（Festival） + domain: 基础权限域 + definition: 节假日配置，影响工时/排期计算 + code: FestivalConfig diff --git a/assets/zentao/domainmap/processes/_processes_index.yaml b/assets/zentao/domainmap/processes/_processes_index.yaml new file mode 100644 index 0000000..d4ff807 --- /dev/null +++ b/assets/zentao/domainmap/processes/_processes_index.yaml @@ -0,0 +1,75 @@ +schema: + name: domainmap.processes.index + version: "1.0" + level: D1 + note: 流程清单与阶段概览；角色/入口/API 链路详情需升级 D2+（依据：前端路由 + Controller 命名 + 禅道标准流程） + +count: 9 +processes: + - id: P01-story-flow + name: 需求全生命周期 + domain: 需求域 + stages: [草稿, 待评审, 激活, 需求明确中, 待沟通, 需求待设计, 详细设计中, 产品已设计, 需求待确认, 需求已确认, 研发中, 已完成, 已关闭, 已发布] + evidence: enums/UserStoryEnums.java（14 态有序） + frontend: views/product/story, views/implement/story + backend: ZtStoryController + + - id: P02-task-flow + name: 任务执行与工时 + domain: 任务工时域 + stages: [准备好, 进行中, 暂停, 待评审, 完成, 取消, 关闭] + evidence: enums/TaskStatus.java + frontend: views/task, views/implement/task + backend: ZtTaskController, ZtEffortController + + - id: P03-bug-flow + name: 缺陷处理 + domain: 缺陷域 + stages: [禅道标准：激活→已解决→已关闭/激活] + bugTypes: [dev 开发缺陷, prod 生产缺陷, releaseBug 发布缺陷] + evidence: enums/BugTypeEnums.java + frontend: views/implement/bug, views/test/bug, views/territory/bug + backend: ZtBugController + + - id: P04-test-flow + name: 测试执行 + domain: 测试域 + stages: [建用例→审用例, 建测试单→执行用例→记录结果→关联Bug] + frontend: views/test + backend: ZtCaseController, ZtTesttaskController, ZtTestresultController + + - id: P05-release-flow + name: 发布管理 + domain: 产品项目域 + stages: [创建发布→关联需求/Bug→发布明细] + frontend: api/release.js + backend: ZtReleaseController, ZtReleaseDetailsController + + - id: P06-kanban-flow + name: 看板协作 + domain: 看板域 + stages: [空间→区域→组→泳道→列→单元格→卡片] + evidence: enums/KanbanCellType.java, KanbanColumnType.java + frontend: api/kanban.js + backend: ZtKanban*Controller（8个） + + - id: P07-perf-score-flow + name: 绩效与月评分 + domain: 绩效域 + stages: [绩效配置→工时/工作量采集→月度评分→绩效报告] + frontend: views/perf + backend: ZtPerfController, ZtMonthScoreController, service/perf + + - id: P08-devops-flow + name: 运维作业 + domain: 运维域 + stages: [运维任务/巡检/变更/备份/故障处理 + 定时运维] + frontend: views/devops（8 子模块） + backend: ZtYw*Controller（10个） + + - id: P09-auth-flow + name: 认证与权限 + domain: 基础权限域 + stages: [登录(验证码)→菜单/角色/权限码鉴权(meta.auth)→操作日志] + frontend: views/login, views/user, router meta.auth + backend: ZtUserController, BaseRoleController, VerificationCodeController diff --git a/assets/zentao/domainmap/rules/_rules_index.yaml b/assets/zentao/domainmap/rules/_rules_index.yaml new file mode 100644 index 0000000..3b0562d --- /dev/null +++ b/assets/zentao/domainmap/rules/_rules_index.yaml @@ -0,0 +1,117 @@ +schema: + name: domainmap.rules.index + version: "1.0" + level: D1 + note: 规则集索引与状态机取值；校验/计算/流转的完整条件需升级 D2+ + +count: 12 +ruleSets: + - id: R01-user-story-status + name: 用户故事状态机 + type: transition + source: enums/UserStoryEnums.java + values: + - { code: reviewing, label: 待评审, order: 0 } + - { code: draft, label: 草稿, order: 1 } + - { code: active, label: 激活, order: 2 } + - { code: unconfirmed, label: 需求明确中, order: 3 } + - { code: waitcommunicate, label: 待沟通, order: 4 } + - { code: waitdesign, label: 需求待设计, order: 5 } + - { code: designdoing, label: 详细设计中, order: 6 } + - { code: designdone, label: 产品已设计, order: 7 } + - { code: storyunconfirmed, label: 需求待确认, order: 8 } + - { code: confirmed, label: 需求已确认, order: 9 } + - { code: developing, label: 研发中, order: 10 } + - { code: finished, label: 已完成, order: 11 } + - { code: closed, label: 已关闭, order: 12 } + - { code: released, label: 已发布, order: 15 } + note: order 13/14 缺号（代码留空），released=15 为终态 + + - id: R02-story-status + name: 需求状态（简版） + type: transition + source: enums/StoryStatusEnums.java + values: + - { code: draft, label: 草稿 } + - { code: finished, label: 完成 } + - { code: closed, label: 已关闭 } + + - id: R03-story-stage + name: 需求阶段（禅道 stage） + type: transition + source: enums/StoryStageEnums.java + + - id: R04-task-status + name: 任务状态机 + type: transition + source: enums/TaskStatus.java + values: + - { code: wait, label: 准备好 } + - { code: doing, label: 进行中 } + - { code: pause, label: 暂停 } + - { code: reviewing, label: 待评审 } + - { code: done, label: 完成 } + - { code: cancel, label: 取消 } + - { code: closed, label: 关闭 } + + - id: R05-task-type + name: 任务类型枚举 + type: validation + source: enums/TaskType.java + values: + - { code: design, label: 设计 } + - { code: devel, label: 开发 } + - { code: request, label: 需求 } + - { code: test, label: 测试 } + - { code: study, label: 研究 } + - { code: discuss, label: 讨论 } + - { code: ui, label: 界面 } + - { code: affair, label: 事务 } + - { code: misc, label: 其他 } + + - id: R06-bug-type + name: 缺陷类型 + type: validation + source: enums/BugTypeEnums.java + values: + - { code: "1", label: dev, 说明: 开发缺陷 } + - { code: "2", label: prod, 说明: 生产缺陷 } + - { code: "3", label: releaseBug, 说明: 发布缺陷 } + + - id: R07-action-type-status + name: 操作日志类型与状态 + type: transition + source: enums/ActionType.java, ActionStatus.java + note: 禅道 zt_action 历史记录体系 + + - id: R08-kanban-structure + name: 看板结构约束 + type: validation + source: enums/KanbanCellType.java, KanbanColumnType.java + note: space/region/group/lane/column/cell/card 层级与列/单元格类型约束 + + - id: R09-menu-level + name: 菜单层级 + type: validation + source: enums/BaseMenuLevelEnum.java + + - id: R10-delete-flag + name: 逻辑删除标记 + type: validation + source: enums/DeleteFlagEnum.java + + - id: R11-product-story-bug-flag + name: 产品-需求/bug 关联标记 + type: validation + source: enums/ProductBug.java, ProductStoryStatus.java + + - id: R12-user-type + name: 用户类型 + type: validation + source: enums/UserType.java + +pendingExtraction: + - 绩效计算公式（service/perf）→ rules/calculation/ + - 月评分规则 → rules/calculation/ + - 需求评审校验 → rules/validation/ + - 工时统计口径 → rules/calculation/