# 9-社区物业管理系统 - 功能说明
# 项目概述
面向社区业主、物业人员与维修人员的物业服务系统，提供楼栋、报修、投诉、物业费用、车位租赁、停车费用和社区资讯管理，业主通过个人中心查看办理进度与费用记录。
# 项目概览
# 创新点
- 维修分工明确：物业负责协调，维修人员通过工单入口处理维修任务。
- 停车业务独立：车位、租赁与停车费分表管理，与物业费及缴费记录共同构成收费业务。
- 服务进度集中查询：个人中心集中展示报修、投诉、物业费和停车信息。
# 项目亮点
- 角色分工：提供管理员、物业人员、维修人员、业主等业务入口。
- 业务数据组织：主初始化脚本包含 16 张表，围绕该系统的核心对象与业务记录建模。
- 前后端分离：前端负责页面交互，后端通过控制器、服务与数据映射层提供接口。
- 操作体验：提供列表查询、表单编辑、状态展示及个人资料维护入口。
# 管理员
# 人员与楼栋
维护业主、物业人员、维修人员、管理员及楼栋资料。
# 物业服务
管理报修工单和投诉建议。
# 收费停车
管理物业费、缴费记录、车位、车位租赁及停车费。
# 资讯内容
维护公告、新闻、评论和轮播图。
# 物业人员
# 报修处理
查看报修工单，分配和维护维修处理信息。
# 投诉处理
查看投诉建议并填写处理回复。
# 费用停车
维护物业费用、缴费记录及停车相关业务。
# 维修人员
# 维修工单
进入报修管理，查看和处理维修任务，维护处理进度。
# 业主
# 社区资讯
浏览公告与新闻，查看详情并参与新闻评论。
# 报修服务
填写报修类型、描述、图片和联系方式，跟踪工单并评价。
# 投诉建议
提交投诉或建议，查询回复和处理结果。
# 物业缴费
查看本人物业费和缴费状态，发起缴费。
# 停车服务
查看个人车位租赁及停车费记录，处理停车缴费。
# 账户中心
维护个人资料与密码，使用余额相关页面。
# 功能权限对照表
下表说明当前菜单与业务入口分工。“—”表示未列为该角色的常规入口；不代表已对每个接口完成权限安全审计。
| 功能模块 | 管理员 | 物业人员 | 维修人员 | 业主 |
|---|---|---|---|---|
| 人员、楼栋及资讯 | 管理 | — | — | 浏览资讯 |
| 报修工单 | 管理 | 协调处理 | 维修处理 | 提交查询评价 |
| 投诉建议 | 管理 | 处理 | — | 提交查询 |
| 物业费与缴费记录 | 管理 | 维护 | — | 查询缴费 |
| 车位、租赁及停车费 | 管理 | 维护 | — | 个人查询缴费 |
# 业务状态说明
- 报修前台展示：待分配、已分配、处理中、已完成、已评价。
- 投诉后台选项：待处理、已处理。
- 物业费与停车费后台选项：未缴费、已缴费。
# 默认账号
以下为主初始化 SQL 中能够核实的示例账号；需先导入对应脚本。这里不把脚本初始值视为当前运行数据库的实际账号或余额。
| 登录角色 | 角色标识 | 用户名 | 初始密码 |
|---|---|---|---|
| 管理员 | ADMIN | admin | 123456 |
| 物业人员 | STAFF | staff | 123456 |
| 维修人员 | WORKER | worker | 123456 |
| 业主 | USER | user | 123456 |
# 核心业务流程
# 报修处理
- 业主提交报修。
- 物业查看并分配维修人员。
- 维修人员处理。
- 更新完成信息。
- 业主查看与评价。
# 物业缴费
- 后台维护费用记录。
- 业主查询本人账单。
- 调用缴费入口。
- 查看支付状态与缴费记录。
# 停车缴费
- 维护车位和租赁资料。
- 生成或维护停车费记录。
- 业主查看费用。
- 提交缴费。
# 技术说明
# 系统架构
| 项目 | 当前源码配置 |
|---|---|
| Vue | ^3.4.29 |
| Element Plus | ^2.8.4 |
| Pinia | ^2.2.2 |
| Axios | ^1.7.5 |
| Vite | ^5.3.1 |
| Spring Boot | 3.2.10 |
| Java | 17 |
| MyBatis 集成组件 | 3.0.4 |
| 数据库 | MySQL；具体运行版本以实际部署为准 |
| 身份认证 | JWT；通过登录接口生成令牌 |
前端版本按 package.json 中的声明范围记录，不将依赖范围等同于已安装的精确版本。
# 访问地址
- 后端接口：http://localhost:1000 (opens new window)，对应服务端端口配置。
- 前端开发页面：http://localhost:5173 (opens new window)，项目未显式覆盖 Vite 默认端口，实际以启动日志为准。
- 登录入口：前端
/login；管理端基础路由/admin。
# 数据库
- 配置数据库名：
a_2026_9_community_system。 - 主初始化脚本：
sql/sql.sql。 - 主脚本建表数量：16 张，仅统计当前主脚本的 CREATE TABLE，不包含临时 SQL、迁移脚本或运行时改动。
- 字符集：主脚本采用 utf8mb4。
- 数据表清单：
admin、banner、building、comment、complaint、news、notice、parking_fee、parking_rental、parking_space、payment_record、property_fee、repair_order、staff、user、worker。
# 文件上传
- 上传接口：
POST /file/upload。 - 文件访问：
GET /file/{fileName}。 - 配置限制：单文件 100MB，单次请求 1000MB。
- 使用范围：根据业务页面上传图片或附件；具体允许类型以对应上传组件配置为准。
# 系统特色
# 维修分工明确
物业负责协调，维修人员通过工单入口处理维修任务。
# 停车业务独立
车位、租赁与停车费分表管理，与物业费及缴费记录共同构成收费业务。
# 服务进度集中查询
个人中心集中展示报修、投诉、物业费和停车信息。
# 当前实现说明
- 报修后台仍有“待处理、已处理”等选项，前台采用分配和评价状态；费用前台还出现“待缴费、已逾期”，与后台名称存在差异。
- 未发现原文中的独立房屋管理、访客登记、社区活动报名、社区论坛模块；实际内容模块为新闻及评论。
- 没有据静态源码确认定时自动生成账单或主动欠费提醒，相关内容不作为已实现功能。
本次按本地源码进行静态核对，未启动前后端或连接数据库执行端到端验证；上述说明反映当前代码与页面定义。