企业官网建设流程全解析

简介：大型协同办公系统源码整合了OA、HR、CRM三大核心模块，面向需要构建企业信息化管理平台的开发团队、系统集成商以及对Java/.NET等企业级开发感兴趣的进阶学习者。系统覆盖工作流、公文管理、任务与会议管理、考勤，以及员工信息、招聘、绩效、薪酬福利，再到客户、销售机会、服务与合同管理等完整业务链路。压缩包大小约38.19MB，内部文件总数与类型明细暂未在展示信息中列出，主要内容以源码工程文件、配置及说明文档为主。已有107人学习下载。借助源码可深入理解MVC分层架构下的模块解耦与数据流设计，掌握企业级权限控制、流程引擎和报表统计等难点实现，并能根据实际需求进行定制化二次开发，是提升企业级开发实战能力的有力参考。

1. 大型协同办公系统源码：OA+HR+CRM 三合一，先把它拆成三个项目来理解

如果你正在找一套能跑起来的 OA+HR+CRM 源码，第一件事是把“协同办公”这个虚词丢掉，把它当成三个系统合在一个仓库里理解：OA管流程审批，HR管人的全生命周期，CRM管客户和销售机会。这套源码就是典型的企业内部管理全家桶，适合两类人：一类是做 Java 或 .NET 课程设计、毕业设计，想要一套完整业务系统的学生；另一类是公司要搭内部管理工具，想基于现成源码做二次开发的程序员。它真正值钱的部分不是考勤打卡，而是审批工作流与业务数据的串联关系。别一上来想把每个模块都吃透，先跑通，再按住一条业务线往下钻。

2. 先认清系统边界：OA、HR、CRM 三个模块的分工与源码落点

2.1 OA 模块是整个系统的骨架，工作流才是核心

很多第一次接触这类源码的人，都把注意力放在考勤、公告这种“存在感强”的功能上。实际上 OA 模块里最有分析价值的，是工作流引擎。一个流程要跑通，至少涉及四部分：流程模板、流程实例、审批节点、审批记录。模板管“流程长什么样”，实例管“这一单走到哪”，节点管“当前该谁批”，记录管“谁在什么时候批过”。公文管理、请假审批、费用报销，本质都是给这四类数据喂记录。

工作流在源码里常见的落点，是workflow、flow或oa这类包。我拆过类似项目，典型表有wf_process_define、wf_process_instance、wf_node、wf_approval_record。看到这几张表，基本就能画出业务闭环。会议管理也别小看，它不是一个简单日历，而是会议室资源、参会人、会议纪要三张表在联动，适合用来练手关联查询。

你可能听过泛微 OA、致远 OA、蓝凌 OA 这些商业产品，它们的底层思路都差不多：流程模板化、审批节点化、表单可配置。这套源码的价值，就是让你能看到这些商业系统背后的通用逻辑，并且能自己改。商业产品改一条审批流要提工单，源码项目里你直接改数据库记录或 Java 代码，差别很大。

2.2 HR 与 CRM 模块的价值在状态流转，不在增删改查

HR 模块里，员工信息管理是最基础的，招聘、绩效、培训才见真功夫。招聘管理不是存简历，而是维护一个候选人状态机：待筛选、面试中、待录用、已入职、已淘汰。状态之间靠流程或手工动作切换，每次切换都要留记录，否则后面统计招聘漏斗就无从谈起。绩效考核的实质，是一个周期管理：先有考核计划，再有指标，最后有评分结果。薪酬模块再基于这些结果计算，这就把人事和薪酬串起来了。

CRM 模块同理。客户表本身只是身份证级别的静态数据，真正决定系统价值的是销售机会表。机会表里最重要的字段是stage，从线索到成交划分好几个阶段。销售漏斗的统计 SQL，跑的就是这个字段。合同管理则要维护合同与机会的关联，用opportunity_id直接指向机会表，而不是靠客户名模糊匹配。

很多人在 CRM 上有一个巨大误区：以为客户管理就是通讯录。实际上免费 CRM 和自建系统的核心差别，恰恰在销售机会的阶段自定义和数据权限控制上。自建系统的阶段字段可以按公司流程改，不绑定厂商逻辑；商业免费 CRM 大多只能在你固定的几个阶段里打转。如果你想搞清楚“免费 CRM 与私人网站/自建系统的区别到底在哪”，读一套这类源码是最直接的答案。

