● Leon 独立研发 · 致远 OA 二开管理

一个平台,管住 OA 所有对外数据

由 Leon(林奕铮)独立研发的 OA 数据枢纽:达梦生产库只读直连、流程撤回与退回代办、组织架构与用户资料对外接口、单点登录票据换入、已结束表单零写入覆盖——其他平台调不到生产库、持不住 OA 会话,只能经这里消费数据。

112张表单直连
87个组织部门
7种组件类型
120 秒票据时效
项目概括

个人独立研发的
OA 数据唯一流通枢纽

致远 OA 二开管理平台(TK-ZY-OA)面向企业 OA 数据消费,由 Leon(林奕铮)独立设计与开发——达梦直连取数、流程操作代理、对外接口、SSO 票据、覆盖服务、完整性闸门等全部能力均为个人全栈实现。

与之配合的致远 OA A8N定位为上游——只放「壳控件 + 配置 + 渲染挂载点」,业务逻辑与数据全部落在本平台:表单 112 张直连读取,流程撤回与退回经平台代办,组织架构 87 部门与用户资料经口令换令牌对外,不改动 OA 现有设备与写权限。

2026 年新增类型感知闸门与对外接口:完整性校验只锁平台存数、可封存的类型,其余组件直接渲染;外部系统凭口令换令牌即可拉取组织架构与指定用户资料,让 OA 数据第一次有了受控的对外出口。

项目名称
致远 OA 二开管理平台
系统名称
TK-ZY-OA · OA 数据管理 + 流程操作 + 对外接口
开发者
Leon(林奕铮)· 个人独立研发(全栈)
上游平台
致远 OA A8N · 壳控件与数据源头(达梦生产库)
上线时间
2026 年 8 月(展示站)/ 10 月(SSO 与数据枢纽)
访问方式
公网直连;外部接口凭口令换令牌调用
◈

唯一枢纽,他处调不到

达梦生产库只读账号、OA 会话、签票密钥只落本平台,其他系统一律经枢纽与对外接口消费。

◷

零写入,红线可查

生产库禁写、已结束表单禁改;改数需求走 sidecar 覆盖展示,原单只读快照留痕。

⚑

票据准入,退出即失效

HMAC 一次性票据 120 秒,OA 退出换人立刻生效,不建第二套账号体系。

☎

增类型,OA 零改动

新组件类型在平台注册即用,OA 侧只认两个接口一个渲染页,不用重装控件。

核心能力

八个模块,覆盖数据流通全程

从“读得到”到“办得成”再到“给得出”,模块按取数、办事、对外三类组织,左侧导航一键切换。

▣

表单查询 112 张

直连达梦生产库读取 OA 表单,字段字典、数据行、附件清单只读呈现。

  • 字段字典
  • 数据行
  • 附件清单
  • 只读 SELECT
◈

流程操作 代办

撤回、终止、退回已走过节点、转办经平台用登录人自己的 OA 会话代办。

  • 撤回
  • 终止
  • 退回指定节点
  • 时间段导出
  • 批量导出
◷

外部集成 API 新

口令换令牌,外部系统只读拉取组织架构 87 部门与指定用户资料。

  • 口令换令牌
  • 组织架构
  • 用户资料
  • 调用审计
▩

覆盖服务

已结束表单零写入展示:原单只读快照,覆盖按字段存 HTML 一键切换。

  • 零写入
  • 整单横幅
  • 原文折叠
▤

信息展示板

接口驱动的展示板,改展示只改 JSON,门户 iframe 嵌入即用。

  • remote_url
  • SSO 闸门
  • 门户挂载
⚑

完整性闸门

数据不完整即锁定流程,类型感知后只锁平台存数、可封存的类型。

  • fail-closed
  • 类型感知
  • 可见锁页
☎

SSO 共享登录

OA 是唯一身份源,HMAC 票据换入,多 OA 入口任一认到即放行。

  • 一次性票据
  • 退出即失效
  • 引导等待页
❋

组件库自助

CAP4 壳控件 + 平台类型注册,新增组件 OA 侧零改动,设计器即选即用。

  • 7 种类型
  • per-form 独立
  • 弹窗展示
⬢

门户自定义栏目

