致远 OA 二开管理平台 · TK-ZY-OA
致远 OA 二开管理平台:OA数据唯一流通枢纽。达梦生产库只读直连、OA操作通道(撤回/终止/退回/转办)、OA数据枢纽(31前缀读/15白名单写)、外部集成API /api/ext(口令换令牌,组织架构+用户资料)、覆盖服务oa-overlay(8512,零写入)、信息展示板info-board、完整性fail-closed闸门、embed同源代理、SSO共享登录(HMAC票据)、表单查询/导出/映射、填空组件fillin、CAP4壳控件、门户自定义栏目、m3移动端适配。设备192.168.11.70:8506,公网119.145.17.34:8506
项目定位
Positioning致远 OA 二开管理平台,代号 TK-ZY-OA,是把 112 张表单、106 条我发起流程、87 个部门、7 种 CAP4 组件类型汇总进同一个网页加一组对外接口的 OA 数据枢纽。
由 Leon 林奕铮个人独立研发,从 Flask 枢纽、OA 会话代办、HMAC 票据、覆盖服务、完整性闸门到 CAP4 壳控件全部独立实现。
致远 OA A8N 是数据源头与流程引擎:达梦生产库只读取数,OA REST 加模拟登录会话做流程代办。
生产库只读,Leon 账号无写权限;已结束表单禁改,一律 sidecar 覆盖;OA 退出换人平台会话同时失效,故障域互相隔离。
表单查询、流程代办撤回终止退回、时间段与批量导出、操作审计、外部集成 API、覆盖服务、信息展示板、SSO 票据、完整性闸门、CAP4 组件库、门户自定义栏目。
上游没有的字段如用户电话邮箱如实显示无,不编数;取不到定义的组件闸门照旧 fail-closed,宁可锁不可放。
业务人员查表单导数据;经办人撤回退回;外部系统经接口拉组织与用户;运维看审计与健康。
Python Flask 加 SQLite 三库加达梦 dmPython;HMAC 票据;覆盖与认证服务 systemd 守护,主服务看护拉起。
112 张表单、106 条我发起流程、87 部门、37 映射与 11 导出历史最大 16.4MB、7 种组件类型。
端口 8506 主服务、8510 SSO 独立服务、8512 覆盖服务;git 每日备份;公网 8506 裸端口映射绕过 WAF,已知风险待纳入网关。
面向实施运维与二次开发者,先看总图与数据流建立心智模型,再按接口清单与部署形态逐段深入;操作步骤请移步说明书。
技术架构
Architecture达梦 5236 只读账号读表单与组织;OA REST 加模拟登录会话做流程代办;FIELD_INFO 分段 4000 拼接。
其他项目不再直连 OA:读走 31 前缀白名单,写走 15 条白名单加总开关,token 缓存 20 分钟,逐条审计。
表单查询、批量导出映射执行历史三标签、oa-overlay 零写入覆盖、info-board 接口驱动展示板 64KB 上限 8 秒超时。
HMAC 一次性票据 120 秒换入,yztsso 12 小时,OA 会话 30 秒缓存;外部系统凭口令换无状态令牌,错 8 次限流。
同域直连;公网走 OA 单点登录;外部系统经接口拉数;门户 iframe 嵌展示板;设计器用壳控件。
模块组成
Modules| 文件 / 目录 | 类型 | 说明 |
|---|---|---|
| ARCHITECTURE.md | 文件 | 5.7 KB |
| index.html | 文件 | 25.0 KB |
| promo.html | 文件 | 38.6 KB |
源码与素材清单
| 文件 / 目录 | 类型 | 说明 |
|---|---|---|
| ARCHITECTURE.md | 文件 | 5.7 KB |
| index.html | 文件 | 25.0 KB |
| promo.html | 文件 | 38.6 KB |
数据流转
Data Flow读数经枢纽白名单与审计;办事经登录人 OA 会话代办;换票经 OA 签票平台验票;覆盖原单只读快照按字段存 HTML。
接口与集成
APIGET /api/forms112 张表单,需登录
GET /api/flows/sent我发起的 106 条流程
GET /api/export/mappings37 条导出映射
ANY /api/oa/relay/枢纽中转,31 读白名单
GET /api/oa/flow/state流程状态
POST /api/oa/flow/launch流程发起,写白名单
POST /api/ext/token口令换令牌,12 小时上限 168 小时
GET /api/ext/org87 部门,flat 或 tree
GET /api/ext/users用户资料,白名单字段
GET /api/leon/types组件定义,OA 侧零改动增删
POST /api/leon/bind组件绑定
GET /api/leon/embed组件渲染页
POST /api/v2/integrity/verify完整性校验,经 OA 代理
GET /sso票据入口
GET /api/sso/whoami会话状态
GET /gate-demo/鉴权演示
GET /info-board/展示板
部署形态
Deployment主机 192.168.11.70,源码 /home/leonzion/Desktop/Leon-TK-Station/TK-ZY-OA/,监听 0.0.0.0:8506。
Flask dev server 非 gunicorn,setsid nohup 拉起,看护进程补拉;无 systemd。
依赖 LD_LIBRARY_PATH=venv/lib/python3.12/site-packages/dmssl 才能 import dmPython,start.sh 必须 export。
覆盖服务 systemd oa-overlay 常驻 8512;SSO 独立服务 systemd oa-sso 常驻 8510。
公网 119.145.17.34:8506 裸端口映射;SSH 生产 2222 测试 2223,文件服务 id_ed25519_leon。
改 .js/.css 免重启 OA;改 .html 必须重启 OA 域;8023 改 WEB-INF 走 systemctl restart zyoa-8023。
git 每日 05:00 自动备份;fillin.sqlite 属主 leonzion,lz 账号直接改会只读报错。