智慧社区物业管理系统
操 作 手 册

平台运营 · 物业公司 · 业主端 · 员工端 四端协同

V2.0 2026 年 11 月
系统版本 HC MicroCommunity(Spring Boot 单体部署)
物业端 https://pm.aibiology.com.cn
业主端 https://pm.aibiology.com.cn/owner/
适用对象 平台实施与运维、物业管理员、客服管家、收费员、工程维修、秩序维护

阅读指引

本手册按角色组织,不按菜单组织。先找到自己的岗位,再看对应的部分,不用从头读到尾。

你的岗位常用端先读哪部分必看章节
平台实施 / 运维 / 开发支持管理后台(平台账号)第零章 → 第一部分1.1 公司建档 · 1.3 支付通道 · 1.4 联调排障
物业管理员管理后台(物业账号)第零章 → 第二部分2.3 收费 · 2.5 支付配置 · 2.6 报表对账
客服管家管理后台第二部分2.1 业主录入 · 2.4 报修 · 2.7 楼长配置
收费员管理后台第二部分2.3 收费管理 · 2.6 报表与对账
工程维修 / 巡检管理后台 + 员工端第二部分 → 第四部分2.4 报修 · 2.8 设备与巡检
业主 / 住户微信小程序 / H5第三部分3.2 缴费 · 3.3 报修 · 3.4 联系物业
阅读前须知:① 手册中的截图全部来自真实系统,姓名、电话、证件、法人信息已做模糊处理;② 手册不包含任何账号口令;③ 涉及金额与密钥的操作,建议两人复核。

第零章 系统总览

0.1 系统是什么

这是一套面向物业公司的社区管理平台,覆盖「房产资源 → 业主档案 → 费用收缴 → 报修服务 → 设备与巡检 → 公告问卷」的完整业务链。它不是单一软件,而是一套后台 + 三个使用端。

端谁在用主要用途访问方式
管理后台平台运营方、物业公司办公室人员建档、收费、派单、报表、配置电脑浏览器 https://pm.aibiology.com.cn
业主端业主 / 住户缴费、报修、访客邀请、公告、联系物业手机浏览器 / 微信 https://pm.aibiology.com.cn/owner/
员工移动端巡检、维修、秩序维护接单、扫码巡检、现场拍照上传手机 App

0.2 整体架构

理解下面这张分层图,就理解了系统怎么运转:三端共用一个接口网关,网关后面是拆分的业务服务,数据落在 MySQL 和 Redis,外部支付渠道和物联网平台是可选依赖。

接入层(三端)
管理后台 Web
平台 / 物业
业主端
小程序 / H5
员工移动端
App
↓
网关层
service-api 签名校验 · 路由 · 登录态
↓
业务服务层
收费支付对账小区房产业主报修设备巡检报表用户认证
↓
数据与外部
MySQL
业务数据
Redis
会话 / 缓存
银行支付网关
光大等
物联网平台
当前未接入
虚线标注的可选模块(商城、物联网)当前环境未部署,相关菜单已隐藏或改为本地能力。进入功能时提示「系统未部署」属于设计如此,不是故障。

0.3 角色与权限矩阵

权限由菜单(能看见哪些功能)、权限项(能做什么动作)、接口授权(能不能真正调通)三层共同决定。前端能打开菜单,不代表接口有权限——这是排查「点进去报无权限」的第一顺位原因。

能力平台运营物业管理员物业一线业主
物业公司 / 小区建档✅———
模块开通(商城 / 物联网)✅———
支付通道密钥配置✅✅ 需权限——
业主 / 房屋建档—✅部分—
生成账单 / 收款—✅✅ 收费员缴费
报修接单 / 派单—✅✅ 工程提交 / 评价
楼长配置—✅部分查看
报表查看全平台本公司部分个人账单
接口授权必须同时授给实际调用方的 AppId。平台端和物业端是两个不同的 AppId,只授一个会出现「一边正常、另一边报没有权限」。

