行业背景：装备制造央企子公司，业务涵盖成套装备研发制造与销售，支出（采购）、收入（销售）、服务三类合同并存，年合同体量大、审批链路长。
立项前的痛点：
1. 起草低效、风险靠人防：合同起草依赖 Word 邮件流转，版本混乱；条款风险、印花税税目、关联交易披露全靠人工把关；
2. 审批周期长：一笔合同需经业务负责人 → 法务 → 职能部门会签（合规/财务/供应链）→ 发起人确认 → 分管领导 → 发起人归档等 7~9
个节点，线下签字跨部门流转慢，出差即停滞；
3. 集团合规硬约束：归档编号须符合集团规范（年月-部门-收支-用印类型-流水号）、盖章扫描件归档、关联交易审批留痕；
4. 履约与合同脱节：收付款、开票、质保金数据靠手工 Excel 台账，管理层无法实时掌握合同履行与到期风险。
立项目标：建设覆盖“起草 → 审批 → 归档 → 履约 → 变更/终止 → 统计分析”的合同全生命周期线上平台，并与飞书组织架构、消息推送、移动审批深度打通。
1. 工作台：待办聚合、统计卡片、快捷入口
2. 合同起草：按集团57项字段规范重构表单；收支方向驱动合同类型联动（收入5类/支出8类）；产品细分联动；相对方主数据弹窗选择并自动带出8项工商信息；质保金比例自动计算；金额明细（含税/税率/税额）；合同初稿必传校验
3. 模板管理：标准合同模板库；基于模板一键生成；起草稿与模板在线差异对比
4. AI智能审核：对接飞书自建应用对合同初稿智能审核，未审核不可提交审批
5. 合同审批：7~9节点BPM流程；职能部门多角色会签；发起人确认节点（可补传初稿再推进）；发起人归档节点（上传盖章扫描件+用印类型，自动生成集团规范归档编号）；支持审批人预览改派、驳回修改重提交、流程抄送
6. 台账与归档：合同台账多维查询；Excel批量导出；历史合同批量导入；到期提醒
7. 履约管理：挂账/付款/收入/收款/开票5类履约流水；累计发生额自动累计；错误流水红冲撤销；收付款计划
8. 变更/终止：独立子流程审批，原合同状态自动联动（变更中/终止中 → 恢复或终止）
9. 统计分析：合同金额/收支/部门多维统计，日/季/年时间维度，ECharts可视化
10. 移动端审批：飞书内待办/已办/合同详情/同意驳回/拍照上传盖章件完成归档
11. 系统管理：用户/角色/菜单/部门/字典管理、飞书组织架构定时同步
本人从0-1搭建，进行售前-调研-单独开发-测试-部署等。
技术栈
后端：Spring Boot 3.2.5 + MyBatis‑Plus + MySQL + Redis + Sa‑Token + warm‑flow流程引擎；
前端：Vue3 + TypeScript + Vite + Element Plus(PC) + Vant4(移动端) + Pinia + ECharts + LogicFlow + OnlyOffice；
集成：飞书开放平台（OAuth SSO、消息卡片、AppLink），Nginx容器化部署。
实现亮点
1. 审批人预演改派：提交前调用simulate接口预演全流程审批节点，发起人弹窗可直接改派；改派结果以token存入流程变量，确保预览与实际派单完全一致。
2. 自研权限Token体系：封装user/role/form/strategy四类权限token，支持部门负责人、发起人本人等角色，结合或签/会签/票签百分比规则，20余种审批场景无需硬编码。
3. 单工程双端架构：PC、移动端两套路由共存，依据UA自动识别跳转；postcss局部px‑vw转换，样式互不冲突；对接飞书SSO实现免密登录。
4. Word模板差异对比：基于HWPF解析Word文档，使用LCS算法比对合同草稿与标准模板，高亮改动点辅助法务审核。
攻克难点
1. warm‑flow 深度扩展：扩展会签百分比计数能力，解决审批回调监听器事务时序问题，实现流程多版本平滑升级，历史流程实例不受变更影响。
2. 雪花 ID 精度处理：针对 JS 长整型精度丢失问题，制定全链路雪花 ID 字符串传递规范，规避前端数据失真。
4. 飞书集成适配：处理重定向白名单、动态域名、WebView 下载拦截、多端 UA 分流与深链映射等兼容性问题，保障飞书端业务正常运行。
评论