← 返回总览 / 致远 OA 二开管理平台 · TK-ZY-OA 🏢 展示 📖 说明书 🕘 日志 技术架构说明
📐 Architecture

致远 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

📁 平台开发 🌐 http://119.145.17.34:8506/ 🕑 更新于 2026-11-03
1

项目定位

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,已知风险待纳入网关。

点击查看全文 ⤢
本页读者

面向实施运维与二次开发者,先看总图与数据流建立心智模型,再按接口清单与部署形态逐段深入;操作步骤请移步说明书。

点击查看全文 ⤢
2

技术架构

Architecture
01数据源层
达梦只读会话代办
达梦只读与 OA 会话

达梦 5236 只读账号读表单与组织;OA REST 加模拟登录会话做流程代办;FIELD_INFO 分段 4000 拼接。

点击查看全文 ⤢
02枢纽服务层
白名单审计缓存
oa_hub 统一中转

其他项目不再直连 OA:读走 31 前缀白名单,写走 15 条白名单加总开关,token 缓存 20 分钟,逐条审计。

点击查看全文 ⤢
03业务能力层
导出覆盖展示板
查询导出覆盖展示

表单查询、批量导出映射执行历史三标签、oa-overlay 零写入覆盖、info-board 接口驱动展示板 64KB 上限 8 秒超时。

点击查看全文 ⤢
04接入鉴权层
票据令牌限流
SSO 票据加对外令牌

HMAC 一次性票据 120 秒换入,yztsso 12 小时,OA 会话 30 秒缓存;外部系统凭口令换无状态令牌,错 8 次限流。

点击查看全文 ⤢
05消费层
直连单点嵌入
浏览器与外部系统

同域直连;公网走 OA 单点登录;外部系统经接口拉数;门户 iframe 嵌展示板;设计器用壳控件。

点击查看全文 ⤢
3

模块组成

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
4

数据流转

Data Flow
达梦生产库 → oa_hub 枢纽 → 表单查询/导出/覆盖快照/对外接口 → 业务浏览器与外部系统

读数经枢纽白名单与审计;办事经登录人 OA 会话代办;换票经 OA 签票平台验票;覆盖原单只读快照按字段存 HTML。

点击查看全文 ⤢
5

接口与集成

API
GET /api/forms
GET

112 张表单,需登录

点击查看全文 ⤢
GET /api/flows/sent
GET

我发起的 106 条流程

点击查看全文 ⤢
GET /api/export/mappings
GET

37 条导出映射

点击查看全文 ⤢
ANY /api/oa/relay/
ANY

枢纽中转,31 读白名单

点击查看全文 ⤢
GET /api/oa/flow/state
GET

流程状态

点击查看全文 ⤢
POST /api/oa/flow/launch
POST

流程发起,写白名单

点击查看全文 ⤢
POST /api/ext/token
POST

口令换令牌,12 小时上限 168 小时

点击查看全文 ⤢
GET /api/ext/org
GET

87 部门,flat 或 tree

点击查看全文 ⤢
GET /api/ext/users
GET

用户资料,白名单字段

点击查看全文 ⤢
GET /api/leon/types
GET

组件定义,OA 侧零改动增删

点击查看全文 ⤢
POST /api/leon/bind
POST

组件绑定

点击查看全文 ⤢
GET /api/leon/embed
GET

组件渲染页

点击查看全文 ⤢
POST /api/v2/integrity/verify
POST

完整性校验,经 OA 代理

点击查看全文 ⤢
GET /sso
GET

票据入口

点击查看全文 ⤢
GET /api/sso/whoami
GET

会话状态

点击查看全文 ⤢
GET /gate-demo/
GET

鉴权演示

点击查看全文 ⤢
GET /info-board/
GET

展示板

点击查看全文 ⤢
6

部署形态

Deployment
主机 192.168.11.70,源码 /home/leonzion/Desktop/Leon-TK-Station/TK-ZY-OA/,监听 0.0.0.0:8506。

主机 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。

Flask dev server 非 gunicorn,setsid nohup 拉起,看护进程补拉;无 systemd。

点击查看全文 ⤢
依赖 LD_LIBRARY_PATH=venv/lib/python3.12/site-packages/dmssl 才能 import dmPython,start.sh 必须 export。

依赖 LD_LIBRARY_PATH=venv/lib/python3.12/site-packages/dmssl 才能 import dmPython,start.sh 必须 export。

点击查看全文 ⤢
覆盖服务 systemd oa-overlay 常驻 8512;SSO 独立服务 systemd oa-sso 常驻 8510。

覆盖服务 systemd oa-overlay 常驻 8512;SSO 独立服务 systemd oa-sso 常驻 8510。

点击查看全文 ⤢
公网 119.145.17.34:8506 裸端口映射;SSH 生产 2222 测试 2223,文件服务 id_ed25519_leon。

公网 119.145.17.34:8506 裸端口映射;SSH 生产 2222 测试 2223,文件服务 id_ed25519_leon。

点击查看全文 ⤢
改 .js/.css 免重启 OA;改 .html 必须重启 OA 域;8023 改 WEB-INF 走 systemctl restart zyoa-8023。

改 .js/.css 免重启 OA;改 .html 必须重启 OA 域;8023 改 WEB-INF 走 systemctl restart zyoa-8023。

点击查看全文 ⤢
git 每日 05:00 自动备份;fillin.sqlite 属主 leonzion,lz 账号直接改会只读报错。

git 每日 05:00 自动备份;fillin.sqlite 属主 leonzion,lz 账号直接改会只读报错。

点击查看全文 ⤢
© 2026 Leyon WorkStation · 致远 OA 二开管理平台 · TK-ZY-OA 🏢 展示 📖 说明书 🕘 日志 ← 返回项目总览