0.4 三个关键概念

概念含义为什么重要
小区(Community)业务数据的最小隔离单位页面右上角切换小区后,看到的数据随之变化。操作前先确认右上角是哪个小区
房屋(Room)楼栋 → 单元 → 房号 三级定位收费、报修、门禁都按房屋关联,房号建错会连锁出错
业主(Owner)与房屋绑定的人只有绑定了房屋,业主才能在业主端看到账单

0.5 上手顺序

建楼栋
单元 · 房屋
→
录业主
并绑定房屋
→
配费用项
定单价周期
→
生成账单
→
收款 / 对账
→
日常:报修 · 巡检

顺序不能颠倒:房屋没建档 → 业主绑不上房 → 绑不上房就看不到账单 → 没有账单就收不了钱。新小区上线,按这个顺序走一遍,基本不会卡住。

0.6 主菜单一览

左侧主菜单共 14 组,日常高频的是「房产、费用、报修、报表」四组。

菜单组主要功能使用频率
小区小区信息、楼栋管理、小区配置高
房产业主信息、房屋管理、业主车辆高
费用费用项设置、房屋收费、员工收费、支付配置、缴费明细高
报修报修待办、电话报修、报修回访高
巡检巡检计划、巡检任务、巡检点中
设备设备中心(门禁授权、充电桩、水电表、保养计划、设备台账)中
停车车位、月卡、在场车辆中
报表营业日报、数据统计、缴费明细中
办公公告、投诉建议、员工与班次中
合同合同与协议管理低
采购采购申请与入库低
优惠优惠规则与活动低
预约场地与访客预约低
OA内部审批流程低

第一部分 平台运营方

使用平台账号登录管理后台。平台视角能看到所有物业公司和小区,操作重点是三件事:建档、开通、配通道。

1.1 物业公司建档与模块开通

菜单:数据 → 物业公司
1新增物业公司
点「添加」,填写编号、名称、地址、管理员、电话、法人、成立日期。保存后系统会自动创建该公司的管理员账号,默认以管理员手机号作为登录账号。
2开通模块
列表右侧有「商城」「物联网」两列。灰色 = 未开通,蓝色 = 已开通,点击切换,需二次确认。
图 1-1 平台-物业公司列表(管理员、电话、法人已模糊;商城、物联网为按公司开通的开关)
图 1-1 平台-物业公司列表(管理员、电话、法人已模糊;商城、物联网为按公司开通的开关)

两层开关,务必分清

层级位置含义
全局开关系统配置项(MALL_SWITCH / IOT_SWITCH)这套子系统在本环境是否已部署
公司开关本页列表中的开关按钮这家公司是否开通该模块
全局开关没打开时,即使公司开关显示「已开通」,进入功能仍会提示「系统未部署」。这是设计如此,不是故障——先查全局,再查公司。

1.2 小区建档与审核

1物业公司建档
物业公司在「小区管理」中新增小区,填写名称、地址、地图坐标、联系电话。
2平台审核
平台在「数据 → 小区审核」中通过。审核通过后,小区才会出现在物业端的小区切换列表里。
顺序不可颠倒:小区未审核通过时,物业端无法在该小区下建房屋、录业主。新小区上线第一步永远是「先审核」。

1.3 支付通道配置(平台侧)

菜单:费用 → 小区支付(运营端) | 物业端对应菜单为「支付配置」

平台侧可以按小区查看和维护支付通道。通道的详细字段说明见 2.5 支付配置与收款方式,两处是同一套数据,只是入口不同。

图 1-2 运营端小区支付配置(按所选小区查看 / 维护通道)
图 1-2 运营端小区支付配置(按所选小区查看 / 维护通道)
待补截图 P-03新增支付通道弹窗(运营端):需体现「名称 / 支付厂家 / 收款支付方式 / 支付范围 / 收款支付方式字典」

1.4 联调与排障

实施和运维阶段最常遇到的五类报错,按现象定位:

