物业管理系统产品系统

背景与目标：传统物业依赖线下收费、纸质报修、人工登记，收缴率低、过程无留痕、财务难对账。本系统以「PC 管理后台 + 微信小程序」双端替代线下模式，服务住宅业主、商铺租户和客服/工程/保洁/管理员等岗位。目标六条：线上收缴物业费、停车费、充电费、水电公摊、商铺租金；工单全流程闭环可追溯；园区通行数字化；合同物资供应商内部数字化；搭建小区私域社区；数据与资金自主（微信直清物业商户号，平台不截留）。边界上不做资金池、不做硬件控制、不做担保交易、不含财务 ERP。

一套系统服务多小区，按 project_id 行级隔离，通过模块开关与配置实现「同一套前端代码、不同小区呈现不同功能组合」。
功能全景（十个域）：基础平台（登录鉴权、RBAC、数据范围、字典、配置、消息中心）；主数据（楼栋房屋与绑定审核、商铺与承租人，住宅商铺完全隔离）；收费（计费规则、统一账单模型、物业费水电计费引擎、租金合同押金、停车阶梯计费与月卡、充电峰平谷与套餐、微信支付与电子收据、线下收款/减免/退款/对账/欠费）；工单（统一模型承载报修、投诉、装修、保洁、巡检、大修，含超时预警与评价）；通行（访客、门禁记录、装修报备）；资产（物资库存领用、供应商、合同总台账）；社区（公告、活动投票、邻里圈、二手租售、家政）；增值可选（宠物、消杀、水箱、车位台账、快递，默认关闭）；平台能力（第三方对接、报表中心、总部多小区视图与资料下发、安全审计备份降级）。
核心业务流程：①登录——微信 code 换 openid，未绑手机强制绑定，聚合业主/租户/员工多身份切换，签发含 userType+projectId 的 JWT 并写 Redis 会话；②房屋绑定——提交申请后按配置走人工审核或房号+手机号自动校验，通过后建立用户-房屋关系，主业主可邀请家人；③账单生成——Redis 分布式锁挡重

生产方式：规范先行 + 任务卡驱动。一份全局提示词锁死技术栈、表结构公共字段、支付与鉴权纪律，硬性约束包括「只允许新增 Flyway 迁移不得修改前置」「前端必须基于 OpenAPI 契约不得臆造接口」「不得跨模块访问他模块 Mapper」「不得实现未声明模块」，每卡按依赖检查→影响分析→DDL→OpenAPI→后端类→前端页面→测试点顺序产出，完成后回写 PROJECT_CONTEXT.md 作为跨任务共享记忆。
架构：Maven 12 子模块。common 放统一响应/异常/错误码/RedisKey 规范；auth 放 JWT、会话、过滤器、@RequirePerm 与审计切面、DataScopeHelper，并承载绝大部分 Controller——这是为打破循环依赖固化的架构约束（业务模块需依赖 auth，Controller 若放回业务模块即成环）；业务模块 system/billing/community/workorder/asset/report/integration 只留 Entity/Mapper/Service，community 与 billing 最重；顶层 admin-api 与 miniapp-api 为纯聚合启动层，分别监听 8080/8081、Redis 分库 0/1，实现流量与故障域隔离。数据层单库共享表 + project_id 行级隔离。
贯穿原则：配置化优先（规则、菜单、模板、阈值全落 sys_config/dict/module 开关与 rule_config JSON）；硬件双模式；权限按小区→模块→角色→数据范围逐层收敛；金额统一分存储；编号统一 Redis INCR 加唯一索引；状态流转集中为状态机组件。
技术栈：JDK 17、Spring Boot 3.2.5、MyBatis-Plus 3.5.5、Druid、MySQL