简介点狮OA是一套面向集团级企业及多租户SaaS服务场景的开源企业办公系统专为中大型组织提供可定制化、高扩展性的协同办公解决方案解决跨子公司流程隔离、权限独立、业务灵活适配等核心管理难题。资源包共2000个文件以485个Java后端逻辑文件、850个HTML前端页面、414个JS交互脚本及107个CSS样式文件为主体辅以JSON配置、SQL建表与Python工具脚本完整覆盖前后端工程结构压缩包大小37.51MB代码规范、模块清晰便于二次开发与系统集成。目前已有175人学习下载适合具备Java Web开发基础的工程师深入研究多租户架构设计、Flowable流程引擎深度应用支持并行/会签/回退/转办等全生命周期操作以及与HRM、CRM、ERP等点狮生态系统的无缝对接实践。1. 点狮OA为什么集团级企业宁可自建多租户办公系统也不用通用SaaS你见过这样的场景吗某制造集团下属12家子公司财务用A系统、人力用B平台、项目审批走C流程各公司IT管理员各自为政数据孤岛深得连集团CIO都查不到一张跨公司差旅报销的完整链路。这时候有人推来一套“开箱即用”的SaaS办公系统——结果试了三天就卡在权限模型上总部要能穿透查看所有子公司流程但子公司A又坚决不允许B公司看到自己的合同审批节点。通用SaaS的RBAC基于角色的访问控制在这里直接失效。点狮OA正是为这类矛盾而生它不是把“多公司入驻”当作营销话术而是把租户隔离粒度精确到数据库Schema级业务域配置热插拔组织树跨租户可见性策略作为底层设计铁律。它不面向中小微企业做标准化交付而是专为需要“统分结合”治理能力的集团型客户构建——既满足集团统一合规审计、主数据管控、流程协同的要求又保障各子公司在审批流、表单字段、附件策略上的自治权。如果你正评估是否该放弃公有云SaaS转向私有化多租户方案这篇笔记就是从零部署点狮OA并跑通首个跨租户审批闭环的实操手记。2. 搭建点狮OA多租户底座从源码编译到三节点集群部署点狮OA采用Spring Cloud Alibaba微服务架构核心模块包括tenant-core租户元数据管理、auth-center统一认证中心、workflow-engine可配置流程引擎和biz-portal租户定制化门户。其多租户能力并非靠Nginx反向代理或应用层简单加租户ID前缀实现而是深度耦合在数据访问层DAO与服务注册发现机制中。这意味着部署时必须同步完成租户注册中心初始化、分布式事务协调器配置、以及跨租户消息路由规则加载三个关键动作。以下步骤基于v3.8.2 LTS版本2024年Q2稳定分支所有操作均在CentOS 7.9 OpenJDK 17 MySQL 8.0.33环境下验证通过。2.1 编译源码并确认租户隔离模式参数点狮OA官方未提供二进制发行包必须从Git仓库拉取源码后手动构建。关键在于识别其多租户实现模式——它支持SCHEMA每个租户独立数据库Schema、SHARDING共享库分表和DISCRIMINATOR单表租户字段三种模式但仅SCHEMA模式支持完整的跨租户流程协同与审计追溯这也是集团级客户唯一被支持的生产模式。# 克隆官方代码仓库注意使用企业内网镜像地址避免公网依赖 git clone https://gitlab.internal/oa/pointlion/pointlion-oa.git cd pointlion-oa # 查看pom.xml中profile定义确认默认激活schema模式 grep -A 5 idschema/id pom.xml # 输出应包含activeByDefaulttrue/activeByDefault # 构建全量模块跳过test生产环境需单独运行集成测试套件 mvn clean package -Pschema -Dmaven.test.skiptrue # 检查生成物target目录下应存在tenant-core-3.8.2.jar等12个独立jar包 ls target/ | grep -E (tenant|auth|workflow|portal) | wc -l # 预期输出12逻辑说明-Pschema参数激活Maven Profile会加载src/main/resources/schema/application-tenant.yml其中定义tenant.isolation.mode: SCHEMA及tenant.schema.prefix: t_。该前缀将用于后续数据库初始化脚本生成租户专属Schema名如t_shenzhen_factory。若误用sharding模式后续将无法配置跨租户审批节点跳转。2.2 初始化MySQL多租户元数据库与Schema模板点狮OA要求MySQL实例预先创建两个库pointlion_meta存储所有租户的元信息如租户ID、Schema名、状态、创建时间和pointlion_template作为新租户Schema的克隆模板。后者必须包含完整表结构但无业务数据且所有表引擎强制为InnoDB。-- 创建元数据库字符集必须为utf8mb4否则中文租户名会截断 CREATE DATABASE IF NOT EXISTS pointlion_meta CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 创建模板库此库将被克隆为每个租户的实际Schema CREATE DATABASE IF NOT EXISTS pointlion_template CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 执行官方提供的模板SQL位于docs/sql/template-schema.sql -- 注意该脚本会创建27张表含tenant_info租户主表、org_tree组织树、flow_definition流程定义等核心表 SOURCE /path/to/docs/sql/template-schema.sql;参数说明pointlion_template库中的flow_definition表必须包含cross_tenant_support: TINYINT(1) DEFAULT 0字段该字段决定流程是否允许跨租户流转。默认值为0需在创建租户时由管理员显式开启。若遗漏此字段后续配置跨租户审批时前端将报“流程不支持跨域”错误且无日志提示。2.3 部署三节点高可用集群Nacos注册中心Seata事务协调器点狮OA依赖Nacos作为服务注册与配置中心同时集成Seata AT模式处理跨服务分布式事务例如审批通过后同步更新财务系统和HR系统的操作。三节点部署是保障租户服务不因单点故障中断的最低要求。# 下载Nacos v2.3.0必须匹配点狮OA内置客户端版本 wget https://github.com/alibaba/nacos/releases/download/2.3.0/nacos-server-2.3.0.tar.gz tar -zxvf nacos-server-2.3.0.tar.gz # 修改cluster.conf配置三节点IP假设为10.10.1.10, 10.10.1.11, 10.10.1.12 echo 10.10.1.10:8848 nacos/conf/cluster.conf echo 10.10.1.11:8848 nacos/conf/cluster.conf echo 10.10.1.12:8848 nacos/conf/cluster.conf # 启动三台Nacos每台执行 ./nacos/bin/startup.sh -m cluster # 验证集群状态任一节点执行curl curl -X GET http://10.10.1.10:8848/nacos/v1/ns/operator/metrics # 返回JSON中应含raftState:Leader和raftState:Follower节点# 部署Seata Server v1.7.1与点狮OA的seata-spring-cloud-starter版本严格对应 wget https://github.com/seata/seata/releases/download/v1.7.1/seata-server-1.7.1.tar.gz tar -zxvf seata-server-1.7.1.tar.gz # 修改registry.conf指向Nacos集群 sed -i s/localhost:8848/10.10.1.10:8848,10.10.1.11:8848,10.10.1.12:8848/g seata/conf/registry.conf # 初始化Seata全局事务表执行一次即可在pointlion_meta库中 mysql -h10.10.1.10 -uadmin -p pointlion_meta seata/script/server/db/mysql.sql关键配置seata/conf/file.conf中store.mode必须设为db且store.db.datasource指向pointlion_meta库。这是为了确保所有租户的全局事务日志统一落库便于集团审计员按租户ID查询跨系统事务链路。若设为file模式事务日志分散在各节点磁盘无法实现集中追溯。3. 创建首个集团租户从元数据注册到组织树映射租户创建不是简单的后台表INSERT操作而是一套原子化工作流元数据写入 → Schema克隆 → 组织树初始化 → 认证密钥生成 → 门户主题加载。点狮OA提供tenant-admin-cli命令行工具完成全流程避免人工操作导致状态不一致。3.1 使用CLI工具注册集团总部租户tenant-admin-cli是点狮OA配套的轻量级管理工具无需Java环境直接执行二进制文件。它通过调用tenant-core暴露的REST API完成租户生命周期管理并自动校验租户名唯一性、Schema前缀合法性等约束。# 下载并解压CLI工具版本必须与服务端一致 wget https://artifactory.internal/oa/cli/tenant-admin-cli-v3.8.2-linux-amd64.tar.gz tar -zxvf tenant-admin-cli-v3.8.2-linux-amd64.tar.gz # 注册集团总部租户参数含义-n租户标识符-d租户显示名-s Schema前缀-o组织树根节点名 ./tenant-admin-cli register \ -n group_headquarters \ -d XX集团总部 \ -s t_group \ -o XX集团 # 成功返回示例 # {code:200,message:Tenant created successfully,data:{tenantId:tnt-8a9f3c1e,schemaName:t_group}}逻辑说明该命令实际触发三步操作1向pointlion_meta.tenant_info插入记录2以pointlion_template为模板执行CREATE DATABASE t_group CHARACTER SET utf8mb43调用tenant-core内部服务在t_group库中初始化组织树根节点org_tree表首条记录parent_idnull。若中途失败CLI会自动回滚已执行步骤保证元数据与物理Schema强一致。3.2 为子公司创建租户并建立跨组织关系子公司租户创建需额外指定--parent-tenant-id参数这将在元数据库中建立父子租户关系并触发组织树跨租户挂载逻辑。例如深圳工厂租户需归属集团总部其组织树将自动继承总部的“集团审批委员会”节点。# 创建深圳工厂租户指定父租户为集团总部 ./tenant-admin-cli register \ -n sz_factory \ -d 深圳工厂 \ -s t_sz \ -o 深圳工厂 \ --parent-tenant-id tnt-8a9f3c1e # 创建上海研发中心租户同样归属集团总部 ./tenant-admin-cli register \ -n sh_rnd \ -d 上海研发中心 \ -s t_sh \ -o 上海研发中心 \ --parent-tenant-id tnt-8a9f3c1e参数说明--parent-tenant-id值来自上一步返回的tenantId。该参数不仅建立元数据关系更关键的是当深圳工厂员工发起“跨部门技术评审”流程时流程引擎会自动检索pointlion_meta.tenant_relation表获取上海研发中心的租户ID并将审批节点路由至sh_rnd库中的flow_instance表。若遗漏此参数跨租户流程将无法被目标租户的服务实例消费。3.3 验证租户隔离与跨租户可见性租户创建完成后必须验证两个核心能力1数据物理隔离深圳工厂无法查询上海研发中心的员工信息2组织树逻辑可见集团总部可查看所有子公司的组织架构。-- 登录MySQL切换至深圳工厂Schema USE t_sz; -- 尝试查询上海研发中心的员工表应返回ERROR 1146: Table t_sh.sys_user doesnt exist SELECT * FROM sys_user LIMIT 1; -- 切换至集团总部Schema USE t_group; -- 查询组织树视图该视图聚合所有子租户的组织节点但隐藏敏感字段如身份证号 SELECT node_name, tenant_code, depth FROM org_tree_view WHERE depth 2; -- 预期输出两行深圳工厂tnt-8a9f3c1e、上海研发中心tnt-8a9f3c1e验证要点org_tree_view是点狮OA预置的数据库视图其定义为SELECT node_name, tenant_code, depth FROM t_sz.org_tree UNION ALL SELECT ... FROM t_sh.org_tree。该视图由tenant-core服务在租户注册时动态生成确保集团管理员无需手动维护跨库查询语句。若视图未生成检查tenant-core日志中是否出现Failed to generate org_tree_view for tenant group_headquarters错误。4. 配置跨租户审批流程从流程建模到节点权限映射点狮OA的流程引擎支持“租户域”和“全局域”双模式。普通审批如请假限定在本租户内流转而涉及多公司协同的流程如集团采购招标、跨厂技术标准评审必须启用全局域并为每个节点显式配置可操作租户范围。这是区别于通用OA的核心能力。4.1 在流程设计器中启用全局域并定义跨租户节点点狮OA提供Web版流程设计器URL:http://gateway-ip/designer登录集团总部管理员账号后进入“全局流程模板”菜单。此处创建的流程将被所有租户继承但各租户可覆盖节点审批人配置。# 启动流程设计器服务需单独部署非tenant-core内置 java -jar flow-designer-3.8.2.jar \ --spring.profiles.activeprod \ --server.port9001 \ --nacos.server-addr10.10.1.10:8848操作路径点击【新建全局流程】→ 流程名称填“集团技术评审”拖入“开始节点” → “评审申请”表单节点关联tech_review_form拖入“租户选择网关” → 设置条件${applicant.tenantCode} t_sz→ 分支1深圳工厂初审拖入“跨租户审批节点” → 关键配置租户范围勾选“上海研发中心”、“集团总部”节点类型GLOBAL_APPROVAL非普通APPROVAL审批人策略TENANT_ADMIN自动指派各租户的管理员发布流程版本号自动生成V1.0.0-global逻辑说明“租户选择网关”是点狮OA特有组件根据申请人租户ID动态分流。若申请人来自深圳工厂t_sz则进入深圳初审环节若来自上海研发中心t_sh则进入上海初审。而“跨租户审批节点”会生成两条独立的审批任务一条存入t_sh.flow_instance待上海研发中心管理员处理另一条存入t_group.flow_instance待集团总部管理员处理。两任务状态互不影响但最终流程实例状态由tenant-core的聚合服务统一计算。4.2 为跨租户节点配置租户级审批人全局流程发布后各租户需在自身管理后台配置具体审批人。此步骤不可跳过否则跨租户节点将始终处于“待分配”状态。# 登录深圳工厂租户后台URL: http://gateway-ip/t_sz # 导航至【流程管理】→【我的流程】→ 找到“集团技术评审 V1.0.0-global” # 点击【配置节点】→ 选择“跨租户审批节点” → 【编辑租户映射】 # 在弹窗中 # - 上海研发中心选择“张工技术总监” # - 集团总部选择“李总CTO” # 保存配置参数说明配置保存后tenant-core会向pointlion_meta.tenant_node_mapping表插入记录包含flow_version_id、tenant_code、node_id、approver_user_id四字段。当深圳工厂员工提交申请时流程引擎依据此映射表精准将任务推送给上海研发中心的张工用户ID在t_sh.sys_user中和集团总部的李总用户ID在t_group.sys_user中。若未配置任务将滞留在tenant-core的待分发队列超时后触发告警。4.3 触发真实跨租户流程并验证消息路由使用Postman或curl模拟深圳工厂员工提交评审申请观察任务是否正确分发至其他租户。# 构造申请数据注意tenantCode必须为t_sz curl -X POST http://gateway.internal/api/v1/flow/start \ -H Content-Type: application/json \ -H X-Tenant-ID: t_sz \ -d { flowCode: GROUP_TECH_REVIEW, version: V1.0.0-global, formData: { projectName: 智能产线二期, reviewType: 硬件选型, applicant: 王五 } } # 检查上海研发中心库的任务表 mysql -h10.10.1.11 -ut_sz -p t_sh -e SELECT status, assignee FROM flow_instance WHERE flow_codeGROUP_TECH_REVIEW ORDER BY create_time DESC LIMIT 1 # 预期statusPENDING, assigneezhanggong # 检查集团总部库的任务表 mysql -h10.10.1.10 -ut_group -p t_group -e SELECT status, assignee FROM flow_instance WHERE flow_codeGROUP_TECH_REVIEW ORDER BY create_time DESC LIMIT 1 # 预期statusPENDING, assigneelizong关键验证点X-Tenant-ID请求头必须与申请人所在租户一致否则tenant-core的租户解析过滤器会拒绝请求。若忘记添加此HeaderAPI将返回401 Unauthorized错误日志显示Tenant context not found for request。这是新手最常踩的坑务必在Postman中设置全局Header。5. 多租户运维避坑指南5个血泪经验总结部署点狮OA多租户系统过程中我们踩过不少坑。这些不是文档里写的“注意事项”而是线上环境真金白银换来的教训。以下5条按发生频率排序每条都附带定位方法和修复命令。5.1 现象新租户登录后首页空白浏览器控制台报GET /api/tenant/config 404原因tenant-core服务未正确加载租户配置通常因Nacos配置中心中缺少tenant-group_headquarters.yaml配置文件。点狮OA要求每个租户在Nacos中必须有独立配置文件即使内容为空。解决# 登录Nacos控制台http://10.10.1.10:8848进入配置管理 → 新建配置 # Data ID: tenant-group_headquarters.yaml # Group: DEFAULT_GROUP # 配置格式必须为YAML不能是Properties tenant: code: group_headquarters name: XX集团总部 # 发布后重启tenant-core服务5.2 现象跨租户流程中上海研发中心审批通过后集团总部任务状态仍为PENDING原因Seata全局事务未生效导致t_sh.flow_instance状态更新成功但t_group.flow_instance更新因事务回滚失败。根本原因是seata-server的store.db.db-type配置为mysql但实际连接的是MySQL 8.0需显式指定驱动类。解决# 修改seata/conf/file.conf # 将store.db.driver-class-name com.mysql.jdbc.Driver # 改为store.db.driver-class-name com.mysql.cj.jdbc.Driver # 并添加store.db.url参数中的时区?serverTimezoneAsia/Shanghai # 重启seata-server5.3 现象集团总部管理员在组织树视图中看不到子公司节点原因org_tree_view视图未自动重建。点狮OA在租户注册时调用tenant-core的ViewGeneratorService但该服务依赖nacos.config.server-addr配置若配置错误则静默失败。解决# 登录tenant-core服务所在服务器查看日志 grep ViewGeneratorService /var/log/tenant-core/app.log # 若出现Failed to connect to Nacos config server修正application.yml中 # spring: # cloud: # nacos: # config: # server-addr: 10.10.1.10:8848,10.10.1.11:8848,10.10.1.12:8848 # 重启tenant-core5.4 现象使用CLI创建租户时提示Schema t_sz already exists但MySQL中确无此库原因MySQL的lower_case_table_names参数为1Linux默认但点狮OA在生成Schema名时未统一转小写导致t_sz和t_SZ被视为不同库。CLI先检查t_sz不存在然后执行CREATE DATABASE t_SZ再检查时发现t_sz仍不存在循环报错。解决# 临时修改MySQL配置需重启MySQL # 在/etc/my.cnf中添加 [mysqld] lower_case_table_names0 # 重启MySQL后重新执行CLI命令5.5 现象流程设计器中保存全局流程后部分租户后台看不到该流程原因租户缓存未刷新。点狮OA为提升性能将流程定义缓存在各tenant-core节点的Caffeine本地缓存中TTL为30分钟。新流程发布后旧节点可能仍返回空列表。解决# 向所有tenant-core节点发送缓存刷新指令需配置actuator端点 curl -X POST http://10.10.1.10:8080/actuator/tenant-cache/refresh curl -X POST http://10.10.1.11:8080/actuator/tenant-cache/refresh curl -X POST http://10.10.1.12:8080/actuator/tenant-cache/refresh # 或直接重启所有tenant-core服务影响较小因有Nacos健康检查6. 集团级治理技巧用租户标签体系实现动态权限收敛点狮OA的终极价值不在“能跑通跨租户流程”而在支撑集团级治理策略落地。比如财务部要求所有子公司采购流程必须经过集团法务审核人力资源部要求技术岗晋升需集团CTO终审。这些规则不能硬编码在流程中而应通过租户标签Tenant Tag 动态策略引擎实现。这是我在线上环境沉淀出的最实用技巧。6.1 为租户打标定义可继承的治理属性租户标签是点狮OA 3.8版本新增特性允许为租户附加任意Key-Value对并支持父子继承。标签不参与业务逻辑但可被流程引擎、权限中心、审计服务读取。# 使用CLI为集团总部打标表示其为策略制定者 ./tenant-admin-cli tag set \ --tenant-code group_headquarters \ --key governance.role \ --value POLICY_OWNER # 为深圳工厂打标表示其为执行者且需法务审核 ./tenant-admin-cli tag set \ --tenant-code sz_factory \ --key procurement.require_legal_review \ --value true # 为上海研发中心打标表示其技术岗晋升需集团终审 ./tenant-admin-cli tag set \ --tenant-code sh_rnd \ --key hr.promotion.require_cto_approval \ --value true逻辑说明标签存储在pointlion_meta.tenant_tag表结构为(tenant_code, tag_key, tag_value, inherited_from)。当深圳工厂员工发起采购流程时流程引擎会自动读取其procurement.require_legal_review标签值若为true则在流程定义中动态插入“集团法务审核”节点。该节点不写死在流程图中而是由策略引擎实时注入实现规则与流程解耦。6.2 在流程中引用标签编写动态节点注入规则点狮OA的流程引擎支持Groovy脚本扩展。在流程设计器的“全局流程”中可为任意网关节点添加脚本根据租户标签决定是否插入审批节点。// 在“采购申请”节点后的网关中添加以下Groovy脚本 def tenantCode execution.getVariable(applicant.tenantCode) def tagService ApplicationContextUtil.getBean(tenantTagService) def requireLegal tagService.getTagValue(tenantCode, procurement.require_legal_review) if (true.equals(requireLegal)) { // 动态注入集团法务审核节点 execution.setVariable(inject_legal_node, true) return need_legal_review } else { return no_legal_review }参数说明ApplicationContextUtil.getBean是点狮OA封装的Spring上下文工具类确保在流程执行时能安全获取服务实例。inject_legal_node是流程变量后续节点可通过${inject_legal_node}判断是否启用。此方式比在流程图中画一堆条件分支更清晰也避免了流程版本爆炸。6.3 建立标签治理看板用SQL快速审计全集团策略覆盖集团IT部门需定期检查各子公司标签配置是否合规。点狮OA未提供图形化看板但可通过一条SQL秒级生成审计报告。-- 生成采购流程法务审核覆盖报告 SELECT t.tenant_code, t.tenant_name, COALESCE(tt.tag_value, false) AS require_legal_review, CASE WHEN COALESCE(tt.tag_value, false) true THEN ✅ 已启用 ELSE ❌ 未启用需整改 END AS status FROM pointlion_meta.tenant_info t LEFT JOIN pointlion_meta.tenant_tag tt ON t.tenant_code tt.tenant_code AND tt.tag_key procurement.require_legal_review WHERE t.status ACTIVE ORDER BY status DESC;实战价值某次季度审计中我们用此SQL 10秒内发现3家子公司未配置procurement.require_legal_review标签立即通知其IT负责人补标。若依赖人工登录各租户后台检查预计耗时2小时以上。这就是基础设施级治理能力带来的效率跃迁。我坚持在每个新上线的集团客户项目中第一周必做三件事1用CLI批量打标2为所有高频流程编写标签注入脚本3将上述SQL固化为定时邮件报表。这套组合拳让集团CIO第一次在月度汇报中用一页PPT说清了“12家子公司采购风控策略执行率100%”。技术的价值从来不是炫技而是把模糊的管理要求变成可执行、可验证、可追溯的代码逻辑。希望帮到你。本文还有配套的精品资源点击获取