现象先查这里
列表 / 弹窗打不开,提示「没有权限」服务是否已注册,接口是否授权给当前端的 AppId(平台端与物业端 AppId 不同)
提示「调用方式不对」服务注册的 HTTP 方法与前端实际调用不一致(GET / POST)
提示「商城 / 物联网系统未部署」全局开关为 OFF,或该子系统在本环境未部署
提示「该物业公司未开通…」公司开关未打开,见 1.1
联调测试返回 auth_code 缺失通道接口类型为「付款码」,联调不支持,系统会自动改用主扫

第二部分 物业公司

使用物业账号登录。所有操作都在当前所选小区下生效,动手前先看右上角的小区名称——这是新手最容易踩的坑。

2.1 业主信息录入

菜单:房产 → 业主信息 | 前置:房屋已建档 | 耗时:约 2 分钟 / 户
进入
业主信息
→
已有档案?
→
添加 / 修改
姓名·电话·角色
→
变更 →
绑定房屋
→
房数 ≥ 1
1打开业主信息
左侧「房产 → 业主信息」。列表显示人脸、客户名称、人员类型、角色、房数、欠费、门禁钥匙等字段。
图 2-1 业主信息列表(客户名称、身份证、联系电话、备用手机已模糊)
图 2-1 业主信息列表(客户名称、身份证、联系电话、备用手机已模糊)
2点右上「添加」,填写基础信息
人员类型选「个人」,人员角色选业主 / 家庭成员 / 租客,填客户名称、联系电话(必填)、身份证(建议填)。可上传照片用于门禁人脸。
图 2-2 新增业主弹窗(联系电话是业主登录业主端的唯一凭据)
图 2-2 新增业主弹窗(联系电话是业主登录业主端的唯一凭据)
3绑定房屋
保存后在列表该行「操作」点「变更」→ 选择楼栋 / 单元 / 房号 → 保存。成功后该行「房数」变为 1。
字段必填填写要点
人员角色是业主本人 = 业主;同住家人 = 家庭成员;租客 = 租客
联系电话是业主登录业主端的唯一凭据,必须与业主实际手机号一致
身份证否用于实名认证,建议录入
同一房屋可以绑定多位业主(夫妻、家属)。建议「业主本人」只设一位,其余用「家庭成员」角色,这样账单归属和门禁权限不会乱。
姓名、电话、身份证属于个人信息。导出和截图必须脱敏,禁止外传。

2.2 房屋信息管理

菜单:房产 → 房屋管理 | 顺序:楼栋 → 单元 → 房屋
1建楼栋
顶部「添加楼栋」→ 填名称 / 编号 → 保存,左侧树出现「1 栋」。
2建单元
选中楼栋 → 「添加单元」→ 填名称 / 编号 → 保存。
3建房屋
选中单元 → 「添加房屋」→ 填房号、建筑面积、室内面积、房屋类型(住宅 / 办公室 / 商铺 / 车位)、房屋状态(未入住 / 已入住 / 已出租等)→ 保存。批量建档可用「房产导入」。
图 2-3 房屋管理(左树右表;业主列已模糊)
图 2-3 房屋管理(左树右表;业主列已模糊)
房号建议与门牌完全一致,业主报修时能一眼定位。「房屋状态」影响收费与报表口径,不要随手填。

2.3 收费管理

菜单:费用 → 费用项设置 / 房屋收费 / 员工收费 | 顺序:配费用项 → 生成账单 → 收款
① 费用项设置
定单价与周期
→
② 房屋收费
批量生成账单
→
业主怎么付?
→
③ 员工收费
现金 / POS
→
④ 缴费明细
营业报表 → 对账

① 配置费用项

1费用 → 费用项设置 → 新增
填写名称、计费方式(按面积 / 按户 / 固定)、单价、周期、费用类型。单价必须与物业服务合同一致。
图 2-4 费用项设置(计费方式与单价须与合同一致)
图 2-4 费用项设置(计费方式与单价须与合同一致)

