🚀 拒绝重复造轮子！我用 AI 辅助开发的企业级宿舍管理系统，正式开源

让繁杂的宿舍管理，变成可视化的数据服务。

很多企业的行政、HR 和 IT 负责人都面临同一个隐形黑洞：员工宿舍管理还停留在 Excel 时代。

入住撞车、床位超卖；月底水电费算到凌晨；员工离职了床位还没退；报修进度全靠微信群催…… 为了解决这些真实痛点，我主导设计并开发了一套企业级员工宿舍管理系统 KD-Home。

经过多轮架构打磨与安全审计，今天，它终于以 Apache-2.0 协议 正式开源。无论你是想直接部署使用、二次开发，还是研究企业级 PHP 架构，这个项目都能为你提供高完成度的参考。

🔗 仓库地址：https://gitee.com/thomasblog/kd-home（文末附直达链接）

📦 一、 为什么做这个项目？

传统宿舍管理系统的痛点非常集中，但市面上能真正落地的开源方案却很少。KD-Home 的定位很明确：不玩花哨概念，只做能直接投产的实用工具。

❌ 传统管理痛点 ✅ KD-Home 解决方案
房源状态滞后：Excel 更新不及时，多人操作易撞车 实时动态房源 + 数据库级 FOR UPDATE 行锁，彻底杜绝超卖
计费繁琐易错：人工算水/电/公摊/补贴，对账困难 智能计费引擎：按人天精准分摊 + 舍入消除，账单精确到分
数据孤岛严重：HR 系统改了，宿舍名单没动 无缝集成：内置北森 HR / 企业微信适配器，入离职自动联动
员工体验差：报修、查账单全靠线下沟通 移动端自助门户：扫码登录，报修/账单/调宿全流程在线化

⚙️ 二、 技术硬核：它凭什么敢直接上生产？

作为开发者，我深知“能跑”和“能上生产”是两回事。在架构设计上，KD-Home 严格遵循企业级标准：

🏗️ 1. 三端分离，职责清晰

基于 ThinkPHP 6.x 多应用模式，天然拆分为：

  • app/admin：后台管理（Session 认证，园区数据隔离）
  • app/index：员工前台（企业微信扫码登录，自助服务）
  • app/api：开放 API（JWT Bearer 认证，供 OA/门禁/财务对接）

🔒 2. 并发安全与事务保障

宿舍管理最怕“超卖”和“脏数据”。核心业务（入住/调宿/退宿）全部采用：

  • START TRANSACTION + SELECT ... FOR UPDATE 行级锁
  • 严格的事务回滚机制，异常自动释放床位/恢复房间容量
  • 操作全量记录 AdminLog，权责可追溯

💰 3. 复杂计费引擎（BillingLogic）

这不是简单的“定额收费”，而是支持真实企业福利场景的计费模型：

  • 按量计费：水/电/网，支持阶梯单价
  • 人天分摊：按实际入住区间自动计算 person-days，最后一人自动补齐舍入误差
  • 多级补贴：支持 全局 → 园区 → 房间 三级 fallback 策略

🛡️ 4. 安全与权限体系

  • 防越权：managedParkIds 数据边界控制，普通管理员只能看所属园区
  • 防攻击：登录失败锁定（IP+用户名维度）、Session 防固定攻击（regenerate）
  • Token 管理：JWT 签发 + Redis 黑名单吊销机制，支持强制踢人/下线

🤖 三、 关于 AI 辅助开发的真实思考

很多同行问：“用 AI 写的代码，靠谱吗？”

我的回答是：AI 不是“代写者”，而是“高级编译器 + 代码审查员”。

在这个项目中：

  • ✅ 我主导：业务架构设计、并发控制逻辑、计费模型、权限边界、安全策略
  • 🤖 AI 负责：Boilerplate 代码生成、语法规范检查、注释补充、安全漏洞扫描
  • 🎯 结果：开发周期缩短 70%，但代码质量反而更高。所有核心 Logic 均经过人工逐行审计，达到生产级标准。

技术工具在进化，但“解决什么问题”和“如何保证稳定性”永远由人决定。

🚀 四、 开箱即用，5 分钟跑起来

项目已补齐 .env.example 与完整部署文档，真正做到了下载即用：bash

git clone https://gitee.com/thomasblog/kd-home.git

# 2. 安装依赖
cd kd-home && composer install

# 3. 配置环境
cp .env.example .env
# 修改数据库、Redis、JWT_KEY 等配置

# 4. 导入数据库
mysql -u root -p your_db < database/install.sql

# 5. 启动（开发环境）
php think run
# 访问 http://localhost:8000/admin

📌 生产环境请配置 Nginx/Apache 伪静态，并务必开启 HTTPS 保护 JWT 传输安全。

🌍 五、 开源协议与未来规划

  • 协议：Apache-2.0（支持商用、可闭源二次开发，仅需保留版权声明）
  • 定位：基础功能永久开源，后续将采用 Open-Core 模式 迭代高级企业特性（多集团管理、财务对接、高级审计日志等）
  • 目标：正在冲刺 Gitee GVP（最有价值开源项目）

开源不是终点，而是起点。我承诺：

  1. 持续维护核心版本，及时修复 Issue
  2. 提供清晰的升级路径（upgrade_v1.x.sql）
  3. 欢迎提交 PR、Issue 或产品建议

📬 传送门 & 交流

如果你正在为企业寻找宿舍管理方案，或者想研究 ThinkPHP 企业级架构，欢迎 Star 支持 👇

🔗 Gitee 仓库：https://gitee.com/thomasblog/kd-home
📘 产品价值说明：PRODUCT.md
📖 部署文档：public/docs/部署文档.html

⭐ 如果这个项目对你有启发或实用价值，请点亮 Star。你的每一次支持，都是开源项目持续迭代的最大动力。