泛微OA (E-Cology 9 / E8) 全功能后端接口与数据库开发知识库与 AI Skill

Important

⚠️ 本仓库已归档，请改用新仓库

本仓库内容已全部合并至 👉 weaver-e9-dev

合并后做的改进：

• 统一文档范式：538 个后端接口 + 1,699 张表 + 138 个前端方法，现在可被同一个检索脚本搜索
• 修复残缺目录：本仓库 skills/weaver-oa-dev/ 下缺失整个 scripts/（没有检索工具与字典），表文件也只有 920/1699；docs/ 与 .agents/ 两份才是完整的
• 去掉三份重复副本（docs/ + skills/ + .agents/），仓库体积 38MB → 12MB
• 统一两套混用的表结构列格式，并修复了「结果被 --limit 截断时谎报总数」的检索脚本问题

新仓库地址 → https://github.com/silent-reader-cn/weaver-e9-dev

本仓库已停止维护，保留仅供历史查阅。

本项目深度整合了泛微官方开放平台（https://e-cloudstore.com/）全量 538 个后端 REST 接口、官方安全认证鉴权体系、1,699 张底层物理数据库表字典、WebService (SOAP) 规范、高频业务 SQL 字典、第三方单点登录 (SSO) 与组织架构同步方案，并封装为标准的 Antigravity AI 开发 Skill 与 Node.js / JavaScript 开发工具包。

---

🌟 核心知识体系 (17 大专题全覆盖)

• 全量 REST API (538个): 覆盖工作流 (45)、人力资源 (225)、知识管理 (60)、考勤 (107)、表单建模 (19)、门户 (76)、协作邮件 (6)。
• 全量底层数据库表 (1,699张): 覆盖 26 个模块的全部物理表结构（人力资源 295、工作流程 236、集成模块 136、财务管理 133、表单建模 120、客户管理 103、知识管理 92 等）。
• 深度认证指南: 官方三步认证全流程（regist 注册 -> applytoken 申请 -> 业务调用），包含 RSA 密钥加密规范、RSA 加密 userid 身份绑定、彻底屏蔽 Cookie 防串号机制、Jar 包冲突处理与 Redis 缓存排查。
• 经典 WebService (SOAP): 涵盖 WorkflowService 流程创建/流转、DocService 附件 Base64 创建、HrmService 组织同步 WSDL 规范与 SOAP 报文。
• 高频 SQL 字典: 提供待办/已办高性能分页查询、审批流转历史日志全景图、部门递归查询 CTE、主子表动态关联查询等生产级 SQL 模版。
• 第三方 SSO 与组织同步: 钉钉 (DingTalk)、企业微信 (WeChat Work)、飞书 (Feishu) 免密登录与通讯录 WebHook 实时监听同步架构。
• 前端 JS 完整 API: 收录官方完整的流程表单 WfForm 与建模表单 ModeForm JavaScript API 全功能手册。
• 实战 JS / Node.js 工具: 提供原生 Node.js E9 开放平台标准鉴权 SDK、538 个 API 检索工具及 1,700 张表快速检索工具。

---

📁 目录结构