② 生成账单

2费用 → 房屋收费 → 选费用项与账期 → 生成
生成后核对列表中的应收、实收、减免三列。批量操作前先小范围试生成一户,确认金额无误再全量。
图 2-5 房屋收费(按房屋列出,可批量操作)
图 2-5 房屋收费(按房屋列出,可批量操作)

③ 登记收款

3费用 → 员工收费 → 选房屋 / 业主 → 填实收金额与支付方式 → 保存并开票
「员工收费」页需要先选日期范围再查询,否则列表是空的。
图 2-6 员工收费(支付方式决定营业报表口径)
图 2-6 员工收费(支付方式决定营业报表口径)
三条底线:① 账单不要直接删除,应作废重开,保留痕迹;② 现金当日缴存,不得坐支;③ 不得以停水停电、停用门禁等方式催缴。
缴费明细里的「支付方式」决定营业报表的口径。线下收款选什么,报表就记什么;线上支付的支付方式来自支付通道上配置的「收款支付方式」,不是写死的「现金」。

2.4 报修管理

菜单:报修 → 报修待办 / 电话报修 / 报修回访 | 闭环:接单 → 派单 → 处理 → 回访
业主提交
业主端
→
报修待办
→
派单给师傅
→
能当场修好?
→
填结果
上传照片
→
回访 → 闭环
1接单与派单
报修 → 报修待办,查看业主提交的工单(房号、描述、图片),点「派单」选择师傅与上门时间。
图 2-7 报修待办列表
图 2-7 报修待办列表
2电话报修(代客建单)
业主来电时,用「电话报修」录入房号、类型、描述、电话、期望时间,替业主把单建上,避免口头传递丢失。
图 2-8 电话报修(客服代业主建单)
图 2-8 电话报修(客服代业主建单)
3处理与回访
师傅填处理结果并上传照片 → 客服在「报修回访」记录满意度;不满意的退回重派。
图 2-9 报修回访(当前环境无回访数据,界面结构示意)
图 2-9 报修回访(当前环境无回访数据,界面结构示意)
上门四件事:着工装、戴工牌、穿鞋套、完工清场。这四件事直接决定业主的满意度评分,比修得快更影响口碑。

2.5 支付配置与收款方式

菜单:费用 → 支付配置 | 影响:业主线上支付走哪个通道、营业报表按哪个支付方式统计
1查看已配置通道
列表显示已配置的通道(如「光大移动支付」)、支付范围、状态,操作列有修改 / 测试 / 删除。
图 2-10 支付配置列表(操作列:修改 / 测试 / 删除)
图 2-10 支付配置列表(操作列:修改 / 测试 / 删除)
2新增通道
点「添加」,填写名称、支付厂家、收款支付方式(必填)、支付范围、使用说明;下一步再填商户号与密钥。
图 2-11 新增支付通道(「收款支付方式」为必填)
图 2-11 新增支付通道(「收款支付方式」为必填)
字段说明
收款支付方式在线支付成功后写入缴费明细,营业报表按它汇总。光大通道默认「光大移动支付(9)」
签名方式 / 接口类型 / 商户类型一律下拉选择,避免手填错值(曾出现 RSA 这种非法值导致验签失败)
网关地址 / 对账单网关固定默认值,灰色只读;确需改测试地址时点「修改」解锁
终端IP取值方式FIXED = 用固定 IP;TERMINAL = 每笔取付款设备公网 IP(仅公众号 / 小程序支付有效)
商户终端IPFIXED 模式下必填,可点「刷新IP」取当前设备公网 IP
掩码不能改。密钥显示为 ********,保持原样保存即视为不修改;把星号改成别的值会把真实密钥覆盖掉。确需清空请用「清除该配置项」。
3控制收费页显示哪些支付方式
系统 →「小区配置」→ 配置类型选「收款支付方式」→ 勾选本小区要显示的支付方式 → 保存。
图 2-12 小区配置-收款支付方式(勾选的才出现在收费页)
图 2-12 小区配置-收款支付方式(勾选的才出现在收费页)
两层关系:小区配置决定「显示哪些支付方式」,支付通道决定「能不能真正付款」。两者都满足,业主才能线上付款。未勾选的支付方式不会出现在收费页。