2.3 先识别技术栈再动手：看包、看配置、看 SQL

下载源码后最怕的事是：环境装了一晚上，最后发现技术栈不匹配。所以我拿到包的第一时间，不看代码，先做技术栈识别。如果根目录有pom.xml，是 Maven 管理的 Java 项目，绝大多数是 Spring MVC 或 Spring Boot；如果有一堆.csproj或.sln，是 .NET；如果有package.json且没有 Java 后端目录，那可能是前后端分离的前端工程。老式 JSP 项目则通常能看到WebContent或web目录。

再看数据库脚本。MySQL 脚本大量用反引号包表名，Oracle 脚本会有SEQUENCE和TRIGGER，SQL Server 脚本则常见IDENTITY关键字。配置文件里，com.mysql.jdbc.Driver和oracle.jdbc.OracleDriver一眼就能区分。这一步做扎实，后面启动少走一半弯路。

三个模块的源码落点，通常有规律可循：

这个表不是标准答案，但对照着找，方向不会错。拿到压缩包后，我建议先在 IDE 里按包名把所有 Controller 类列出来，一个模块对应一组 Controller，比对着文档猜快得多。

3. 从下载到跑通：初始化数据库、改连接串与两种启动姿势

3.1 解压之后先做四件事，别急着双击

这一步很多人跳过去直接 IDE 打开，结果卡在各种小问题上。我拿到此类压缩包的标准动作是：第一，解压到无中文无空格的路径；第二，在根目录找README、install.txt、doc；第三，把项目里所有*.sql文件列出来；第四，打开配置文件看数据库类型。路径带空格看似无关痛痒，但对老项目的 Tomcat 脚本和某些框架的资源加载来说，就是隐患。中文路径更危险，容易触发编码问题。

mkdir -p /opt/oa && unzip "大型协同办公系统源码（OA+HR+CRM）源码 (1).zip" -d /opt/oa/ find /opt/oa -maxdepth 2 -type f | head -60 find /opt/oa -name "*.sql" -o -name "application.yml" -o -name "*.properties" -o -name "web.xml" | sort

这段命令里，压缩包文件名我加了引号，防止括号被 Shell 解释成特殊符号。maxdepth 2限制扫描深度，避免把依赖包全部列出来，前 60 行足够看清项目轮廓。第二次find把数据库脚本和配置挑出来，判断这套源码是哪个年代的产物。如果看到web.xml，大概率是传统 Servlet 项目；只看到application.yml，则是 Spring Boot。

接下来优先读 SQL 文件头部注释。很多源码作者习惯在脚本开头写“先建库、再导表、后导数据”的顺序。如果只有一个full.sql，就直接整文件导入；如果拆成schema.sql和data.sql，顺序不要反。表结构没建好就导数据，外键会报错；先导数据再建表，数据会被清空。这都是老生常谈的翻车点。

3.2 建库建用户，字符集尽量一次到位

老 OA 很多默认utf8，但业务数据里会出现生僻字、表情符号，utf8mb4更稳。我一般这样建库：

CREATE DATABASE IF NOT EXISTS oa_hr_crm DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE USER IF NOT EXISTS 'oa_user'@'localhost' IDENTIFIED BY 'Oa@2024'; GRANT ALL PRIVILEGES ON oa_hr_crm.* TO 'oa_user'@'localhost'; FLUSH PRIVILEGES;

然后导入脚本：

mysql -u root -p oa_hr_crm < schema.sql mysql -u root -p oa_hr_crm < data.sql

这里有个很实用的小习惯：导入完成后执行SHOW TABLES;，数一下表数量。比如这套系统包含 OA、HR、CRM 三大模块，表数量通常在七十到上百张。记下这个数字，后面启动成功再核对一次，能快速判断是不是某张关键表没导进来。如果 MySQL 8 环境导入老脚本报错，多半是字符集排序规则或utf8写法问题，把utf8_unicode_ci统一改成utf8mb4_general_ci基本能过。

