24 KiB
24 KiB
山峡化工生产一体化门户 — 工程清理 + Tag 集中化实施计划
For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (
- [ ]) syntax for tracking.
背景与目标
将 zkxw 工程清理为山峡化工生产一体化门户(shanxia2.0)的基础框架:
- 删除所有 zkxw 业务代码(前端 + 后端),仅保留系统管理、工作流管理、请假申请模块
- Tag 颜色集中化:在
sys_dict_data表新增tag_type字段,前端全局 Dict Store 统一管理所有状态标签显示,彻底删除status-tag-registry.ts - 数据库清理:删除所有业务表模型,仅保留系统表 + 工作流表 + 请假表 + 附件表
保留清单
后端保留
- API:
public.py(鉴权),menu.py(菜单),admin.py(系统管理),workflow.py(工作流),leave.py(请假) - Services:
workflow_engine.py,workflow_callback.py,web_auth_roles.py - 模型(models.py 中):Sys*, Wf*, BizLeaveRequest, BizAttachment, SysEthnic, SysApiRequestLog, SysApiRequestLogHis
- CRUD:dict_type, dict_data, dept, menu, post, role, tenant, user, workflow, leave, attachment, base, api_request_log, biz_no_generator, site
- Schemas:auth, common, leave, menu, user, workflow, attachment
前端保留
- Views 目录:
auth/,dashboard/,exception/,index/,outside/,system/(子目录: dept, dict, leave, menu, post, role, tenant, user, workflow) - API 模块:
auth.ts,admin.ts,system.ts,workflow.ts - Store:
user.ts,menu.ts,setting.ts,table.ts,worktab.ts - Router:
index.ts,sqxp.ts(精简为仅保留路由),exception.ts
删除清单
- 后端 API(17 个文件):basic_info, collection_protocol, operations, ethnic, sample_reception, qc, research_donation, production, pilot_service, insurance_company, material, storage_release_review, sample_sms_notification, storage_entry_sms_notification, pilot_application, pilot_checkup, pilot_delivery, pilot_infusion_confirm, pilot_infusion_schedule_mgmt, outbound_release_review, clinical_payment
- 后端模型(独立文件 3 个 + models.py 中 ~100 个 Biz* 类):clinical_payment.py, material.py, qc_material.py, qc_param.py, research_donation.py + models.py 中所有 Biz* 类(除 BizLeaveRequest, BizAttachment)
- 后端 CRUD(~50 个业务文件):所有非保留清单的 crud 文件
- 后端 Schemas(~30 个业务文件):所有非保留清单的 schema 文件
- 前端 Views(7 个目录):basic-info, cell-storage, operations, pilot-service, production, quality-inspection, research-donation
- 前端 API(~26 个业务文件):所有非保留清单的 api 文件
- 前端 Router:
sqxp.ts中所有业务路由(13 个一级菜单精简为 3 个:工作流管理、系统管理、Dashboard) status-tag-registry.ts:整体删除,所有 tag 走字典
实施任务
Phase 1: 数据库层变更
Task 1.1: sys_dict_data 表新增 tag_type 字段
- 编写 SQL migration 脚本
docs/sql/20260530_add_tag_type_to_dict_data.sqlALTER TABLE `sys_dict_data` ADD COLUMN `tag_type` varchar(20) NOT NULL DEFAULT '' COMMENT '标签类型:success/warning/danger/info/primary/空' AFTER `dict_value`; - 在 shanxia2.0 数据库上执行该 SQL
Task 1.2: 字典种子数据初始化
-
编写 SQL 脚本
docs/sql/20260530_seed_dict_data_for_framework.sql需要创建以下 dict_type 及其 dict_data 条目(每条都含 tag_type):
dict_type dict_name 数据项 (dict_value → dict_label / tag_type) sys_status通用状态 1 → 正常 / success, 0 → 停用 / danger sys_sex性别 0 → 男 / primary, 1 → 女 / success sys_data_scope数据权限范围 1 → 全部数据 / '', 2 → 本部门数据 / info, 3 → 本部门及以下 / info, 4 → 仅本人 / warning, 5 → 自定义 / primary sys_visible显示状态 1 → 显示 / success, 0 → 隐藏 / info menu_type菜单类型 M → 目录 / '', C → 菜单 / success, F → 按钮 / warning leave_status请假状态 draft → 草稿 / info, pending → 审批中 / warning, approved → 已通过 / success, rejected → 已驳回 / danger, cancelled → 已取消 / info wf_process_status流程实例状态 running → 进行中 / warning, completed → 已完成 / success, rejected → 已驳回 / danger, cancelled → 已取消 / info, pending → 待处理 / warning, approved → 已通过 / success, withdrawn → 已撤回 / info wf_node_type流程节点类型 start → 开始 / info, end → 结束 / info, approver → 审批人 / warning, condition → 条件分支 / primary wf_approve_type审批方式 any → 或签 / primary, all → 会签 / success user_role用户角色 admin → 管理员 / primary, super_admin → 超级管理员 / danger 每个 dict_type 先在
sys_dict_type中创建,再插入对应的sys_dict_data条目,每条都带 tag_type 值。 -
在 shanxia2.0 数据库上执行种子数据 SQL
Task 1.3: 清理数据库业务表(生成脚本,不自动执行)
- 编写 SQL 脚本
docs/sql/20260530_drop_business_tables.sql- 列出所有需要 DROP 的业务表(所有非 sys_、wf_、biz_leave_request、biz_attachment 的表)
- 脚本中每个 DROP 前加注释说明原用途
- 交给用户确认后手动执行
Phase 2: 后端清理
Task 2.1: 清理后端 API 路由文件
- 删除以下 API 文件(17 个):
backend/app/api/basic_info.py backend/app/api/collection_protocol.py backend/app/api/operations.py backend/app/api/ethnic.py backend/app/api/sample_reception.py backend/app/api/qc.py backend/app/api/research_donation.py backend/app/api/production.py backend/app/api/pilot_service.py backend/app/api/insurance_company.py backend/app/api/material.py backend/app/api/storage_release_review.py backend/app/api/sample_sms_notification.py backend/app/api/storage_entry_sms_notification.py backend/app/api/pilot_application.py backend/app/api/pilot_checkup.py backend/app/api/pilot_delivery.py backend/app/api/pilot_infusion_confirm.py backend/app/api/pilot_infusion_schedule_mgmt.py backend/app/api/outbound_release_review.py backend/app/api/clinical_payment.py
Task 2.2: 清理后端模型文件
- 删除独立模型文件(4 个):
backend/app/models/clinical_payment.py backend/app/models/material.py backend/app/models/qc_material.py backend/app/models/qc_param.py backend/app/models/research_donation.py - 精简
backend/app/models/models.py:- 保留的类:SysUser, SysRole, SysUserRole, SysRoleMenu, SysRoleDataScopeDetail, SysMenu, SysDept, SysTenant, SysSite, SysPost, SysUserPost, SysDictType, SysEthnic, SysDictData, SysApiRequestLog, SysApiRequestLogHis, BizLeaveRequest, BizAttachment, WfProcessDef, WfProcessVersion, WfNode, WfTransition, WfProcessInstance, WfTask
- 删除的类:所有 Biz* 类(除 BizLeaveRequest, BizAttachment),即从 BizItemUnit 开始到文件末尾的所有业务类
- 在 SysDictData 类中新增字段:
tag_type = Column(String(20), nullable=False, default="", comment="标签类型"),位置在dict_value之后
Task 2.3: 清理后端 CRUD 文件
-
删除以下业务 CRUD 文件(约 50 个,仅保留列出的保留清单):
# 保留:base.py, api_request_log.py, biz_no_generator.py, dept.py, dict_data.py, # dict_type.py, leave.py, menu.py, post.py, role.py, tenant.py, user.py, # workflow.py, attachment.py, site.py, ethnic.py # 删除:其余全部(cell_product.py, collection_protocol.py, customer.py ... 等约 50 个文件)完整删除列表:
backend/app/crud/cell_product.py backend/app/crud/cell_sample_type.py backend/app/crud/clean_room.py backend/app/crud/clinical_payment.py backend/app/crud/collection_protocol.py backend/app/crud/collection_protocol_no.py backend/app/crud/collection_region.py backend/app/crud/consumable.py backend/app/crud/consumable_pack.py backend/app/crud/consumable_stock_log.py backend/app/crud/customer.py backend/app/crud/exhibition_appointment.py backend/app/crud/express_company.py backend/app/crud/item_unit.py backend/app/crud/material.py backend/app/crud/material_stock_log.py backend/app/crud/outbound_handover.py backend/app/crud/outbound_handover_inventory.py backend/app/crud/outbound_release_material.py backend/app/crud/outbound_release_review.py backend/app/crud/output_type.py backend/app/crud/pilot_application.py backend/app/crud/pilot_checkup.py backend/app/crud/pilot_delivery.py backend/app/crud/pilot_infusion_confirm.py backend/app/crud/pilot_infusion_schedule_mgmt.py backend/app/crud/pilot_outbound_status_sync.py backend/app/crud/pilot_service.py backend/app/crud/process.py backend/app/crud/process_category.py backend/app/crud/process_route.py backend/app/crud/production_task.py backend/app/crud/production_work_order.py backend/app/crud/protocol_donation_convert.py backend/app/crud/qc_item_param.py backend/app/crud/qc_lab_test_item.py backend/app/crud/qc_material.py backend/app/crud/qc_material_usage.py backend/app/crud/qc_task.py backend/app/crud/qc_task_result.py backend/app/crud/qc_third_party_company.py backend/app/crud/qc_third_party_item.py backend/app/crud/qc_work_order.py backend/app/crud/reagent.py backend/app/crud/reagent_stock_log.py backend/app/crud/research_donation.py backend/app/crud/sample_code.py backend/app/crud/sample_reception.py backend/app/crud/sample_reception_check_item.py backend/app/crud/sample_reception_check_result.py backend/app/crud/sample_sms_notification.py backend/app/crud/sop_document.py backend/app/crud/storage_entry_sms_notification.py backend/app/crud/storage_facility.py backend/app/crud/storage_occupancy.py backend/app/crud/storage_release_review.py
Task 2.4: 清理后端 Schemas 文件
-
删除以下业务 Schema 文件(约 30 个,仅保留列出的保留清单):
# 保留:auth.py, common.py, leave.py, menu.py, user.py, workflow.py, attachment.py # 删除:其余全部完整删除列表:
backend/app/schemas/category.py backend/app/schemas/category_parameter.py backend/app/schemas/cell_product.py backend/app/schemas/delivery.py backend/app/schemas/inquiry.py backend/app/schemas/order.py backend/app/schemas/order_adjust.py backend/app/schemas/outbound_handover.py backend/app/schemas/outbound_release_material.py backend/app/schemas/outbound_release_review.py backend/app/schemas/price_list.py backend/app/schemas/process_route.py backend/app/schemas/product.py backend/app/schemas/product_banner.py backend/app/schemas/product_detail_media.py backend/app/schemas/product_parameter.py backend/app/schemas/product_parameter_value.py backend/app/schemas/product_review.py backend/app/schemas/product_review_media.py backend/app/schemas/production_task.py backend/app/schemas/production_work_order.py backend/app/schemas/qc_task.py backend/app/schemas/qc_work_order.py backend/app/schemas/quotation.py backend/app/schemas/region.py backend/app/schemas/storage_occupancy.py backend/app/schemas/storage_release_review.py backend/app/schemas/unit.py
Task 2.5: 更新后端路由注册
- 重写
backend/app/api/__init__.py:仅保留 public_router, menu_router, admin_router, workflow_router, leave_router 的 import 和注册 - 重写
backend/app/main.py的 import 行:仅 import 保留的 5 个 router,同时删除对已删除 API 文件的任何引用 - 更新
backend/app/main.py中的 title/description:将 "zkxw" 替换为 "shanxia2.0" / "山峡化工生产一体化门户"
Task 2.6: 后端 dict 模块改造(Tag 集中化核心)
- 修改
backend/app/models/models.py中 SysDictData:新增tag_typeColumn(在 Task 2.2 中已完成) - 修改
backend/app/crud/dict_data.py:_row_to_dict()返回值新增"tagType": d.tag_type or ""create_dict_data()新增 tag_type 参数update_dict_data()新增 tag_type 参数更新list_dict_data_options()返回值新增"tagType": r.tag_type or ""
- 修改
backend/app/api/admin.py中字典相关 endpoint:create_dict_databody 新增 tag_type 字段update_dict_datapayload 新增 tag_typedict_data_options返回值含 tagType
- 新增 API endpoint
GET /web/admin/dict-data/all:- 返回当前租户下所有有效(del_flag=0)的字典数据,按 dict_type 分组
- 返回格式:
{ "data": { "sys_status": [{ label, value, tagType }, ...], "leave_status": [...] } } - 添加到
admin.py中
Task 2.7: 清理 admin.py 中的业务端点
- 从
backend/app/api/admin.py中删除所有业务相关的端点:- 客户相关 (customer)
- 快递公司 (express)
- 计量单位 (item-unit)
- 采样区域 (collection-region)
- 细胞样本类型 (cell-sample-type)
- 采样医院 (collection-hospital)
- 其他所有非系统管理的端点
- 保留的端点:用户、角色、部门、租户、菜单、字典类型、字典数据、岗位、站点、附件上传、组织管理
Task 2.8: 验证后端可启动
- 激活 venv 后运行
python -c "from app.main import app; print('OK')" - 如有 import 错误,逐一修复(清理残留引用)
- 启动服务
./start-local.sh,确认无报错
Phase 3: 前端清理
Task 3.1: 删除业务 Views 目录
- 删除以下 7 个前端 Views 目录:
web-admin/src/views/basic-info/ web-admin/src/views/cell-storage/ web-admin/src/views/operations/ web-admin/src/views/pilot-service/ web-admin/src/views/production/ web-admin/src/views/quality-inspection/ web-admin/src/views/research-donation/
Task 3.2: 删除 system/ 下的模板/业务页面
- 删除以下目录(属于模板参考页或业务页面):
web-admin/src/views/system/category/ web-admin/src/views/system/product/ web-admin/src/views/system/order/ web-admin/src/views/system/express/
Task 3.3: 删除业务 API 模块
- 删除以下前端 API 文件(约 26 个):
web-admin/src/api/business.ts web-admin/src/api/cell-product.ts web-admin/src/api/collection-protocol.ts web-admin/src/api/ethnic.ts web-admin/src/api/infusion-schedule-handover.ts web-admin/src/api/material.ts web-admin/src/api/outbound-release-review.ts web-admin/src/api/production-task.ts web-admin/src/api/production-work-order.ts web-admin/src/api/production.ts web-admin/src/api/qc-item-param.ts web-admin/src/api/qc-lab-test-item.ts web-admin/src/api/qc-material-usage.ts web-admin/src/api/qc-material.ts web-admin/src/api/qc-task-result.ts web-admin/src/api/qc-task.ts web-admin/src/api/qc-third-party-company.ts web-admin/src/api/qc-third-party-item.ts web-admin/src/api/qc-work-order.ts web-admin/src/api/research-donation.ts web-admin/src/api/sample-reception-check-item.ts web-admin/src/api/sample-reception.ts web-admin/src/api/sample-sms-notification.ts web-admin/src/api/storage-entry-sms-notification.ts web-admin/src/api/storage-release-review.ts web-admin/src/api/chinaRegion.ts
Task 3.4: 精简前端路由
- 重写
web-admin/src/router/modules/sqxp.ts:- 仅保留 3 个一级菜单路由:
- Dashboard(控制台)
- 工作流管理(子菜单:流程配置、待办中心、已办中心、我的申请、请假申请)
- 系统管理(子菜单:租户管理、字典管理、菜单管理、组织管理、角色管理、用户管理、职位管理)
- 删除所有业务路由(细胞存储、科研捐赠、中试服务、临床应用、质检管理、生产管理、运营支撑、市场/质检/生产基础信息等)
- 更新注释为山峡化工相关
- 仅保留 3 个一级菜单路由:
Task 3.5: 删除 status-tag-registry.ts
- 删除
web-admin/src/utils/status-tag-registry.ts
Task 3.6: 清理 admin.ts 中的业务 API 函数
- 从
web-admin/src/api/admin.ts中删除所有业务相关的函数(客户、快递、计量单位等) - 保留的函数:用户、角色、部门、租户、菜单、字典类型、字典数据、岗位、站点、组织管理、附件上传
Phase 4: 前端 Tag 集中化
Task 4.1: 新增前端类型定义
- 修改
web-admin/src/types/api.d.ts:- 在
Dict.DictDataItem中新增tagType: string - 在
Dict.DictDataOption中新增tagType: string - 新增类型:
Dict { // ...existing... interface DictDataOption { label: string value: string tagType: string // 新增 } interface DictDataGroup { [dictType: string]: DictDataItem[] } interface DictAllResponse { [dictType: string]: { label: string; value: string; tagType: string }[] } }
- 在
Task 4.2: 新增前端 Dict Store
- 新建
web-admin/src/store/modules/dict.ts:// 核心功能: // 1. state: dictMap (Map<dictType, DictDataItem[]>) // 2. action: loadAllDict() — 调用 /web/admin/dict-data/all 一次性加载 // 3. getter: getLabel(dictType, value) → string // 4. getter: getTagType(dictType, value) → string // 5. getter: getOptions(dictType) → { label, value, tagType }[] - 在应用入口
web-admin/src/main.ts或登录后的路由守卫中调用loadAllDict()
Task 4.3: 新增前端 composable
- 新建
web-admin/src/composables/useDictTag.ts:// useDictTag(dictType: string) // 返回:{ getLabel(value), getTagType(value), options } // 内部从 dict store 获取数据
Task 4.4: 前端 admin.ts 新增全量加载 API
- 在
web-admin/src/api/admin.ts中新增:export function fetchAllDictData() { return request.get<Api.Dict.DictAllResponse>({ url: '/web/admin/dict-data/all' }) }
Task 4.5: 字典管理页面支持 tag_type 编辑
- 修改
web-admin/src/views/system/dict/index.vue:- 在字典数据的新增/编辑表单中增加
tag_type选择字段 - 选项:空(默认)、success(成功/绿)、warning(警告/橙)、danger(危险/红)、info(信息/灰)、primary(主要/蓝)
- 在字典数据列表中增加 tag_type 显示列(渲染为对应颜色的 el-tag 预览)
- 在字典数据的新增/编辑表单中增加
Phase 5: 保留页面 Tag 迁移
Task 5.1: 迁移 system/dept/index.vue
- 将
row.status === '1' ? 'success' : 'danger'改为dictStore.getTagType('sys_status', row.status) - 将硬编码的中文标签改为
dictStore.getLabel('sys_status', row.status)
Task 5.2: 迁移 system/user/index.vue
- 将
row.status === '1' ? 'success' : 'info'改为dictStore.getTagType('sys_status', row.status)
Task 5.3: 迁移 system/role/index.vue
- 将
row.status === '1' ? 'success' : 'info'改为dictStore.getTagType('sys_status', row.status)
Task 5.4: 迁移 system/post/index.vue
- 将
row.status === '1' ? 'success' : 'info'改为dictStore.getTagType('sys_status', row.status)
Task 5.5: 迁移 system/site/index.vue
- 将
row.status === '1' ? 'success' : 'info'改为dictStore.getTagType('sys_status', row.status)
Task 5.6: 迁移 system/menu/index.vue
- 删除
menuTypeTagMap硬编码对象 - 将菜单类型的 tag 改为
dictStore.getTagType('menu_type', row.menuType) - 将菜单类型的 label 改为
dictStore.getLabel('menu_type', row.menuType) - 将
row.visible === '1' ? 'success' : 'info'改为dictStore.getTagType('sys_visible', row.visible) - 将
row.status === '1' ? 'success' : 'danger'改为dictStore.getTagType('sys_status', row.status)
Task 5.7: 迁移 system/user/detail.vue
- 将
getRoleTagType改为dictStore.getTagType('user_role', userData.role) - 将
getRoleText改为dictStore.getLabel('user_role', userData.role) - 将
userData.isActive ? 'success' : 'danger'改为dictStore.getTagType('sys_status', userData.isActive ? '1' : '0')
Task 5.8: 迁移 system/leave/index.vue
- 删除
import { leaveStatusLabel, leaveStatusTagType } from '@/utils/status-tag-registry' - 将
statusTagType(row.status)改为dictStore.getTagType('leave_status', row.status) - 将
statusLabel(row.status)改为dictStore.getLabel('leave_status', row.status)
Task 5.9: 迁移 system/workflow/components/ProcessStatusTag.vue
- 删除硬编码
statusMap对象 - 改为从 dict store 获取:
const tagType = computed(() => dictStore.getTagType('wf_process_status', props.status)) const label = computed(() => dictStore.getLabel('wf_process_status', props.status))
Phase 6: 清理残留引用与验证
Task 6.1: 清理所有 status-tag-registry 的 import
- 全局搜索
status-tag-registry引用,确保已全部替换为 dict store - 确认文件已删除后无残留 import
Task 6.2: 清理所有已删除 API 模块的 import
- 全局搜索已删除的 API 文件 import(如
from '@/api/business',from '@/api/cell-product'等) - 清除所有残留引用
Task 6.3: 后端启动验证
cd backend && source venv/bin/activate && python -c "from app.main import app; print('OK')"- 修复任何 import 错误
Task 6.4: 前端构建验证
cd web-admin && pnpm build- 修复任何编译错误(TypeScript、模板引用等)
Task 6.5: 全局文本替换
- 搜索代码中残留的 "zkxw"、"中科兴皖"、"陇耘鲜达"、"叁强鲜配" 等旧项目名称
- 替换为 "shanxia2.0"、"山峡化工" 等新名称(注意:数据库字段 default 值中的 'zkxw' 暂时保留,等后续数据迁移时再处理)
Task 6.6: 更新 README 和项目描述
- 更新
backend/README.md项目名称和描述 - 更新
backend/app/main.py中的 title/description - 更新
.env.example中的 APP_NAME
执行顺序与并行策略
Phase 1 (DB) ──────────────────────────────── 串行,先执行
↓
Phase 2 (Backend) ── Task 2.1~2.4 可并行 ── Task 2.5~2.7 串行 ── Task 2.8 验证
↓
Phase 3 (Frontend cleanup) ── Task 3.1~3.3 可并行 ── Task 3.4~3.6 串行
↓ (可与 Phase 3 并行)
Phase 4 (Tag infrastructure) ── Task 4.1~4.4 串行
↓
Phase 5 (Tag migration) ── Task 5.1~5.9 可并行
↓
Phase 6 (验证 & 收尾) ── 串行
预估工作量
| Phase | 任务数 | 预估时间 |
|---|---|---|
| Phase 1 (DB) | 3 | 0.5h |
| Phase 2 (Backend) | 8 | 2h |
| Phase 3 (Frontend cleanup) | 6 | 1.5h |
| Phase 4 (Tag infrastructure) | 5 | 2h |
| Phase 5 (Tag migration) | 9 | 1.5h |
| Phase 6 (验证) | 6 | 1h |
| 总计 | 37 | ~8.5h |
使用 subagent 并行执行可压缩到 ~4-5h。
注意事项
- 不自动执行 DROP TABLE — 数据库业务表的删除需要用户手动确认执行
- 保留 biz_attachment 表和模型 — 附件是通用基础设施
- 保留 SysEthnic — 民族码表可能在后续业务中使用
- 保留 SysSite — 站点管理属于系统管理模块
- 后端 CRUD 的
__init__.py— 删除文件后需同步清理该文件中的 import - 后端 Schemas 的
__init__.py— 同上 - 前端 chinaRegion.ts 删除 — 地区数据属于旧业务
- 字典 CRUD 的
_row_to_dict是字段一致性检查的 single source of truth,新增 tag_type 后需要同步更新对应 schema