2.6 报表与对账口径

报表取数逻辑口径要点
营业报表(营业日报)按日汇总缴费明细,支付方式列由报表 SQL 固定列名已补「押金退款到账户」「光大移动支付」两列;无流水的渠道显示 0.00
数据统计-按缴费方式字典表左连接缴费明细以字典为准全量展示,避免「没流水就整行消失」
业主缴费明细按订单 / 流水查询用于与支付渠道流水逐笔对账
金额为 0 有两种含义:① 该渠道本期确实没有成功收款;② 有下单但未付款(金额未回写)。区分方法:看缴费明细的「笔数」与订单状态,不要只看金额。

2.7 楼长配置

菜单:楼长配置 | 作用:业主在业主端点「联系物业」时,看到的正是这里配置的人

楼长是「某栋楼的物业联系人」,只存姓名 + 电话,不绑定系统员工账号——这样没有员工账号的物业公司也能配置。配置按楼栋粒度,同一栋可以配多名楼长,全部列出,由业主自己选打给谁。

1进入楼长配置
左侧菜单「楼长配置」。页面按当前选中的小区自动加载楼长列表和该小区的楼栋列表。
2新增楼长
点「新增楼长」→ 在弹窗里从下拉框选楼栋(不用手工填楼栋 ID,选中后楼栋号自动带出)→ 填楼长姓名、联系电话 → 保存。
3编辑与停用
点「编辑」改字段后保存;点「停用」确认后状态变为「停用」。停用是软删除,记录仍在列表里可追溯,但业主端不再显示该人。
规则说明
楼栋来源下拉选项来自「小区信息 → 楼栋管理」里已建档的楼栋,未建档则下拉为空
必填项楼栋、楼长姓名、联系电话,缺任一项会被拦截
同栋多楼长允许,系统不去重,按「楼栋 + 姓名 + 电话」存为独立记录
停用而非删除记录保留,状态变「停用」,业主端立即不再显示
切换小区顶部切换小区后,楼栋下拉与列表自动重载为新小区数据
生效时机保存后业主端立即生效,无需发布、无需重启
新小区上线时,如果楼长配置表是空的,业主点「联系物业」会回退到小区客服电话。上线前务必先录入楼长,否则业主看到的是统一客服号。
异常现象系统表现 / 处理
未选小区提示「请先选择小区」
小区还没建楼栋下拉为空,提示「请先在楼栋管理中建档」
楼栋列表加载失败提示「加载楼栋列表失败,请检查楼栋管理」,下拉置空,不会误存脏数据
越权操作其他小区服务端拒绝,提示「无权操作该小区的楼长配置」,数据不变
想恢复已停用的楼长点「编辑」把状态改回「有效」即可
楼长按楼栋粒度配置,不按单元或房屋。同一栋楼的所有业主看到的是同一批楼长;若需按单元差异化,需另行扩展。

2.8 设备与巡检

菜单:设备 → 设备中心 | 菜单:巡检 → 巡检计划 / 巡检任务

「设备中心」是设备与表具的统一入口,不依赖外部物联网平台。已启用的六个入口:门禁授权、充电桩、充电订单、水电表、保养计划、设备台账。

图 2-13 设备中心(门禁授权 / 充电桩 / 充电订单 / 水电表 / 保养计划 / 设备台账)
图 2-13 设备中心(门禁授权 / 充电桩 / 充电订单 / 水电表 / 保养计划 / 设备台账)
门禁道闸的远程控制、水电表的远程抄读与充值,需要对接外部物联网平台。当前未接入,下方入口均为本地已启用功能,数据直接来自本系统。