如果项目用的是 Oracle 或 SQL Server，思路也一样，只是连接串写法不同。Oracle 要写成jdbc:oracle:thin:@127.0.0.1:1521:orcl，SQL Server 是jdbc:sqlserver://127.0.0.1:1433;DatabaseName=oa_hr_crm。老源码如果带.sql脚本，一般会按目标数据库给出多套，别导错版本。

3.3 配置连接串、端口和上下文路径

连接配置因框架而异。Spring Boot 看application.yml，老项目看jdbc.properties、db.properties或context.xml。重点改三项：URL、用户名、密码。下面是一份典型配置：

server: port: 8080 servlet: context-path: /oa spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/oa_hr_crm?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true username: oa_user password: Oa@2024

driver-class-name要跟 MySQL 版本对齐：5.x 用com.mysql.jdbc.Driver，8.x 用com.mysql.cj.jdbc.Driver。URL 里的serverTimezone=Asia/Shanghai必须写，否则 JDBC 8 驱动启动就报时区错误。127.0.0.1比localhost稳，避免某些环境的 IPv6 解析问题。context-path: /oa意味着登录地址是http://localhost:8080/oa/login，很多人在这里被坑，以为直接访问 8080 就行，结果 404。

另外，JDK 版本也是重灾区。老源码很多基于 JDK 8 写的，你拿 JDK 17 去编译，大概率会遇到javax.servlet和jakarta.servlet的包名切换问题，或者依赖版本不兼容。我一般直接用 JDK 8 + Tomcat 9 组合跑这类资源，等跑通了再考虑升级。

启动方式取决于项目形态。Maven 多模块项目先编译再运行：

mvn clean package -DskipTests java -jar target/oa-*.jar

老式 war 包则放进 Tomcat 的 webapps 目录后启动：

cp target/oa.war /opt/apache-tomcat-9.0/webapps/ /opt/apache-tomcat-9.0/bin/startup.sh

两种方式的区别是，war 包方式还要注意 Tomcat 版本。老源码基于javax.servlet的，用 Tomcat 9；新项目用jakarta.servlet的，才上 Tomcat 10/11。搞反了你会看到大批ClassNotFoundException。启动前先lsof -i:8080或 Windows 下netstat -ano | findstr 8080确认端口没被占，日志出现Started或Server startup in才算跑起来。

4. 三大模块的核心实现：审批工作流、招聘状态机与销售机会推进

4.1 审批工作流：用节点表把流程变成可配置

工作流是 OA 的灵魂，也是这套源码里最值得读的部分。我拆过的同类型项目，工作流实现通常不是复杂的状态机引擎，而是“节点表 + 实例表 + 记录表”的组合。节点表里每个节点声明自己的审批方式和下一跳：