weaveroa/
├── .agents/
│   └── skills/
│       └── weaver-oa-dev/                      # Antigravity 专属 Skill
│           ├── SKILL.md                        # Skill 主入口与执行规范
│           ├── references/                     # 17 大专题接口文档与核心指南
│           │   ├── 01_auth_and_security.md     # 官方认证鉴权规范 (RSA+AES+Token+避坑指南)
│           │   ├── 02_workflow_apis.md         # 工作流程 API (45个)
│           │   ├── 03_hrm_apis.md              # 人力资源与组织架构 API (225个)
│           │   ├── 04_doc_knowledge_apis.md    # 知识文档管理 API (60个)
│           │   ├── 05_attendance_apis.md       # 考勤管理 API (107个)
│           │   ├── 06_form_modeling_apis.md    # 表单建模 API (19个)
│           │   ├── 07_portal_apis.md           # 门户管理 API (76个)
│           │   ├── 08_cowork_and_email_apis.md # 协作与邮件 API (6个)
│           │   ├── 09_custom_backend_dev.md    # 后端 Java 二次开发实战指南
│           │   ├── 10_api_quick_index.md       # 538 个 API 端点速查字典
│           │   ├── 11_wfform_frontend_api.md   # 流程表单前端 WfForm API 手册
│           │   ├── 12_modeform_frontend_api.md # 建模表单前端 ModeForm API 手册
│           │   ├── 13_message_push_apis.md     # 消息中心与第三方推送开发指南
│           │   ├── 14_webservice_soap_apis.md  # WebService (SOAP) WSDL 接口规范
│           │   ├── 15_high_frequency_sql_and_db_dict.md # 常用高频 SQL 与数据库表字典
│           │   ├── 16_thirdparty_sso_and_sync.md # 第三方单点登录 (SSO) 与组织架构集成
│           │   ├── 17_all_tables_index.md      # 全量 1700+ 数据库表索引大全
│           │   └── database_tables/            # 26 个模块 1,699 张表的详细 Markdown 定义
│           ├── scripts/                        # JavaScript / Node.js 核心脚本
│           │   ├── ecology_token_client.js     # Node.js 版 E9 鉴权与调用 SDK
│           │   ├── api_search.js               # Node.js 版 API 命令行快速检索工具
│           │   ├── table_search.js             # Node.js 版 1700 张表快速检索工具
│           │   ├── db_dictionary.json          # 1,699 张表结构元数据 JSON
│           │   ├── ecology_token_client.py     # Python 版 E9 鉴权与调用 SDK
│           │   └── api_search.py               # Python 版 API 检索工具
│           └── examples/                       # JavaScript 实战开发示例
│               ├── workflow_integration.js     # 工作流创建与待办查询 (Node.js)
│               ├── hrm_organization_sync.js    # 人力资源与组织架构同步 (Node.js)
│               ├── form_custom_codeblock.js    # 表单前端 WfForm JS 联动与校验代码块
│               ├── doc_attachment_upload.js    # 知识文档创建与富文本处理 (Node.js)
│               └── webservice_soap_client.js   # 原生 Node.js SOAP WebService 客户端
├── docs/                                       # 离线 Markdown 文档库 (供阅读)
│   ├── README.md
│   ├── 01_开发规范与安全认证.md
│   ├── 02_工作流程接口.md
│   ├── 03_人力资源接口.md
│   ├── 04_知识管理接口.md
│   ├── 05_考勤管理接口.md
│   ├── 06_表单建模接口.md
│   ├── 07_门户管理接口.md
│   ├── 08_协作与邮件接口.md
│   ├── 09_二次开发指南.md
│   ├── 10_API接口速查字典.md
│   ├── 11_流程表单前端WfForm接口.md
│   ├── 12_表单建模前端ModeForm接口.md
│   ├── 13_消息中心与第三方推送.md
│   ├── 14_WebService接口开发规范(SOAP).md
│   ├── 15_常用高频SQL与数据库表字典.md
│   ├── 16_第三方单点登录(SSO)与组织架构集成.md
│   ├── 17_全量1700+数据库表索引与速查.md
│   └── database_tables/                        # 1,699 张表的离线文档镜像
└── README.md

---

🚀 快速上手 (Node.js)

1. 命令行检索 538 个 API 接口

# 检索工作流待办相关接口
node .agents/skills/weaver-oa-dev/scripts/api_search.js 待办

# 检索人力资源模块的 POST 接口
node .agents/skills/weaver-oa-dev/scripts/api_search.js -m 人力资源 -X POST

2. 命令行检索 1,699 张数据库表结构

# 检索包含“待办”或“流程”的数据库表
node .agents/skills/weaver-oa-dev/scripts/table_search.js 待办

# 查看指定表（如 workflow_currentoperator）的完整字段定义与数据类型
node .agents/skills/weaver-oa-dev/scripts/table_search.js workflow_currentoperator -d

3. Node.js 客户端调用 E9 接口

const EcologyClient = require('./.agents/skills/weaver-oa-dev/scripts/ecology_token_client');

// 初始化客户端
const client = new EcologyClient({
  baseUrl: 'http://oa.yourcompany.com:8088',
  appId: 'b59e05ced89f43d69ed7d6bdb6c57140',
  defaultUserId: '1'
});

async function main() {
  // 发起流程待办列表查询 (底层自动完成 RSA/AES 握手鉴权与 Token 刷新)
  const todoList = await client.request({
    path: '/api/workflow/paService/getToDoWorkflowRequestList',
    method: 'POST',
    data: { pageSize: '20', pageNo: '1' }
  });

  console.log('待办流程数据:', todoList);
}

main();