3.1 KiB
3.1 KiB
2026-04-23 工作记录
分析 OPS2 流程管理平台架构
完成了对项目前后端完整运行逻辑的分析:
- 项目性质:内部流程管理平台,前后端同源部署(后端 Gin serve 前端 dist)
- 后端:Go 1.24 + Gin + GORM,支持 SQLite/MySQL/PostgreSQL 三选一
- 前端:Vue 3 + Vite + Pinia + Tailwind CSS,Hash History 路由
- 认证:自实现 Cookie Token(非 JWT),存于数据库,支持"记住我"滚动续期
- 数据库:13 张表,涵盖用户体系(4张)、认证日志(2张)、文件(1张)、日程(2张)、采购(5张,含软删除+操作日志双保险)
- 核心功能:日程日历(FullCalendar,公开可访问)+ 采购流程管理(完整状态流转)+ 用户系统
- 权限设计:基于用户组(schedule_admin / purchase_admin),内存缓存管理员 ID 列表
- 文件系统:SHA256 内容寻址,自动去重存储
- API 协议:统一
{ userCookieValue, data }请求体,统一{ err_code, err_msg, return }响应体
新增 work_order 工单模块
完整实现了工单模块,文件清单:
后端(backend/my_work/routers/)
apiWorkOrder.go:4张表(TabWorkOrder / TabWorkOrderFileBind / TabWorkOrderCommit / TabWorkOrderLog)+ 7个接口(add/update/list/get/commit/delete/count)+ work_order_admin 用户组api.go:注册/api/work_order/*路由main.go:注册ApiWorkOrderInit()
前端(frontend/ops_vue_js/src/)
api/work_order.js:API 封装views/work_order/WorkOrderList.vue:工单列表页(分页+状态筛选)views/work_order/AddEditWorkOrder.vue:新增/编辑页(图片上传 useDropzone)views/work_order/ShowWorkOrder.vue:详情页(进度时间线+新增进度表单)router/index.js:注册4条路由(list/add/edit/:id/show/:id)components/AppHeader.vue:导航菜单添加"工单"入口i18n/zh-CN.json&i18n/en.json:添加 work_order 翻译节和 appname.work_order
工单状态枚举:pending/checked/parts_ordered/repaired/returned/unrepairable
commit 图片支持:
- 后端:新增
TabWorkOrderCommitFileBind表(commit_id/work_order_id/file_id),commit 接口接收photos数组,get 接口返回每条 commit 的 photos - 前端:ShowWorkOrder.vue 新增进度表单底部加了 useDropzone 组件,每条进度时间线下方展示关联图片
- API:
commit(id, status, comment, photos)函数签名新增 photos 参数
工单关联采购订单:
- 后端:新增
TabWorkOrderPurchaseOrderBind表(work_order_id/commit_id/purchase_order_id),支持多对多关联 - commit 接口新增
purchaseOrderIds参数([]uint) - get 接口每条 commit 返回
purchaseOrders数组(包含 id/title/status) - 新增
/search_purchase_orders接口:空搜索返回最新5条,支持 ID 精确匹配和标题/备注模糊匹配 - 前端:状态选
parts_ordered时显示采购订单搜索框(防抖300ms),输入框获取焦点自动搜索 - 时间线每条 commit 下方展示关联的采购订单链接(点击跳转到采购详情页)