信息展示栏进设计器「自定义栏目」,用户自己挂,内容改平台 JSON。

  • kkcustom
  • iframe 嵌入
⚙

操作审计

每一次数据操作留痕:按天分 JSON,永不删除,责任边界清楚。

  • 逐条审计
  • 用户管理
  • 站点设置
技术架构

轻量枢纽,不碰生产库一针一线

平台为 Leon 独立研发,以只读直连 + 会话代办对接上游致远 OA——生产库只读、流程经登录人会话代办、对外统一经枢纽审计,不改动 OA 现有设备与写权限。

01 / 数据源层

达梦只读 + OA 会话

172.168.10.97:5236 只读账号读表单与组织;OA REST + 模拟登录会话做流程代办。

02 / 枢纽服务层

oa_hub 统一中转

其他项目不再直连 OA:读走 31 前缀白名单,写走 15 条白名单 + 总开关,逐条审计。

03 / 业务能力

查询 / 导出 / 覆盖 / 展示

表单查询、批量导出、oa-overlay 零写入覆盖、info-board 接口驱动展示板。

04 / 接入鉴权

SSO 票据 + 对外令牌

HMAC 一次性票据换入;外部系统凭口令换无状态令牌调组织与用户接口。

05 / 消费层

浏览器与外部系统

同域直连;公网走 OA 单点登录;外部系统经 /api/ext 拉数;门户 iframe 嵌展示板。

后端Python Flask,SQLite 三库,systemd 守护(覆盖/认证服务),主服务看护拉起
数据源达梦 dmPython 直连(LD_LIBRARY_PATH 带 dmssl),FIELD_INFO 分段 4000 拼接
流程链路OA REST + OAWebSession 双通道,撤回 POST + _json_params,退回限历史节点
数据存储fillin / leon_types / monthly_export 三库,操作日志按天 JSON 永不删除
身份准入OA 会话校验 + HMAC 一次性票据,120 秒时效, nonce 防重放
运维git 每日备份,kysec 环境本地生成脚本再 scp 上机,端口占用先 kill 旧进程
使用说明书

按章节读,三步就能上手

面向业务与运维人员的图文手册,零术语描述操作路径。建议先读「快速开始」。

ⓘ说明书随平台版本更新;若页面与实际界面不一致,以系统内实际界面为准。
界面速览

核心界面,先睹为快

以下为平台核心界面说明(实拍截图待补充);说明书每个章节内还有更多分模块操作说明。

ⓘ想看完整操作步骤?打开使用说明书——共 9 章,每章均有操作路径与红线说明。
常见问题

用的时候最常遇到的四个问题

公网访问需要单独账号吗?

公网统一走 OA 单点登录,不需要为平台单独设账号:登录 OA 后进入平台地址即可,平台校验 OA 会话后换发 yztsso。OA 退出或换人后,平台会话随之失效。外部系统调接口则走另一条路:用 extapi 账号口令换令牌,不经过浏览器登录。

已结束的表单数据能直接改吗?

不能。生产库禁写、已结束表单禁改是红线。正确做法是用覆盖服务:原单只读拉取存快照,覆盖内容按字段存 HTML,前端一键切换“覆盖展示 / 原单展示”,原值永不丢失。

设计器里组件库显示 0 个组件怎么办?

先确认版本号:悬停组件按钮看 title,应为 V8.6.1+typegate;旧缓存请 Ctrl+F5。再看来源标签:生产 8012 达梦缺 leon_component_def 表,应显示“平台组件库(7 个组件)”——经 servlet 透传平台 /types。若仍为 0,检查平台 8506 是否存活、servlet 的 key 与地址配置。

流程被锁“NO_INSTANCE_FOR_KEY”怎么办?

这是完整性闸门在起作用:该表单字段从未封存。表单类组件提交一次即自动封存;linklist / 超链接 / 富文本类存 OA/外部、永无实例,新版闸门会自动直渲(passthrough)。若仍被锁,先 Ctrl+F5 确认新 JS,再联系管理员确认字段类型。

需要查数据,或需要一份完整说明?

同域直接打开平台;公网请从 OA 统一入口进入。操作细节见使用说明书。

查看说明书 回到顶部
📖 说明书📐 说明文档🕘 日志