巡检闭环

设备台账
一机一档
→
配巡检点
与路线
→
生成
巡检计划
→
员工
到点扫码
→
是否正常?
→
提交记录
/ 挂牌建单
本章待补充设备台账建档、巡检点与路线配置、巡检计划生成、扫码巡检执行、异常上报与转维修、保养计划、巡检报表的具体操作步骤与截图。素材到位后在此处补充。

2.9 门禁与停车

菜单:停车 → 车位 / 月卡 / 在场车辆 | 菜单:设备 → 门禁授权

门禁授权用于维护门禁白名单与人员授权,与业主档案、房屋绑定关系联动;停车模块管理车位、月卡与在场车辆。

本章待补充门禁白名单维护、人员授权有效期、业主车位登记、月卡办理与续费、在场车辆查询与放行记录的操作步骤与截图。

2.10 公告与投诉

菜单:办公 → 公告 / 投诉建议

公告用于向业主推送通知与活动,投诉建议用于接收和处理业主反馈,与报修共用回访闭环。

本章待补充公告发布(标题、正文、推送范围)、公告列表与撤回、投诉建议的接单与回复、处理时限要求的操作步骤与截图。

2.11 员工与权限

菜单:办公 → 员工信息 / 组织信息 / 班次设置

员工账号、岗位角色、班次与负责片区的配置在这里维护。员工的可见范围由「角色 + 分配的小区」共同决定。

本章待补充员工新增、角色分配、小区授权、班次设置、密码重置规则(密码由员工本人管理,管理员不重置)的操作步骤与截图。

第三部分 业主端

使用端:手机浏览器 / 微信,访问 https://pm.aibiology.com.cn/owner/ 。业主端由物业在后台建档、生成账单后才有内容可看,业主看不到账单,九成是房屋没绑定或手机号不一致。

3.1 登录与房屋认证

步骤业主操作物业侧对应动作
1微信进入小程序 / 打开 H5,授权手机号登录业主档案中的「联系电话」须与登录手机号一致
2选择小区、楼栋、房号,提交房屋认证物业在「业主认证」中审核通过
待补截图 O-01 / O-02登录授权页、房屋认证页(需脱敏:姓名、房号打码,红框标出操作点)

3.2 缴费

步骤业主操作物业侧对应动作
3首页「缴费」查看待缴账单账单来自「房屋收费」生成的应收
4选择支付方式并完成支付支付成功回调写入缴费明细,支付方式按通道配置
5查看缴费记录、申请开票物业在「业主缴费明细」核对
业主端未部署时,可先用「员工收费」代业主收款验证报表口径:支付方式选「光大移动支付」,看营业报表对应列是否记对。
待补截图 O-03 ~ O-05首页与快捷入口、账单列表与详情、支付方式选择与支付结果页

3.3 报修与投诉

业主在业主端提交报修(可拍照、填写描述和期望上门时间),工单进入物业「报修待办」,后续由客服派单。处理完成后业主可查看进度并评价。

待补截图 O-06 / O-07提交报修(拍照、描述、期望时间)、报修进度与评价页

3.4 联系物业

入口:业主端首页 →「联系物业」

点「联系物业」后,系统会按当前登录业主名下的房屋,自动找到对应的楼栋,列出该栋的楼长;一屏分组展示,点任意一行即拨打该人电话。

系统怎么决定显示谁