public class ProcessNode { private String nodeId; // 节点编码，如 apply、dept_leader、hr_confirm private String nodeName; // 节点名称，用于审批页展示 private String approverType; // 固定用户 FIXED_USER / 角色 ROLE / 发起人主管 LEADER private String passType; // 通过方式：all 会签，any 或签 private Integer sortNo; // 节点顺序 private String nextNodeId; // 审批通过后流向 }

这段类的价值在于，流程模板可以通过配置组装，而不需要写死在 Java 代码里。要增加一个总监审批节点，就往节点表插一条记录，把上一节点的nextNodeId改成新节点编码即可。会签all要求所有审批人同意，或签any一人同意就放行，这两个字段决定了审批的通过语义。很多 OA 产品里的“会签/非会签”设置，底层就是这样一个字段。

流程实例表通常还要记录当前节点，每次审批通过后，把current_node_id更新为下一个节点。这一步如果用乐观锁实现，就能避免两个人同时审批导致的状态错乱。读源码时我建议用一条“请假审批”把整个调用链跟一遍：发起→生成实例→查当前节点→写审批记录→更新节点。跑通这条链，OA 模块就懂了大半。

4.2 HR 模块：用周期管理把招聘和绩效串起来

招聘管理设计的核心是候选人状态，不是简历附件。候选人从投递到入职，会经历多个状态，每次状态变化都要留下操作人和时间，否则统计招聘渠道转化率时没有任何可信度。我用一个简化字段表来说明：

CREATE TABLE hr_recruit_candidate ( id INT PRIMARY KEY AUTO_INCREMENT, position_id INT NOT NULL COMMENT '应聘职位', channel VARCHAR(20) COMMENT '渠道：BOSS/LIEBAO/猎头/内推', status VARCHAR(20) NOT NULL COMMENT 'PENDING/INTERVIEW/OFFER/HIRED/REJECTED', resume_uri VARCHAR(255), create_time DATETIME DEFAULT CURRENT_TIMESTAMP );

position_id把候选人和招聘职位关联，status控制筛选列表，channel用于统计渠道质量。很多课程设计项目会漏掉channel，导致后面完全无法分析哪个渠道有效。绩效模块同理，核心是hr_performance_plan表，定义考核周期为月、季度还是年度。薪酬计算时按plan_id去取考核结果，而不是直接对着一张打分表求和，这样才能支撑跨周期的薪酬追溯。

HR 模块还有个容易忽略的点：员工离职不是删除记录。正规做法是在员工表加status字段，离职员工保留历史数据，同时禁止登录。很多源码在这一点上处理得很草率，离职就直接DELETE，结果工资历史、审批历史全断了。你读到这类逻辑时，可以把它当作一个改进点记下来。

4.3 CRM 模块：销售机会阶段推进与数据权限

CRM 模块里最值得学的，是销售机会阶段的推进逻辑和跟进人数据权限。先看表结构：

CREATE TABLE crm_opportunity ( id INT PRIMARY KEY AUTO_INCREMENT, customer_id INT NOT NULL, owner_user_id INT NOT NULL COMMENT '跟进人', stage VARCHAR(20) NOT NULL COMMENT 'LEAD/TALK/QUOTE/WON/LOST', amount DECIMAL(12,2) DEFAULT 0, expect_close_date DATE, must_check TINYINT DEFAULT 0 COMMENT '阶段变更是否需审批，1是' );

销售漏斗的统计就是按stage分组，对amount求和。跟进人字段owner_user_id极其关键，它天然实现了“我只看到我负责的客户”这一数据权限。如果系统还要支持上级看下属数据，通常在 Service 层再加一层查询条件，用dept_id去过滤。很多新人在 CRM 里反复改页面，却不动owner_user_id，结果一个销售能看到全公司的客户，这属于典型的权限漏洞。

合同表与机会表的关联，建议用opportunity_id直接外键，而不是靠客户 ID 或合同名称。这样在列表页显示“所属商机”时就无需再对比字符串。阶段变更最好同步写日志表，记录从哪个阶段到哪个阶段、谁改的、为什么改。CRM 的价值就在这些留痕数据里，没有留痕，后面所有销售复盘都是空谈。

5. 避坑与排查：五条实测踩坑记录

5.1 ClassNotFoundException 与数据库连接拒绝

现象：Tomcat 启动后项目访问报ClassNotFoundException；或后台日志抛Communications link failure。

原因：前者多为缺依赖 jar，后者是数据库连不上。连不上的细根因，常见于 JDBC 驱动版本与 MySQL 版本不匹配，或者 URL 里没写时区。localhost解析成 IPv6 时，数据库监听了 IPv4 地址，同样会拒绝。

解决：连接 URL 统一写成jdbc:mysql://127.0.0.1:3306/oa_hr_crm?useSSL=false&serverTimezone=Asia/Shanghai。缺类时在 Maven 项目里检查pom.xml引用的驱动版本；传统项目查看WEB-INF/lib下有没有对应 jar。真机排错顺序是：先 ping 目标端口，再用命令行客户端连一次，最后才怀疑代码。

5.2 登录页白屏或 404

现象：项目能启动，但访问登录页 404；或页面出来了，静态资源全是 404。

原因：上下文路径不一致。Spring Boot 配置了context-path: /oa，访问时却没带应用名；传统 Tomcat 部署又习惯把 war 解压到 ROOT 下。静态资源 404 则是 Spring MVC 没配置资源映射，老框架默认不处理/static/**。

解决：启动成功后先看日志里 context path 是什么，按它拼 URL。静态资源 404 就在 Spring 配置里加ResourceHandler，把/static/**映射到classpath:/static/。我自己的固定动作是启动后直接访问http://localhost:8080/oa/login.jsp或/oa/login，确认第一个 HTTP 状态码，再顺着往下查。

5.3 中文乱码，改了数据库还乱

现象：页面显示正常，存入数据库是问号；或页面乱码，数据库正常。

原因：Tomcat URI 编码、请求过滤器编码、JDBC 连接字符集、数据库表字符集，四个环节只要有一个不一致就会乱。老 JSP 项目尤其常见pageEncoding和contentType不一致的问题。

解决：一次性把链路齐活：Tomcat 的 Connector 加URIEncoding="UTF-8"；Spring Boot 设置server.servlet.encoding.force=true；JDBC URL 带characterEncoding=utf8；数据库字符集确认是utf8mb4。检查时用SHOW VARIABLES LIKE 'character_set%'看结果，不要凭猜。从那以后但凡遇到乱码，我先跑这条检查链，不再单独折腾数据库。

5.4 日期时间差 8 小时

现象：页面上显示的日期比实际少 8 小时，或后台存储比实际多 8 小时。

原因：JVM 时区、数据库时区、JDBC 驱动时区三处不统一。老代码用new Date()写入datetime字段时，驱动可能按 UTC 转换；读取时又按系统时区转换，来回一折腾就偏了。

解决：统一到 UTC+8。Linux 执行timedatectl set-timezone Asia/Shanghai；Java 启动参数加-Duser.timezone=Asia/Shanghai；SQL 连接串带serverTimezone=Asia/Shanghai；MySQL 会话执行SET time_zone = '+08:00'。注意datetime与timestamp的行为不同，前者不随会话时区转换，后者会，排查时先确认字段类型再动手。

5.5 审批流程卡住不流转

现象：审批人点了同意，单据仍在当前节点，或直接消失无反馈。

原因：我遇到的三类最多：下一节点审批人解析为空，比如按部门主管找人但部门主管没配置；并行分支没有合并机制，某个分支走到头就误判完成；字段版本号没更新，更新影响 0 行导致事务回滚但页面提示成功。

解决：先查审批记录表，有没有新写入的审批动作。如果没有，说明保存阶段就异常，去看后台日志；如果有，再去流程实例表比对current_node_id。想要精确定位，可以自己写一条条件更新语句，update wf_process_instance set current_node_id = #{next} where id = #{id} and current_node_id = #{current}，影响行数为 0 就说明当前节点的旧值和你以为的不一致。把工作流日志调到 DEBUG，节点转移的逐行日志会直接告诉你卡点。

6. 二次开发落地：新增一条审批流并验证改动的四步法

想判断自己是不是真的读懂了这套源码，用最小改动验证最有效。我每次拿到新系统，都挑“新增一条请假审批流”来做，因为这条业务线能覆盖流程模板、菜单权限、发起表单和节点推进四个基本点。

第一步，往流程模板表插入一条模板，节点按“提交申请→部门主管审批→HR复核→结束”设定，审批人类型分别对应发起人本人、直属主管、HR 角色。以实际库中模板表字段为准，常见写法是：

INSERT INTO wf_process_template (template_key, template_name, first_node_id) VALUES ('leave_simple', '简易请假流程', 'apply_node');

template_key是流程编码，first_node_id指向起始节点编码。第二步，加菜单入口，表单字段只留开始时间、结束时间、事由。第三步，给 Controller 或 Action 写一个 submit 方法，调用工作流引擎发起接口，创建流程实例并把当前节点置为apply_node。第四步，也是最容易漏的：清理权限。菜单权限、按钮权限、数据权限三处都要给对应角色授权，否则流程起了，审批人却看不到待办。

每完成一步，用一条真实请假单走验证：提交后看实例表current_node_id是否为dept_leader；换非主管账号登录是否无待办；主管同意后节点是否跳到hr_confirm。三句话能答上来，说明这条链路真的通了，而不是页面看着能点。动手前我还会强制做两件事：备份数据库，保存 SQL 基线；把这次改动涉及的表和字段写进改动记录。因为二次开发最大的翻车现场，不是代码写不出来，而是改崩了还不知道该回退到哪。

从那以后，我每拆一套新源码，第一天就写一份《环境清单》：数据库版本、Java/Tomcat 版本、配置文件改过的每一行、启动命令是什么，改动前导一次基线。这套 OA+HR+CRM 源码模块多、表关联绕，但把这条最小闭环走通，后面接手任何模块都不慌。希望帮到你。

本文还有配套的精品资源，点击获取