SHUXINGVIP-综合物业管理系统 API

商铺租赁 · 合同管理 · 费用收缴 · 数据报表 · 住宅小区 · 基于 Laravel 11 + Sanctum Token 认证

Base URL: https://pm.shuxing.vip/api
🚀 快速入门
1. 获取 Token
POST /api/auth/login
Content-Type: application/json

{"email": "774490@qq.com", "password": "123456"}

→ {"code":200,"data":{"token":"1|xxx...","user":{...}}}
2. 使用 Token
GET /api/health
Authorization: Bearer 1|xxx...
3. 公共参数
✅ 分页参数：?page=1&per_page=15
✅ 搜索参数：?keyword=xxx&status=1
✅ 响应格式：{"code":200,"message":"success","data":{...}}
💚 健康检查 1 个接口
GET /api/api/health 服务健康检查（PHP版本/磁盘/状态）
🔐 认证管理 6 个接口
POST /api/auth/login ⏱ 10次/分钟 用户登录
请求示例
{"email":"admin@pm.shuxing.vip","password":"admin123"}
响应示例
{"code":200,"data":{"token":"1|xxx","user":{...}}}
POST /api/auth/register ⏱ 5次/分钟 用户注册
POST /api/auth/logout 🔒 需登录 退出登录
GET /api/auth/user 🔒 需登录 获取当前用户信息
PUT /api/auth/profile 🔒 需登录 更新个人资料
PUT /api/auth/password 🔒 需登录 修改密码
🏢 🏢 楼栋管理（商铺） 5 个接口
GET /api/buildings 🔒 需登录📦 multi_building 楼栋列表（分页）
POST /api/buildings 🔒 需登录📦 multi_building 新建楼栋
GET /api/buildings/{id} 🔒 需登录 楼栋详情（含商铺列表）
PUT /api/buildings/{id} 🔒 需登录 更新楼栋
DELETE /api/buildings/{id} 🔒 需登录 删除楼栋
🏪 🏪 商铺管理 8 个接口
GET /api/shops 🔒 需登录📦 shop_management 商铺列表（分页+搜索）
POST /api/shops 🔒 需登录 新增商铺
GET /api/shops/{id} 🔒 需登录 商铺详情
PUT /api/shops/{id} 🔒 需登录 更新商铺
DELETE /api/shops/{id} 🔒 需登录 删除商铺
POST /api/shops/import 🔒 需登录 Excel批量导入商铺
GET /api/shops/statistics 🔒 需登录 商铺统计
GET /api/shops/buildings 🔒 需登录 楼栋下拉列表
📄 📄 合同管理 16 个接口
GET /api/contracts 🔒 需登录📦 simple_contract 合同列表（分页+搜索）
POST /api/contracts 🔒 需登录 新建合同（含递增/免租）
GET /api/contracts/expiring 🔒 需登录 即将到期合同
GET /api/contracts/{id} 🔒 需登录 合同详情
PUT /api/contracts/{id} 🔒 需登录 更新合同
PUT /api/contracts/{id}/activate 🔒 需登录 激活合同（自动生成账单）
POST /api/contracts/{id}/terminate 🔒 需登录 终止合同
POST /api/contracts/{id}/renew 🔒 需登录 续租合同
DELETE /api/contracts/{id} 🔒 需登录 删除合同
GET /api/contracts/{id}/print 🔒 需登录 合同打印（HTML页面）
GET /api/contracts/{id}/settle 🔒 需登录 退租结算信息
POST /api/contracts/{id}/execute-settle 🔒 需登录 执行退租结算
GET /api/contracts/{id}/settle-report 🔒 需登录 结算报告
POST /api/contracts/batch-activate 🔒 需登录 批量激活合同
POST /api/contracts/batch-terminate 🔒 需登录 批量终止合同
POST /api/contracts/batch-renew 🔒 需登录 批量续租合同
📋 📋 合同模板管理 8 个接口
GET /api/contract-templates 🔒 需登录📦 simple_contract 模板列表
POST /api/contract-templates 🔒 需登录 新建模板
GET /api/contract-templates/variables 🔒 需登录 可用变量列表
GET /api/contract-templates/{id} 🔒 需登录 模板详情
PUT /api/contract-templates/{id} 🔒 需登录 更新模板
DELETE /api/contract-templates/{id} 🔒 需登录 删除模板
POST /api/contract-templates/{id}/fill 🔒 需登录 填充模板生成合同
GET /api/contract-templates/{id}/pdf 🔒 需登录 导出模板PDF
🚪 🚪 退租/转租管理 9 个接口
GET /api/lease-terminations 🔒 需登录📦 simple_contract 退租申请列表
POST /api/lease-terminations 🔒 需登录 提交退租申请
GET /api/lease-terminations/{id} 🔒 需登录 退租申请详情
PUT /api/lease-terminations/{id} 🔒 需登录 更新退租申请
POST /api/lease-terminations/{id}/approve 🔒 需登录 审批通过
POST /api/lease-terminations/{id}/reject 🔒 需登录 审批驳回
POST /api/lease-terminations/{id}/settle 🔒 需登录 退租结算
POST /api/lease-terminations/{id}/complete 🔒 需登录 完成退租
DELETE /api/lease-terminations/{id} 🔒 需登录 删除退租申请
💰 💰 账单管理 12 个接口
GET /api/bills 🔒 需登录📦 rent_billing 账单列表（分页）
POST /api/bills 🔒 需登录 创建账单
GET /api/bills/statistics 🔒 需登录 账单统计
GET /api/bills/overdue 🔒 需登录 逾期账单
POST /api/bills/batch-pay 🔒 需登录 批量缴费
GET /api/bills/{id} 🔒 需登录 账单详情
PUT /api/bills/{id} 🔒 需登录 更新账单
POST /api/bills/{id}/pay 🔒 需登录 单笔缴费
POST /api/bills/{id}/recalculate-late-fee 🔒 需登录 重新计算滞纳金
PUT /api/bills/{id}/cancel 🔒 需登录 取消账单
POST /api/bills/calculate-public-share 🔒 需登录 计算公摊水电
POST /api/bills/generate-public-share 🔒 需登录 生成公摊水电账单
💳 💳 收款管理 7 个接口
GET /api/payments 🔒 需登录📦 payment_record 收款列表
POST /api/payments 🔒 需登录 新增收款（支持多种支付方式）
GET /api/payments/{id} 🔒 需登录 收款详情
GET /api/payments/{id}/print 🔒 需登录 打印收款单
GET /api/payments/{id}/receipt 🔒 需登录 打印收据
POST /api/payments/batch-receipt 🔒 需登录 批量打印收据
DELETE /api/payments/{id} 🔒 需登录 删除收款
🔒 🔒 押金管理 6 个接口
GET /api/deposits 🔒 需登录📦 payment_record 押金列表
POST /api/deposits 🔒 需登录 新增押金
GET /api/deposits/{id} 🔒 需登录 押金详情
POST /api/deposits/{id}/refund 🔒 需登录 押金退款
POST /api/deposits/{id}/deduct 🔒 需登录 押金扣款
POST /api/deposits/{id}/forfeit 🔒 需登录 押金没收
📄 📄 发票管理 6 个接口
GET /api/invoices 🔒 需登录📦 invoice_management 发票列表
POST /api/invoices 🔒 需登录 新增发票
GET /api/invoices/{id} 🔒 需登录 发票详情
PUT /api/invoices/{id} 🔒 需登录 更新发票
POST /api/invoices/{id}/verify 🔒 需登录 发票核验
POST /api/invoices/{id}/cancel 🔒 需登录 发票作废
💸 💸 支出管理 7 个接口
GET /api/expenses 🔒 需登录 支出列表
POST /api/expenses 🔒 需登录 新增支出
GET /api/expenses/summary 🔒 需登录 支出月度汇总
GET /api/expenses/categories 🔒 需登录 支出分类列表
GET /api/expenses/{id} 🔒 需登录 支出详情
PUT /api/expenses/{id} 🔒 需登录 更新支出
DELETE /api/expenses/{id} 🔒 需登录 删除支出
🔌 🔌 抄表管理（商铺） 8 个接口
GET /api/meter-readings 🔒 需登录📦 meter_reading 抄表列表
POST /api/meter-readings 🔒 需登录 新增抄表
POST /api/meter-readings/batch-generate-bills 🔒 需登录 批量生成水电账单
GET /api/meter-readings/latest/{shopId}/{meterType} 🔒 需登录 最新读数
GET /api/meter-readings/{id} 🔒 需登录 抄表详情
PUT /api/meter-readings/{id} 🔒 需登录 更新抄表
POST /api/meter-readings/{id}/generate-bill 🔒 需登录 单条生成账单
DELETE /api/meter-readings/{id} 🔒 需登录 删除抄表
⚡ ⚡ 水电费率配置 6 个接口
GET /api/utility-rates 🔒 需登录📦 meter_reading 费率列表
POST /api/utility-rates 🔒 需登录 新增费率
POST /api/utility-rates/calculate 🔒 需登录 计算费用
GET /api/utility-rates/{id} 🔒 需登录 费率详情
PUT /api/utility-rates/{id} 🔒 需登录 更新费率
DELETE /api/utility-rates/{id} 🔒 需登录 删除费率
🔧 🔧 维修工单 7 个接口
GET /api/maintenance 🔒 需登录📦 maintenance_order 工单列表
POST /api/maintenance 🔒 需登录 创建工单
GET /api/maintenance/{id} 🔒 需登录 工单详情
PUT /api/maintenance/{id} 🔒 需登录 更新工单
POST /api/maintenance/{id}/assign 🔒 需登录 派单
POST /api/maintenance/{id}/status 🔒 需登录 更新工单状态
POST /api/maintenance/{id}/rate 🔒 需登录 评价工单
🧹 🧹 保洁服务 11 个接口
GET /api/cleaning-orders 🔒 需登录📦 cleaning_service 保洁订单列表
POST /api/cleaning-orders 🔒 需登录 新增保洁订单
GET /api/cleaning-orders/{id} 🔒 需登录 订单详情
PUT /api/cleaning-orders/{id} 🔒 需登录 更新订单
POST /api/cleaning-orders/{id}/assign 🔒 需登录 指派保洁员
POST /api/cleaning-orders/{id}/start 🔒 需登录 开始保洁
POST /api/cleaning-orders/{id}/complete 🔒 需登录 完成保洁
POST /api/cleaning-orders/{id}/accept 🔒 需登录 验收通过
POST /api/cleaning-orders/{id}/rate 🔒 需登录 评价
POST /api/cleaning-orders/{id}/cancel 🔒 需登录 取消订单
DELETE /api/cleaning-orders/{id} 🔒 需登录 删除订单
🅿️ 🅿️ 停车场管理 19 个接口
GET /api/parking/spaces 🔒 需登录📦 parking_management 车位列表
POST /api/parking/spaces 🔒 需登录 新增车位
GET /api/parking/spaces/{id} 🔒 需登录 车位详情
PUT /api/parking/spaces/{id} 🔒 需登录 更新车位
DELETE /api/parking/spaces/{id} 🔒 需登录 删除车位
GET /api/parking/rates 🔒 需登录 费率列表
POST /api/parking/rates 🔒 需登录 新增费率
GET /api/parking/rates/{id} 🔒 需登录 费率详情
PUT /api/parking/rates/{id} 🔒 需登录 更新费率
DELETE /api/parking/rates/{id} 🔒 需登录 删除费率
GET /api/parking/month-cards 🔒 需登录 月卡列表
POST /api/parking/month-cards 🔒 需登录 新增月卡
DELETE /api/parking/month-cards/{id} 🔒 需登录 删除月卡
POST /api/parking/month-cards/{id}/renew 🔒 需登录 月卡续费
POST /api/parking/month-cards/{id}/cancel 🔒 需登录 月卡取消
POST /api/parking/entry 🔒 需登录 车辆入场
POST /api/parking/records/{id}/exit 🔒 需登录 车辆出场
GET /api/parking/records 🔒 需登录 收费记录
GET /api/parking/records/stats 🔒 需登录 收费统计
🔐 🔐 安保服务 19 个接口
GET /api/security/patrol-routes 🔒 需登录📦 security_service 巡更路线列表
POST /api/security/patrol-routes 🔒 需登录 新增巡更路线
GET /api/security/patrol-routes/{id} 🔒 需登录 路线详情
PUT /api/security/patrol-routes/{id} 🔒 需登录 更新路线
DELETE /api/security/patrol-routes/{id} 🔒 需登录 删除路线
GET /api/security/patrol-points 🔒 需登录 巡更点列表
POST /api/security/patrol-points 🔒 需登录 新增巡更点
PUT /api/security/patrol-points/{id} 🔒 需登录 更新巡更点
GET /api/security/patrol-records 🔒 需登录 巡更记录
POST /api/security/patrol-records/checkin 🔒 需登录 巡更签到
GET /api/security/patrol-records/stats 🔒 需登录 巡更统计
GET /api/security/incidents 🔒 需登录 安保事件列表
POST /api/security/incidents 🔒 需登录 上报事件
POST /api/security/incidents/{id}/assign 🔒 需登录 指派处理人
POST /api/security/incidents/{id}/resolve 🔒 需登录 处理完成
POST /api/security/incidents/{id}/review 🔒 需登录 审核事件
GET /api/security/guard-schedules 🔒 需登录 保安排班
POST /api/security/guard-schedules 🔒 需登录 新增排班
POST /api/security/guard-schedules/batch 🔒 需登录 批量排班
🔦 🔦 物业巡检 17 个接口
GET /api/inspection/plans 🔒 需登录📦 patrol_inspection 巡检计划列表
POST /api/inspection/plans 🔒 需登录 新增巡检计划
GET /api/inspection/plans/{id} 🔒 需登录 计划详情
PUT /api/inspection/plans/{id} 🔒 需登录 更新计划
DELETE /api/inspection/plans/{id} 🔒 需登录 删除计划
GET /api/inspection/tasks 🔒 需登录 巡检任务列表
POST /api/inspection/tasks 🔒 需登录 创建巡检任务
PUT /api/inspection/tasks/{id}/status 🔒 需登录 更新任务状态
POST /api/inspection/tasks/{id}/submit 🔒 需登录 提交巡检结果
GET /api/inspection/items 🔒 需登录 巡检项目列表
POST /api/inspection/items 🔒 需登录 新增巡检项目
GET /api/inspection/results 🔒 需登录 巡检结果
GET /api/inspection/rectifications 🔒 需登录 整改单列表
POST /api/inspection/rectifications 🔒 需登录 创建整改单
POST /api/inspection/rectifications/{id}/assign 🔒 需登录 指派整改
POST /api/inspection/rectifications/{id}/rectify 🔒 需登录 提交整改
POST /api/inspection/rectifications/{id}/review 🔒 需登录 审核整改
📢 📢 社区公告 10 个接口
GET /api/notices 🔒 需登录📦 community_notice 公告列表
POST /api/notices 🔒 需登录 发布公告
GET /api/notices/{id} 🔒 需登录 公告详情
PUT /api/notices/{id} 🔒 需登录 更新公告
DELETE /api/notices/{id} 🔒 需登录 删除公告
POST /api/notices/{id}/publish 🔒 需登录 发布
POST /api/notices/{id}/withdraw 🔒 需登录 撤回
GET /api/notices/{id}/read-stats 🔒 需登录 阅读统计
POST /api/notices/{id}/signup 🔒 需登录 活动报名
GET /api/notices/{id}/signups 🔒 需登录 报名列表
🔧 🔧 设备维保管理 18 个接口
GET /api/equipment 🔒 需登录📦 equipment_maintenance 设备列表
POST /api/equipment 🔒 需登录 新增设备
GET /api/equipment/{id} 🔒 需登录 设备详情
PUT /api/equipment/{id} 🔒 需登录 更新设备
POST /api/equipment/{id}/generate-qrcode 🔒 需登录 生成设备二维码
DELETE /api/equipment/{id} 🔒 需登录 删除设备
GET /api/equipment/maintenance-plans 🔒 需登录 维保计划列表
POST /api/equipment/maintenance-plans 🔒 需登录 新增维保计划
PUT /api/equipment/maintenance-plans/{id} 🔒 需登录 更新维保计划
DELETE /api/equipment/maintenance-plans/{id} 🔒 需登录 删除维保计划
GET /api/equipment/maintenance-records 🔒 需登录 维保记录列表
POST /api/equipment/maintenance-records 🔒 需登录 新增维保记录
GET /api/equipment/maintenance-records/{id} 🔒 需登录 维保记录详情
PUT /api/equipment/maintenance-records/{id} 🔒 需登录 更新维保记录
DELETE /api/equipment/maintenance-records/{id} 🔒 需登录 删除维保记录
GET /api/equipment/replacement-parts 🔒 需登录 备件库存
POST /api/equipment/replacement-parts 🔒 需登录 新增备件
DELETE /api/equipment/replacement-parts/{id} 🔒 需登录 删除备件
📊 📊 报表中心 8 个接口
GET /api/reports/dashboard 🔒 需登录 首页仪表盘
GET /api/reports/shops 🔒 需登录📦 basic_report 商铺统计报表
GET /api/reports/contracts 🔒 需登录 合同统计报表
GET /api/reports/finance 🔒 需登录 财务报表
GET /api/reports/monthly-revenue 🔒 需登录 月度营收趋势
GET /api/reports/tenant-ranking 🔒 需登录 租户欠费排名
GET /api/reports/revenue-summary 🔒 需登录 营收概要（本月/增长/待收）
GET /api/reports/occupancy-trend 🔒 需登录 出租率趋势（近4季度）
📥 📥 报表导出 5 个接口
GET /api/reports/export/occupancy 🔒 需登录📦 basic_report 导出出租率报表
GET /api/reports/export/revenue 🔒 需登录 导出营收报表
GET /api/reports/export/arrears 🔒 需登录 导出欠费报表
GET /api/reports/export/contracts-expiring 🔒 需登录 导出到期合同
GET /api/reports/export/income-expense 🔒 需登录 导出收支报表
📈 📈 财务驾驶舱 1 个接口
GET /api/finance/overview 🔒 需登录 财务总览（营收/支付/逾期/月度）
🔄 🔄 财务对账 7 个接口
GET /api/finance/reconciliation 🔒 需登录 对账概览
GET /api/finance/reconciliation/unmatched-bills 🔒 需登录 未匹配账单
GET /api/finance/reconciliation/daily 🔒 需登录 每日对账明细
POST /api/finance/reconciliation/run 🔒 需登录 执行对账
GET /api/finance/reconciliation/report 🔒 需登录 对账报告
POST /api/finance/reconciliation/{id}/confirm 🔒 需登录 确认对账
POST /api/finance/reconciliation/{id}/adjust 🔒 需登录 调整对账
📊 📊 财务分析（高级） 5 个接口
GET /api/finance/yoy-analysis 🔒 需登录📦 financial_analysis 同比分析
GET /api/finance/mom-analysis 🔒 需登录 环比分析
GET /api/finance/structure 🔒 需登录 收入结构分析
GET /api/finance/cashflow 🔒 需登录 现金流分析
GET /api/finance/kpi 🔒 需登录 关键KPI指标
🏠 🏠 Dashboard组件 2 个接口
GET /api/dashboard/quick-stats 🔒 需登录 今日快捷统计
GET /api/dashboard/recent-payments 🔒 需登录 最近收款记录
🔔 🔔 通知中心 13 个接口
GET /api/notifications 🔒 需登录 通知列表（筛选/分页）
GET /api/notifications/unread-count 🔒 需登录 未读通知数
PUT /api/notifications/read-all 🔒 需登录 全部标记已读
DELETE /api/notifications/clear-all 🔒 需登录 清空所有通知
DELETE /api/notifications/clear-read 🔒 需登录 清空已读通知
PUT /api/notifications/{id}/read 🔒 需登录 标记单条已读
DELETE /api/notifications/{id} 🔒 需登录 删除通知
GET /api/notifications/preferences 🔒 需登录 通知偏好设置
PUT /api/notifications/preferences 🔒 需登录 更新通知偏好
GET /api/notifications/logs 🔒 需登录 推送日志
GET /api/notifications/logs/stats 🔒 需登录 推送统计
POST /api/notifications/push/send 🔒 需登录 发送推送
POST /api/notifications/push/retry 🔒 需登录 重试推送
📁 📁 文件上传 2 个接口
POST /api/upload 🔒 需登录 上传文件
DELETE /api/upload 🔒 需登录 删除文件
🔐 🔐 角色权限管理 5 个接口
GET /api/roles 🔒 需登录📦 roles.view 角色列表
POST /api/roles 🔒 需登录 创建角色
GET /api/roles/permissions 🔒 需登录 权限列表
PUT /api/roles/{id} 🔒 需登录 更新角色
DELETE /api/roles/{id} 🔒 需登录 删除角色
📥 📥 导出（通用） 7 个接口
GET /api/export/shops 🔒 需登录⏱ 10次/分钟 导出商铺 Excel
GET /api/export/contracts 🔒 需登录⏱ 10次/分钟 导出合同 Excel
GET /api/export/bills 🔒 需登录⏱ 10次/分钟 导出账单 Excel
GET /api/export/payments 🔒 需登录⏱ 10次/分钟 导出收款 Excel
GET /api/export/expenses 🔒 需登录⏱ 10次/分钟 导出支出 Excel
GET /api/export/maintenance 🔒 需登录⏱ 10次/分钟 导出维修工单 Excel
GET /api/export/meter-readings 🔒 需登录⏱ 10次/分钟 导出抄表数据 Excel
⚙️ ⚙️ 系统管理（超管） 39 个接口
GET /api/admin/tenants 🔒 需登录 租户列表
POST /api/admin/tenants 🔒 需登录 创建租户
GET /api/admin/tenants/{id} 🔒 需登录 租户详情
PUT /api/admin/tenants/{id} 🔒 需登录 更新租户
DELETE /api/admin/tenants/{id} 🔒 需登录 删除租户
PUT /api/admin/tenants/{id}/package 🔒 需登录 切换套餐
PUT /api/admin/tenants/{id}/expiry 🔒 需登录 设置到期时间
PUT /api/admin/tenants/{id}/suspend 🔒 需登录 停用租户
PUT /api/admin/tenants/{id}/activate 🔒 需登录 启用租户
GET /api/admin/packages 🔒 需登录 套餐列表
POST /api/admin/packages 🔒 需登录 创建套餐
GET /api/admin/packages/{id} 🔒 需登录 套餐详情
PUT /api/admin/packages/{id} 🔒 需登录 更新套餐
DELETE /api/admin/packages/{id} 🔒 需登录 删除套餐
POST /api/admin/packages/seed 🔒 需登录 初始化套餐种子数据
GET /api/admin/packages/features 🔒 需登录 套餐功能列表
GET /api/admin/stats/overview 🔒 需登录 系统概览统计
GET /api/admin/settings 🔒 需登录 设置列表
GET /api/admin/settings/schema 🔒 需登录 设置Schema
GET /api/admin/settings/general 🔒 需登录 通用设置
PUT /api/admin/settings/general 🔒 需登录 更新通用设置
GET /api/admin/settings/meter-reading 🔒 需登录 抄表参数设置
PUT /api/admin/settings/meter-reading 🔒 需登录 更新抄表参数
GET /api/admin/settings/payment 🔒 需登录 支付参数设置
PUT /api/admin/settings/payment 🔒 需登录 更新支付参数
GET /api/admin/settings/property 🔒 需登录 物业参数设置
PUT /api/admin/settings/property 🔒 需登录 更新物业参数
PUT /api/admin/settings/{channel} 🔒 需登录 按渠道更新设置
POST /api/admin/settings/{channel}/test 🔒 需登录 测试设置（如邮件/SMS）
GET /api/admin/operation-logs 🔒 需登录 操作日志列表
GET /api/admin/operation-logs/stats 🔒 需登录 操作日志统计
GET /api/admin/operation-logs/modules 🔒 需登录 操作模块列表
GET /api/admin/operation-logs/actions 🔒 需登录 操作行为列表
GET /api/admin/operation-logs/{id} 🔒 需登录 操作日志详情
GET /api/admin/users 🔒 需登录 后台用户列表
POST /api/admin/users 🔒 需登录 创建后台用户
GET /api/admin/users/{id} 🔒 需登录 后台用户详情
PUT /api/admin/users/{id} 🔒 需登录 更新后台用户
DELETE /api/admin/users/{id} 🔒 需登录 删除后台用户
🏘️ 🏘️ 住宅小区管理 9 个接口
GET /api/communities 🔒 需登录📦 residential_community 小区列表
POST /api/communities 🔒 需登录 新增小区
GET /api/communities/{id} 🔒 需登录 小区详情
PUT /api/communities/{id} 🔒 需登录 更新小区
DELETE /api/communities/{id} 🔒 需登录 删除小区
GET /api/communities/{id}/buildings 🔒 需登录 小区楼栋列表
GET /api/communities/{id}/rooms 🔒 需登录 小区房号列表
POST /api/communities/{id}/generate-rooms 🔒 需登录 批量生成房号
GET /api/communities/{id}/stats 🔒 需登录 小区统计
🏗️ 🏗️ 住宅楼栋管理 3 个接口
POST /api/community-buildings 🔒 需登录📦 residential_community 新增楼栋
PUT /api/community-buildings/{id} 🔒 需登录 更新楼栋
DELETE /api/community-buildings/{id} 🔒 需登录 删除楼栋
🚪 🚪 住宅房号管理 2 个接口
PUT /api/rooms/{id} 🔒 需登录📦 residential_community 更新房号信息
POST /api/rooms/batch-update 🔒 需登录 批量更新房号
👥 👥 住户管理 9 个接口
GET /api/residents 🔒 需登录📦 residential_community 住户列表（分页+搜索）
POST /api/residents 🔒 需登录 新增住户
GET /api/residents/{id} 🔒 需登录 住户详情
PUT /api/residents/{id} 🔒 需登录 更新住户
DELETE /api/residents/{id} 🔒 需登录 删除住户
POST /api/residents/checkin 🔒 需登录 住户入住
POST /api/residents/{id}/checkout 🔒 需登录 住户搬离
POST /api/residents/import 🔒 需登录 批量导入住户
GET /api/residents/export 🔒 需登录 导出住户
📋 📋 住宅抄表任务 6 个接口
GET /api/meter-reading/tasks 🔒 需登录📦 residential_community 抄表任务列表
POST /api/meter-reading/tasks 🔒 需登录 创建抄表任务
GET /api/meter-reading/tasks/{id} 🔒 需登录 任务详情
POST /api/meter-reading/tasks/{id}/assign 🔒 需登录 指派抄表员
POST /api/meter-reading/tasks/{id}/cancel 🔒 需登录 取消任务
GET /api/meter-reading/stats 🔒 需登录 抄表统计
✏️ ✏️ 住宅抄表执行 3 个接口
GET /api/meter-reading/tasks/{id}/rooms 🔒 需登录📦 residential_community 任务房号列表（含读数）
POST /api/meter-reading/readings 🔒 需登录 提交抄表读数
POST /api/meter-reading/readings/batch 🔒 需登录 批量提交抄表读数
⚡ ⚡ 住宅计费配置 4 个接口
GET /api/community/fee-configs 🔒 需登录📦 residential_community 计费配置列表
POST /api/community/fee-configs 🔒 需登录 新增计费配置
PUT /api/community/fee-configs/{id} 🔒 需登录 更新计费配置
DELETE /api/community/fee-configs/{id} 🔒 需登录 删除计费配置
💳 💳 住宅缴费 4 个接口
POST /api/community/payment/wechat-pay 🔒 需登录📦 residential_community 微信支付
POST /api/community/payment/cash 🔒 需登录 现金缴费
GET /api/community/payment/collection-rate 🔒 需登录 收费率统计
GET /api/community/payment/arrears-ranking 🔒 需登录 欠费排名
📊 📊 住宅数据大屏 2 个接口
GET /api/resident-dashboard/overview 🔒 需登录📦 residential_dashboard 住宅数据总览
GET /api/resident-dashboard/monthly-trend 🔒 需登录 月度趋势
📱 📱 住户端Portal 4 个接口
GET /api/portal/community/room/{id}/bill 扫码查账单（H5公开）
GET /api/portal/community/room/{id}/qrcode 房间二维码
POST /api/portal/community/wechat/bind 微信绑定
GET /api/portal/community/community/{id}/overview 小区概览（H5公开）
📌 🔑 租客门户Portal 18 个接口
POST /api/portal/auth/login ⏱ 10次/分钟 手机验证码登录
POST /api/portal/auth/sms-code ⏱ 3次/分钟 发送短信验证码
GET /api/portal/auth/me 🔒 需登录 当前租客信息
POST /api/portal/auth/bind-shop 🔒 需登录 绑定商铺
GET /api/portal/dashboard 🔒 需登录 租客首页数据
GET /api/portal/bills 🔒 需登录 租客账单列表
GET /api/portal/bills/{id} 🔒 需登录 账单详情
POST /api/portal/bills/pay 🔒 需登录 账单支付
GET /api/portal/payments 🔒 需登录 缴费记录
GET /api/portal/contracts 🔒 需登录 合同列表
GET /api/portal/contracts/{id} 🔒 需登录 合同详情
GET /api/portal/contracts/{id}/download 🔒 需登录 下载合同文件
GET /api/portal/notices 🔒 需登录 公告列表
GET /api/portal/notices/{id} 🔒 需登录 公告详情
GET /api/portal/maintenance 🔒 需登录 维修工单列表
POST /api/portal/maintenance 🔒 需登录 提交维修申请
POST /api/portal/maintenance/{id}/rate 🔒 需登录 评价工单
POST /api/portal/message 🔒 需登录 联系管家留言
📇 📇 批量二维码打印 2 个接口
GET /api/qr-code/batch-print/{communityId} 🔒 需登录📦 residential_community 批量打印二维码
GET /api/qr-code/room/{roomId} 🔒 需登录 单个房间二维码
📋 📋 招商线索管理 9 个接口
GET /api/leasing/leads 🔒 需登录📦 shop_management 线索列表
POST /api/leasing/leads 🔒 需登录 新增线索
GET /api/leasing/leads/{id} 🔒 需登录 线索详情
PUT /api/leasing/leads/{id} 🔒 需登录 更新线索
DELETE /api/leasing/leads/{id} 🔒 需登录 删除线索
POST /api/leasing/leads/{id}/status 🔒 需登录 更新线索状态
POST /api/leasing/leads/{id}/assign 🔒 需登录 分配跟进人
POST /api/leasing/leads/{id}/followup 🔒 需登录 记录跟进
GET /api/leasing/funnel-stats 🔒 需登录 转化漏斗统计
📱 📱 微信小程序API 13 个接口
POST /api/miniprogram/auth/login ⏱ 30次/分钟 小程序登录（code换token）
POST /api/miniprogram/auth/phone 🔒 需登录⏱ 10次/分钟 绑定手机号
GET /api/miniprogram/user/profile 🔒 需登录 用户信息
POST /api/miniprogram/user/bind 🔒 需登录⏱ 10次/分钟 绑定住户/商铺
GET /api/miniprogram/bills 🔒 需登录 账单列表
POST /api/miniprogram/payment/pay 🔒 需登录⏱ 10次/分钟 发起微信支付
GET /api/miniprogram/meter-readings 🔒 需登录 抄表记录
GET /api/miniprogram/notifications 🔒 需登录 通知列表
PUT /api/miniprogram/notifications/{id}/read 🔒 需登录 标记通知已读
GET /api/miniprogram/services/maintenance 🔒 需登录 维修工单（小程序端）
POST /api/miniprogram/services/maintenance 🔒 需登录 提交维修申请
POST /api/miniprogram/services/complaint 🔒 需登录 提交投诉建议
GET /api/miniprogram/services/butler 🔒 需登录 管家信息
📡 📡 IoT设备管理 13 个接口
GET /api/admin/iot-devices 🔒 需登录📦 meter_reading,residential_community IoT设备列表
POST /api/admin/iot-devices 🔒 需登录 新增设备
GET /api/admin/iot-devices/{id} 🔒 需登录 设备详情
PUT /api/admin/iot-devices/{id} 🔒 需登录 更新设备
DELETE /api/admin/iot-devices/{id} 🔒 需登录 删除设备
GET /api/admin/iot-devices/status-overview 🔒 需登录 设备状态总览
GET /api/admin/iot-devices/data-logs 🔒 需登录 数据上报日志
POST /api/admin/iot-devices/{id}/reset-key 🔒 需登录 重置设备密钥
POST /api/admin/iot-devices/{id}/enable 🔒 需登录 启用设备
POST /api/admin/iot-devices/{id}/disable 🔒 需登录 禁用设备
GET /api/admin/iot-devices/{id}/status-history 🔒 需登录 设备状态历史
POST /api/iot/data/report IoT数据上报（设备端调用）
POST /api/iot/device/heartbeat IoT心跳上报（设备端调用）
📋 📋 投诉与建议 7 个接口
GET /api/complaints 🔒 需登录📦 maintenance_order 投诉列表
POST /api/complaints 🔒 需登录 提交投诉
GET /api/complaints/{id} 🔒 需登录 投诉详情
PUT /api/complaints/{id} 🔒 需登录 更新投诉
POST /api/complaints/{id}/assign 🔒 需登录 指派处理人
POST /api/complaints/{id}/status 🔒 需登录 更新投诉状态
DELETE /api/complaints/{id} 🔒 需登录 删除投诉
🚪 🚪 访客管理 8 个接口
GET /api/visitors 🔒 需登录 访客列表
POST /api/visitors 🔒 需登录 新增访客
GET /api/visitors/{id} 🔒 需登录 访客详情
PUT /api/visitors/{id} 🔒 需登录 更新访客
POST /api/visitors/{id}/check-in 🔒 需登录 访客签到
POST /api/visitors/{id}/check-out 🔒 需登录 访客签出
POST /api/visitors/{id}/cancel 🔒 需登录 取消访客
DELETE /api/visitors/{id} 🔒 需登录 删除访客
🎉 🎉 社区活动 8 个接口
GET /api/activities 🔒 需登录 活动列表
POST /api/activities 🔒 需登录 创建活动
GET /api/activities/{id} 🔒 需登录 活动详情
PUT /api/activities/{id} 🔒 需登录 更新活动
DELETE /api/activities/{id} 🔒 需登录 删除活动
GET /api/activities/{id}/registrations 🔒 需登录 报名列表
POST /api/activities/{id}/register 🔒 需登录 用户报名
PUT /api/activities/{id}/registrations/{regId} 🔒 需登录 更新报名状态
🗳️ 🗳️ 投票管理 7 个接口
GET /api/votes 🔒 需登录 投票列表
POST /api/votes 🔒 需登录 创建投票
GET /api/votes/{id} 🔒 需登录 投票详情
PUT /api/votes/{id} 🔒 需登录 更新投票
DELETE /api/votes/{id} 🔒 需登录 删除投票
POST /api/votes/{id}/cast 🔒 需登录 投票
GET /api/votes/{id}/results 🔒 需登录 投票结果
📌 积分/签到/任务/社区 16 个接口
GET /api/miniprogram/engagement/points/overview 🔒 需登录 积分概览（余额/等级/统计）
GET /api/miniprogram/engagement/points/records 🔒 需登录 积分明细（分页）
GET /api/miniprogram/engagement/points/guide 🔒 需登录 积分攻略（赚取/兑换规则）
POST /api/miniprogram/engagement/points/redeem 🔒 需登录 积分兑换
POST /api/miniprogram/engagement/points/share 🔒 需登录 分享得积分
POST /api/miniprogram/engagement/checkin/do 🔒 需登录 每日签到
GET /api/miniprogram/engagement/checkin/status 🔒 需登录 签到状态（今日是否签到/连续天数）
GET /api/miniprogram/engagement/checkin/stats 🔒 需登录 签到统计（最高连续/总积分）
GET /api/miniprogram/engagement/tasks/list 🔒 需登录 任务列表（每日/成就+进度）
POST /api/miniprogram/engagement/tasks/claim 🔒 需登录 领取任务奖励
GET /api/miniprogram/engagement/community/list 🔒 需登录 社区帖子列表（分页）
POST /api/miniprogram/engagement/community/create 🔒 需登录 发布帖子
POST /api/miniprogram/engagement/community/like 🔒 需登录 点赞/取消点赞
GET /api/miniprogram/engagement/community/my 🔒 需登录 我的帖子
POST /api/miniprogram/engagement/community/delete 🔒 需登录 删除帖子
GET /api/miniprogram/home 🔒 需登录 首页数据聚合（轮播图+公告+功能开关）
🔍 🔍 失物招领 12 个接口
GET /api/lost-found 🔒 需登录📦 residential_community 【管理端】失物招领列表（筛选/分页）
POST /api/lost-found 🔒 需登录 【管理端】发布失物/拾物
GET /api/lost-found/{id} 🔒 需登录 【管理端】详情
PUT /api/lost-found/{id} 🔒 需登录 【管理端】编辑
POST /api/lost-found/{id}/audit 🔒 需登录 【管理端】审核通过/驳回
POST /api/lost-found/{id}/claim 🔒 需登录 【管理端】认领确认
POST /api/lost-found/{id}/close 🔒 需登录 【管理端】关闭
DELETE /api/lost-found/{id} 🔒 需登录 【管理端】删除
GET /api/miniprogram/lost-found 🔒 需登录 【小程序端】公开列表
POST /api/miniprogram/lost-found 🔒 需登录 【小程序端】发布
GET /api/miniprogram/lost-found/{id} 🔒 需登录 【小程序端】详情
POST /api/miniprogram/lost-found/{id}/claim 🔒 需登录 【小程序端】认领
🏠 🏠 房源信息 11 个接口
GET /api/property-listings 🔒 需登录📦 residential_community 【管理端】房源列表
POST /api/property-listings 🔒 需登录 【管理端】创建房源
GET /api/property-listings/{id} 🔒 需登录 【管理端】详情
PUT /api/property-listings/{id} 🔒 需登录 【管理端】编辑
POST /api/property-listings/{id}/audit 🔒 需登录 【管理端】审核
DELETE /api/property-listings/{id} 🔒 需登录 【管理端】删除
GET /api/miniprogram/listings 🔒 需登录 【小程序端】房源列表
POST /api/miniprogram/listings 🔒 需登录 【小程序端】发布
GET /api/miniprogram/listings/{id} 🔒 需登录 【小程序端】详情
POST /api/miniprogram/listings/{id}/close 🔒 需登录 【小程序端】下架
GET /api/miniprogram/listings/recommended 🔒 需登录 【小程序端】推荐房源
🛠️ 🛠️ 装修管理 10 个接口
GET /api/renovations 🔒 需登录📦 residential_community 装修申请列表
POST /api/renovations 🔒 需登录 提交装修申请
GET /api/renovations/{id} 🔒 需登录 申请详情
POST /api/renovations/{id}/audit 🔒 需登录 审核申请
POST /api/renovations/{id}/start-construction 🔒 需登录 开始施工
POST /api/renovations/{id}/request-inspection 🔒 需登录 申请验收
POST /api/renovations/{id}/inspect 🔒 需登录 执行验收
POST /api/renovations/{id}/refund-deposit 🔒 需登录 退还保证金
GET /api/renovations/{id}/inspections 🔒 需登录 巡查记录列表
POST /api/renovations/{id}/inspections 🔒 需登录 添加巡查记录
📊 📊 预警中心 2 个接口
GET /api/alert-center 🔒 需登录📦 residential_community 预警总览（合同到期/账单逾期/工单超时等）
GET /api/alert-center/{type} 🔒 需登录 按类型查看预警详情
📊 📊 大屏看板 1 个接口
GET /api/big-screen 🔒 需登录 物业大屏看板数据
⭐ ⭐ 信用评分 3 个接口
GET /api/credit-scores 🔒 需登录📦 residential_community 信用评分列表
GET /api/credit-scores/{id} 🔒 需登录 评分详情
POST /api/credit-scores/{id}/refresh 🔒 需登录 刷新评分
📋 📋 消息模板管理 6 个接口
GET /api/notification-templates 🔒 需登录 模板列表
POST /api/notification-templates 🔒 需登录 创建模板
GET /api/notification-templates/{id} 🔒 需登录 模板详情
PUT /api/notification-templates/{id} 🔒 需登录 更新模板
DELETE /api/notification-templates/{id} 🔒 需登录 删除模板
POST /api/notification-templates/{id}/test 🔒 需登录 测试模板
📋 📋 工单回访 7 个接口
GET /api/satisfaction/orders 🔒 需登录 工单回访列表
GET /api/satisfaction/stats 🔒 需登录 回访统计摘要
GET /api/satisfaction/rating-distribution 🔒 需登录 评分分布统计
GET /api/satisfaction/trend 🔒 需登录 满意度趋势
GET /api/satisfaction/category-stats 🔒 需登录 分类统计
GET /api/satisfaction/overdue-callbacks 🔒 需登录 逾期未回访列表
PUT /api/satisfaction/orders/{id} 🔒 需登录 更新回访记录
📋 📋 员工考勤 8 个接口
GET /api/attendance 🔒 需登录 考勤记录列表
POST /api/attendance 🔒 需登录 新增考勤记录
GET /api/attendance/employees 🔒 需登录 考勤员工列表
GET /api/attendance/monthly-stats 🔒 需登录 月度考勤统计
GET /api/attendance/stats 🔒 需登录 考勤统计
GET /api/attendance/{id} 🔒 需登录 详情
PUT /api/attendance/{id} 🔒 需登录 更新
DELETE /api/attendance/{id} 🔒 需登录 删除
🎨 🎨 可视化页面编辑器 11 个接口
GET /api/admin/miniprogram/pages 🔒 需登录 页面列表
POST /api/admin/miniprogram/pages 🔒 需登录 新建页面
GET /api/admin/miniprogram/pages/{id} 🔒 需登录 页面详情（含组件）
PUT /api/admin/miniprogram/pages/{id} 🔒 需登录 更新页面（名称/状态）
DELETE /api/admin/miniprogram/pages/{id} 🔒 需登录 删除页面
GET /api/admin/miniprogram/pages/{id}/components 🔒 需登录 页面组件列表
POST /api/admin/miniprogram/components 🔒 需登录 添加组件到页面
PUT /api/admin/miniprogram/components/{id} 🔒 需登录 更新组件属性
DELETE /api/admin/miniprogram/components/{id} 🔒 需登录 删除组件
POST /api/admin/miniprogram/components/bulk-save 🔒 需登录 批量保存组件排序
GET /api/miniprogram/page-config/{pageKey} 【公开】获取页面配置（小程序渲染用）
⚙️ ⚙️ 系统配置（超管） 21 个接口
GET /api/admin/settings/system/schema 🔒 需登录 系统配置Schema
GET /api/admin/settings/system/general 🔒 需登录 基础设置
PUT /api/admin/settings/system/general 🔒 需登录 更新基础设置
GET /api/admin/settings/system/meter-reading 🔒 需登录 抄表设置
PUT /api/admin/settings/system/meter-reading 🔒 需登录 更新抄表设置
GET /api/admin/settings/system/payment 🔒 需登录 支付设置
PUT /api/admin/settings/system/payment 🔒 需登录 更新支付设置
GET /api/admin/settings/system/property 🔒 需登录 物业设置
PUT /api/admin/settings/system/property 🔒 需登录 更新物业设置
GET /api/admin/settings/system/maintenance 🔒 需登录 维修设置
PUT /api/admin/settings/system/maintenance 🔒 需登录 更新维修设置
GET /api/admin/settings/system/security 🔒 需登录 安全设置
PUT /api/admin/settings/system/security 🔒 需登录 更新安全设置
GET /api/admin/settings/backup 🔒 需登录 备份列表
POST /api/admin/settings/backup 🔒 需登录 创建备份
POST /api/admin/settings/backup/{id}/restore 🔒 需登录 恢复备份
POST /api/admin/settings/backup/{id}/download 🔒 需登录 下载备份
DELETE /api/admin/settings/backup/{id} 🔒 需登录 删除备份
GET /api/admin/settings/logs 🔒 需登录 系统日志列表
POST /api/admin/settings/logs/export 🔒 需登录 导出系统日志
DELETE /api/admin/settings/logs/clear 🔒 需登录 清空系统日志
📋 📋 系统日志（超管） 8 个接口
GET /api/admin/system-logs 🔒 需登录 日志列表
GET /api/admin/system-logs/stats 🔒 需登录 日志统计
GET /api/admin/system-logs/trend 🔒 需登录 日志趋势
GET /api/admin/system-logs/levels 🔒 需登录 日志级别分布
GET /api/admin/system-logs/analysis 🔒 需登录 日志分析
GET /api/admin/system-logs/export 🔒 需登录 导出日志
GET /api/admin/system-logs/{id} 🔒 需登录 日志详情
GET /api/admin/system-logs/{id}/trace 🔒 需登录 日志追踪
💼 💼 审批中心 7 个接口
GET /api/approvals/pending 🔒 需登录 待审批列表
GET /api/approvals/my 🔒 需登录 我的审批
GET /api/approvals/{id} 🔒 需登录 审批详情
POST /api/approvals/{id}/approve 🔒 需登录 通过审批
POST /api/approvals/{id}/reject 🔒 需登录 驳回审批
POST /api/approvals/{id}/cancel 🔒 需登录 撤销审批
GET /api/approvals/flow-config 🔒 需登录 审批流配置
💰 💰 预算管理 10 个接口
GET /api/budgets 🔒 需登录 预算列表
POST /api/budgets 🔒 需登录 创建预算
GET /api/budgets/{id} 🔒 需登录 预算详情
PUT /api/budgets/{id} 🔒 需登录 更新预算
DELETE /api/budgets/{id} 🔒 需登录 删除预算
POST /api/budgets/{id}/submit 🔒 需登录 提交审批
POST /api/budgets/{id}/approve 🔒 需登录 通过
POST /api/budgets/{id}/reject 🔒 需登录 驳回
GET /api/budgets/categories 🔒 需登录 预算类别
GET /api/budgets/execution 🔒 需登录 预算执行情况
📊 📊 成本核算 3 个接口
GET /api/cost-accounting/by-building 🔒 需登录 按楼栋成本核算
GET /api/cost-accounting/by-category 🔒 需登录 按类别成本核算
GET /api/cost-accounting/income-statement 🔒 需登录 损益表
💰 💰 资金账户 11 个接口
GET /api/fund-accounts 🔒 需登录 账户列表
POST /api/fund-accounts 🔒 需登录 创建账户
GET /api/fund-accounts/{id} 🔒 需登录 账户详情
PUT /api/fund-accounts/{id} 🔒 需登录 更新账户
DELETE /api/fund-accounts/{id} 🔒 需登录 删除账户
GET /api/fund-accounts/overview 🔒 需登录 资金总览
GET /api/fund-accounts/transactions 🔒 需登录 交易流水
POST /api/fund-accounts/import 🔒 需登录 导入流水
POST /api/fund-accounts/auto-match 🔒 需登录 自动对账
POST /api/fund-accounts/manual-match 🔒 需登录 手动对账
GET /api/fund-accounts/match-report 🔒 需登录 对账报告
📋 📋 凭证管理 8 个接口
GET /api/vouchers 🔒 需登录 凭证列表
POST /api/vouchers 🔒 需登录 创建凭证
GET /api/vouchers/{id} 🔒 需登录 凭证详情
PUT /api/vouchers/{id} 🔒 需登录 更新凭证
POST /api/vouchers/{id}/post 🔒 需登录 过账
POST /api/vouchers/{id}/cancel 🔒 需登录 作废
POST /api/vouchers/generate/payments 🔒 需登录 收款生成凭证
POST /api/vouchers/generate/expenses 🔒 需登录 支出生成凭证
📋 📋 费用公示 5 个接口
GET /api/fee-disclosure-manage/summary 🔒 需登录 费用公示总览
GET /api/fee-disclosure-manage/expense 🔒 需登录 支出公示
GET /api/fee-disclosure-manage/income 🔒 需登录 收入公示
GET /api/fee-disclosure-manage/maintenance 🔒 需登录 维修公示
GET /api/fee-disclosure-manage/public-utility 🔒 需登录 公摊公示
📱 📱 小程序·服务 12 个接口
GET /api/miniprogram/services/maintenance 🔒 需登录 报修服务
POST /api/miniprogram/services/complaint 🔒 需登录 投诉建议
GET /api/miniprogram/services/butler 🔒 需登录 联系管家
GET /api/miniprogram/votes 🔒 需登录 投票列表
GET /api/miniprogram/votes/{id} 🔒 需登录 投票详情
POST /api/miniprogram/votes/{id}/vote 🔒 需登录 投票
GET /api/miniprogram/listings/my 🔒 需登录 我的房源
GET /api/miniprogram/lost-found/my 🔒 需登录 我的失物招领
GET /api/miniprogram/fee-disclosure/summary 🔒 需登录 费用公示(小程序)
GET /api/miniprogram/public/home 公开首页
GET /api/miniprogram/notifications 🔒 需登录 通知列表
PUT /api/miniprogram/notifications/{id}/read 🔒 需登录 标记已读
📱 📱 小程序·配置 18 个接口
GET /api/mini/config 🔒 需登录 小程序配置
GET /api/mini/public/config 公开配置
GET /api/mini/features 🔒 需登录 功能配置
GET /api/mini/brand 🔒 需登录 品牌信息
GET /api/admin/miniprogram/tenant-mini-config 🔒 需登录 租户小程序配置
GET /api/admin/miniprogram/tenant-mini-config/available-pages 🔒 需登录 可用页面列表
POST /api/admin/miniprogram/tenant-mini-config/defaults 🔒 需登录 恢复默认配置
GET /api/admin/miniprogram/tenant-mini-config/feature-meta 🔒 需登录 功能元信息
POST /api/admin/miniprogram/tenant-mini-config/reset-features 🔒 需登录 重置功能开关
GET /api/admin/miniprogram/tenant-mini-config/summary 🔒 需登录 配置总览
POST /api/admin/miniprogram/tenant-mini-config/toggle-all-features 🔒 需登录 全量开关
GET /api/admin/miniprogram/mini-versions 🔒 需登录 版本列表
POST /api/admin/miniprogram/mini-versions 🔒 需登录 创建版本
GET /api/admin/miniprogram/mini-versions/latest 🔒 需登录 最新版本
POST /api/admin/miniprogram/mini-versions/{id}/submit 🔒 需登录 提交审核
POST /api/admin/miniprogram/mini-versions/{id}/approve 🔒 需登录 审核通过
POST /api/admin/miniprogram/mini-versions/{id}/reject 🔒 需登录 审核驳回
POST /api/admin/miniprogram/mini-versions/{id}/publish 🔒 需登录 发布版本
📱 📱 Portal·门户（租户端Web） 14 个接口
POST /api/portal/auth/login 门户登录
GET /api/portal/auth/me 🔒 需登录 门户用户信息
POST /api/portal/auth/sms-code 发送验证码
POST /api/portal/auth/bind-shop 🔒 需登录 绑定商铺
GET /api/portal/bills 🔒 需登录 账单列表
POST /api/portal/bills/pay 🔒 需登录 在线缴费
GET /api/portal/contracts 🔒 需登录 合同列表
GET /api/portal/contracts/{id}/download 🔒 需登录 下载合同PDF
GET /api/portal/maintenance 🔒 需登录 维修工单
POST /api/portal/maintenance/{id}/rate 🔒 需登录 评价工单
GET /api/portal/notices 🔒 需登录 公告列表
GET /api/portal/payments 🔒 需登录 缴费记录
GET /api/portal/dashboard 🔒 需登录 门户首页
GET /api/portal/message 🔒 需登录 门户消息
📋 📋 高级报表 13 个接口
GET /api/reports/revenue-summary 🔒 需登录 营收汇总
GET /api/reports/monthly-revenue 🔒 需登录 月度营收明细
GET /api/reports/occupancy-trend 🔒 需登录 出租率走势
GET /api/reports/tenant-ranking 🔒 需登录 租户排行
GET /api/reports/contracts 🔒 需登录 合同报表
GET /api/reports/shops 🔒 需登录 商铺报表
GET /api/reports/finance 🔒 需登录 财务报表
GET /api/reports/todo-items 🔒 需登录 待办事项
GET /api/reports/export/arrears 🔒 需登录 导出欠费报表
GET /api/reports/export/revenue 🔒 需登录 导出营收报表
GET /api/reports/export/income-expense 🔒 需登录 导出收支报表
GET /api/reports/export/occupancy 🔒 需登录 导出出租率
GET /api/reports/export/contracts-expiring 🔒 需登录 导出到期合同
🏢 🏢 运营平台（超管） 9 个接口
GET /api/admin/platform/orders 🔒 需登录 平台订单
GET /api/admin/platform/packages 🔒 需登录 平台套餐
GET /api/admin/platform/sms-packages 🔒 需登录 短信套餐
POST /api/admin/platform/auto-renew 🔒 需登录 自动续费
GET /api/admin/packages/features 🔒 需登录 套餐功能列表
POST /api/admin/packages/seed 🔒 需登录 初始化套餐
GET /api/admin/stats/overview 🔒 需登录 运营统计数据
GET /api/admin/users 🔒 需登录 管理员列表
POST /api/admin/users 🔒 需登录 创建管理员
📖 📚 API 文档 1 个接口
GET /api/api/docs API 在线文档（本页面）
📅 📅 场地预约 14 个接口
GET /api/admin/reservation/venues 🔒 需登录 【管理端】场地列表
POST /api/admin/reservation/venues 🔒 需登录 【管理端】新增场地
PUT /api/admin/reservation/venues/{id} 🔒 需登录 【管理端】编辑场地
DELETE /api/admin/reservation/venues/{id} 🔒 需登录 【管理端】删除场地
POST /api/admin/reservation/resources 🔒 需登录 【管理端】新增资源
PUT /api/admin/reservation/resources/{id} 🔒 需登录 【管理端】编辑资源
DELETE /api/admin/reservation/resources/{id} 🔒 需登录 【管理端】删除资源
GET /api/admin/reservation/orders 🔒 需登录 【管理端】预约订单列表
PUT /api/admin/reservation/orders/{id}/status 🔒 需登录 【管理端】更新预约状态
GET /api/miniprogram/reservation/venues 🔒 需登录 【小程序端】可预约场地
GET /api/miniprogram/reservation/slots 🔒 需登录 【小程序端】某资源已预约时段
POST /api/miniprogram/reservation/store 🔒 需登录 【小程序端】提交预约
GET /api/miniprogram/reservation/my 🔒 需登录 【小程序端】我的预约
POST /api/miniprogram/reservation/{id}/cancel 🔒 需登录 【小程序端】取消预约
🖼️ 🖼️ 小程序CMS管理 8 个接口
GET /api/admin/miniprogram/banners 🔒 需登录 轮播图列表
POST /api/admin/miniprogram/banners 🔒 需登录 新增轮播图
PUT /api/admin/miniprogram/banners/{id} 🔒 需登录 编辑轮播图
DELETE /api/admin/miniprogram/banners/{id} 🔒 需登录 删除轮播图
GET /api/admin/miniprogram/announcements 🔒 需登录 公告列表
POST /api/admin/miniprogram/announcements 🔒 需登录 发布公告
PUT /api/admin/miniprogram/announcements/{id} 🔒 需登录 编辑公告
DELETE /api/admin/miniprogram/announcements/{id} 🔒 需登录 删除公告
🔘 🔘 小程序功能开关 2 个接口
GET /api/admin/miniprogram/features 🔒 需登录 功能开关列表
PUT /api/admin/miniprogram/features 🔒 需登录 批量更新功能开关
👥 👥 C端用户管理 10 个接口
GET /api/admin/c-end-users 🔒 需登录 【管理端】用户列表（跨租户）
GET /api/admin/c-end-users/{id} 🔒 需登录 【管理端】用户详情
GET /api/admin/c-end-users/export 🔒 需登录 【管理端】导出CSV
GET /api/admin/c-end-users/tenants/list 🔒 需登录 【管理端】物业列表（筛选用）
GET /api/c-end-users 🔒 需登录 【B端】用户列表（仅自己物业）
POST /api/c-end-users 🔒 需登录 【B端】手动添加用户
PUT /api/c-end-users/{id} 🔒 需登录 【B端】编辑用户
DELETE /api/c-end-users/{id} 🔒 需登录 【B端】删除用户
GET /api/c-end-users/template/download 🔒 需登录 【B端】下载导入模板
POST /api/c-end-users/import 🔒 需登录 【B端】批量导入用户
SHUXINGVIP-综合物业管理系统 v2.0.0 · 自动生成于部署时