点「联系物业」
→
已登录?
→
查名下房屋
服务端按登录态
→
按小区 + 楼栋
分组
→
该栋有楼长?
→
列楼长
/ 回退客服
规则说明
分组维度按「小区 + 楼栋」分组,标题形如「HC演示小区 · 1号楼」
多名楼长同一栋配了几名就列几行,不合并、不截断,由业主自己选
显示内容楼长姓名 + 电话,标注「楼长服务」
无楼长时该组显示「小区客服」+ 小区客服电话
多套房业主名下有多栋楼时,按楼栋分别列出多个分组
拨打方式手机浏览器唤起系统拨号盘
情况系统表现
未登录跳转登录页,不显示弹窗
未绑定房屋 / 查不到楼栋回退显示缓存中的「小区客服」电话
接口超时 / 失败回退小区客服,不白屏、不弹报错
小区没配客服电话提示「暂无物业联系电话」
业主一直看到小区客服、看不到楼长,按这个顺序查:① 物业后台是否已录入楼长;② 楼长状态是否为「有效」;③ 楼栋是否与业主房屋所属楼栋一致。

3.5 访客与门禁

业主可发起访客邀请,生成有效期内的通行凭证;门禁授权由物业在「设备 → 门禁授权」中维护。

待补截图 O-08访客邀请(有效期、二维码 / 密码)

3.6 月卡与停车

业主可自助办理与续费月卡,查看车位与在场记录。

待补截图 O-09月卡续费(车牌、有效期、支付)

第四部分 员工移动端

员工端 App 面向巡检、维修、秩序维护岗位,主要解决「现场」的问题:接单、扫码、拍照、上报。

4.1 接单与处理

工程人员在 App 上接收派单,到场后填写处理结果并上传现场照片,工单状态同步回管理后台。

本章待补充App 登录、工单列表、接单与到场、填写处理结果、上传照片、完工提交的操作步骤与截图。

4.2 扫码巡检

巡检人员按巡检计划的路线,到巡检点扫码打卡,逐项填写检查结果;发现异常可现场拍照、挂牌并直接建单转维修。

本章待补充巡检任务列表、扫码打卡、检查项填写、异常上报与拍照的操作步骤与截图。

4.3 抄表与现场记录

水电表抄读、现场问题记录等能力,视物联网平台对接情况启用;未对接时以手工录入为主。

本章待补充抄表录入、历史读数查询、异常读数处理的操作步骤与截图。

附录 A 常见问题

现象排查顺序
列表一片空白① 右上角小区是否选对 ② 是否点了「查询」 ③ 是否需要先选日期或条件 ④ 该菜单是否属于本岗位权限
弹窗打不开 / 按钮看不见多为前端缓存,按 Ctrl + Shift + R 强制刷新一次
保存提示「未填写值:xxx」该字段为必填(字段名后带 *)
业主端看不到账单① 是否绑定房屋 ② 档案电话与登录号是否一致 ③ 账单是否已生成
收费页没有某支付方式① 小区配置是否勾选 ② 该小区是否有启用的支付通道
营业报表某渠道金额为 0① 本期无成功收款 ② 有下单未支付 ③ 明细里支付方式是否记对
点「物联网」提示未部署该入口已改为本地「设备中心」;若仍跳外部,检查菜单是否被改回
业主端一直显示小区客服① 楼长配置表是否有数据 ② 状态是否有效 ③ 楼栋 ID 是否与业主房屋一致
楼长下拉是空的该小区在「楼栋管理」里还没建楼栋
保存楼长报「无权操作」当前登录账号是否被分配了该小区;是否切换到了别的小区
业主端还是旧界面浏览器缓存,地址栏加 ?v=20261114 或清缓存后重试

附录 B 术语表

术语含义
小区(Community)业务数据隔离单位,切换小区后看到的数据随之变化
楼栋(Floor)小区下的楼,如「1号楼」;楼长按楼栋配置
单元(Unit)楼栋下的单元门
房屋(Room)楼栋 - 单元 - 房号 三级定位,收费与报修都按房屋关联
业主(Owner)与房屋绑定的人,绑定后才能看到账单
费用项收费种类与计价规则(物业费、停车费等)
应收 / 实收 / 减免应缴金额、实际收到金额、减免金额
支付方式(prime_rate)缴费明细上的支付方式字典编码:1 现金 2 POS 3 微信 4 支付宝 7 转账 8 押金退款 9 光大移动支付
收款支付方式支付通道上配置的字典项,决定在线支付成功后记成哪种方式
支付范围1001 小区费用(兜底)/ 2002 临时停车费 / 3003 费用项
终端IP取值方式FIXED 用固定 IP;TERMINAL 每笔取付款设备公网 IP
楼长某栋楼的物业联系人,只存姓名 + 电话,不绑定系统账号
小区客服兜底联系人:某栋楼没配楼长时显示小区统一客服电话
停用软删除,数据保留可追溯,业主端不再显示
AppId各端调用接口的身份标识,平台端与物业端不同

