第 01 章
🏠home
平台是干什么的、怎么进、去哪个模块
本说明书教你从零开始使用致远 OA 二开管理平台。按顺序读,先看「快速开始」。
平台是谁开发的? 表单查询、流程代办、对外接口、覆盖服务、SSO 票据、完整性闸门等全部功能模块,均由 Leon(林奕铮)个人独立研发。致远 OA A8N 与达梦生产库是上游数据源,平台以只读直连 + 会话代办对接,不改动 OA 现有设备与写权限。
这个平台是干什么的
把散在 OA 各个角落的数据与操作,汇总到一个网页:查 112 张表单、跟自己发起的 106 条流程、批量导出 Excel、撤回与退回走错的流程、给外部系统开组织架构与用户资料接口、给已结束表单贴覆盖展示——专为企业 OA 数据消费做的「唯一流通枢纽」。
访问地址
| 使用场景 | 地址 | 状态 |
|---|---|---|
| 统一入口(推荐) | http://119.145.17.34:8506/ |
✅ 需先登录 OA(SSO 换票) |
| 内网直连 | http://192.168.11.70:8506/ |
✅ 同域更快 |
| 外部系统调接口 | http://119.145.17.34:8506/api/ext/... |
✅ 口令换令牌 |
统一走 OA 单点登录:登录 OA 后进入该地址即可,退出 OA 后平台会话同时失效。
页面地图
flowchart TD
A[打开平台地址] --> B{左侧点哪个模块}
B --> C[表单查询<br/>112 张表单]
B --> D[流程查询<br/>我发起的 106 条]
B --> E[批量导出<br/>映射/执行/历史]
B --> F[操作日志<br/>按天留痕]
B --> G[管理设置<br/>用户/站点]
B --> H[外部集成<br/>组织/用户接口]
C --> J[选表 → 看数据 → 时间段导出]
D --> K[选流程 → 撤回/退回/终止]
E --> L[配映射 → 执行 → 下 Excel]
阅读导航
- ⚡《快速开始》——3 分钟跑通全流程,所有人先看这页
- ▣《表单查询与导出》——查表单、三种显示模式、批量导出
- ◈《流程操作》——撤回、终止、退回指定节点
- ◷《外部集成 API》——口令换令牌、组织架构与用户资料
- ▩《覆盖服务》——已结束表单零写入展示
- ☎《SSO 接入》——票据格式、换票入口、多 OA 入口
- ❋《CAP4 组件库》——7 种类型、设计器选用、独立配置
- ⁇《常见问题》——0 组件、锁页、空白、端口占用速查
三条必须知道的规则
- 生产库只读,不直接改数。已结束表单一律走覆盖服务展示,后台禁 UPDATE formmain。
- 流程操作用你自己的 OA 会话。平台按登录用户缓存 OA 会话,谁登录看到的就是谁的流程。
- 数据不完整会被锁。完整性闸门 fail-closed:无实例、无封存的流程禁止查看流转,先提交一次或联系管理员。
相关链接(本项目四入口)
| 入口 | 说明 |
|---|---|
| 展示 | /s/tk-zy-oa/ —— 定位、架构、四段核心代码与技术踩坑,黑底滚动版 |
| 宣传 | /s/tk-zy-oa/promo.html —— 浅色落地页,价值、能力、架构、FAQ |
| 架构 | /a/tk-zy-oa/ —— 定位 / 架构总图(mermaid)/ 数据流 / 接口 / 部署 |
| 日志 | /c/tk-zy-oa/ —— 每次改版与部署的版本留痕 |
| 说明书 | 本页 —— 面向使用者的 9 章操作手册 |
说明书 v1.0 · 2026-11-03 · 对应平台(含 /api/ext、oa-overlay、类型感知闸门)