附录 C 截图清单

下表用于补图时对照。已有 表示手册中已包含,待补 表示需要新采。

编号截图内容菜单路径状态
P-01物业公司列表(模块开关)数据 → 物业公司已有
P-02运营端小区支付费用 → 小区支付已有
P-03运营端新增通道弹窗同上 → 新增待补
M-01业主信息列表房产 → 业主信息已有
M-02新增业主弹窗同上 → 添加已有
M-03房屋管理房产 → 房屋管理已有
M-04费用项设置费用 → 费用项设置已有
M-05房屋收费费用 → 房屋收费已有
M-06员工收费费用 → 员工收费已有
M-07报修待办报修 → 报修待办已有
M-08电话报修报修 → 电话报修已有
M-09报修回访报修 → 报修回访已有
M-10支付配置列表费用 → 支付配置已有
M-11新增支付通道同上 → 添加已有
M-12小区配置-收款支付方式系统 → 小区配置已有
M-13设备中心设备 → 设备中心已有
M-14楼长配置列表楼长配置待补
M-15新增楼长弹窗(楼栋下拉)楼长配置 → 新增待补
M-16设备台账设备 → 设备台账待补
M-17巡检计划与巡检点巡检 → 巡检计划待补
M-18门禁白名单设备 → 门禁授权待补
M-19在场车辆停车 → 在场车辆待补
M-20公告发布办公 → 公告待补
O-01业主端登录授权业主端待补
O-02房屋认证业主端待补
O-03首页与快捷入口业主端待补
O-04账单列表与详情业主端待补
O-05在线支付与结果页业主端待补
O-06提交报修业主端待补
O-07报修进度与评价业主端待补
O-08访客邀请业主端待补
O-09月卡续费业主端待补
O-10联系物业(楼长分组)业主端首页待补
A-01员工端工单列表员工 App待补
A-02扫码巡检员工 App待补
补图要求:红框标注操作点;姓名、手机号、身份证、密钥一律脱敏;宽度统一 1280px;文件名与编号一致(如 M-14-louzhang-list.png)。

附录 D 浏览器与使用建议

项目建议
浏览器Chrome / Edge 最新版;不建议用 IE 或老旧内核浏览器
分辨率管理后台建议 1440×900 及以上,笔记本 1366×768 也可用
页面异常先 Ctrl + Shift + R 强制刷新,再排查权限与数据
导出与截图涉及业主个人信息的一律脱敏后再外发
金额与密钥两人复核;密钥字段保持掩码原样,不要手改星号
打印本手册可直接用浏览器「打印 → 另存为 PDF」,已做分页与配色优化

附录 E 版本记录

版本日期说明
V0.12026-10-25总纲:角色矩阵、架构图、业务流程图、章节结构、截图清单
V1.02026-10物业公司分册:系统简介 + 第 1–6 章 + 附录,含 11 张实拍截图
V1.02026-10-26多角色分册:增加平台运营方章节、报表对账口径
V2.02026-11-19整合成册:合并总纲与两份分册,统一术语与访问地址,新增楼长配置章节、设备中心、业主端联系物业说明;改为带左侧导航与在线编辑的单文件手册
本手册支持在线编辑:点击右上角「登录编辑」,输入口令后可直接在页面上修改文字、插入图片与视频,修改自动保存在本机浏览器,点「导出 HTML」可生成新版文件用于替换发布。