开发指南

# 【物业】工单维修、水电抄表

物业模块，由 xcmd-module-asset 后端模块的 workOrder（工单）、energy（水电表） 包实现，主要有工单管理、水电抄表等功能。如下图所示：

# 工单维修

工单维修，由 WorkOrderProposeController 提供接口。

# 1.表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段 
CREATE TABLE `workorder_propose` (
`id` bigint unsigned NOT NULL AUTO_INCREMENT COMMENT '编号',
`org_id` bigint DEFAULT NULL COMMENT '机构ID',
`application` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '应用标识',
`repair_type` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '1' COMMENT '报修类型;1=室内报修;2=公共区域报修;',
`order_type` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '1' COMMENT '工单类型;1=普通工单;2=付费工单;',
`paid_type` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '1' COMMENT '收费方式;1=免费服务;2=下单即收费;3=完成后收费;',
`is_need_pay` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '0' COMMENT '是否立即支付待支付0=完成后收费/免费;1=待支付;2=已支付',
`paid_status` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '0' COMMENT '工单订单状态;2=已支付;3=已退款;',
`paid_payer` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '0' COMMENT '费用支付方;1=租客承担;2=机构承担;',
`number` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '工单编号',
`category_id` bigint NOT NULL DEFAULT '0' COMMENT '工单大类id',
`subcat_id` bigint NOT NULL DEFAULT '0' COMMENT '工单子类id',
`name` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '上报人名称',
`phone` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '上报人手机',
`appear_time` datetime DEFAULT NULL COMMENT '上报时间',
`visit_time` datetime DEFAULT NULL COMMENT '上门时间',
`reserve_start_time` datetime DEFAULT NULL COMMENT '预约起始时间',
`reserve_end_time` datetime DEFAULT NULL COMMENT '预约结束时间',
`wait_time` datetime DEFAULT NULL COMMENT '等待起始时间',
`position` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '指定位置信息',
`label_json` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '描述标签json',
`remark` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '补充内容',
`images` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '上报图片json;支持多张',
`village_id` bigint DEFAULT NULL COMMENT '项目id',
`build_id` bigint DEFAULT NULL COMMENT '楼宇id',
`room_ids` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '房间id集合【选择室内时使用】',
`owner_id` bigint DEFAULT NULL COMMENT '租客id',
`post_uids` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '当前工单所属岗位处理人json',
`from` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '工单来源',
`source` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '操作来源',
`work_app` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '工单来源应用标识',
`task_id` bigint DEFAULT NULL COMMENT '巡检任务id',
`record_id` bigint DEFAULT NULL COMMENT '第三方发起工单的id（例如巡检整改记录id、资产维修单id）',
`record_id2` bigint DEFAULT NULL COMMENT '第三方发起工单的第二个id（例如资产维修单的资产id）',
`is_timeout` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '0' COMMENT '是否超时;0=否;1=是;',
`is_change` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '0' COMMENT '是否可抢单;0=否;1=是;',
`is_assign` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '0' COMMENT '可抢单是否转未指派;0=否;1=是;',
`timeout_time` datetime DEFAULT NULL COMMENT '超时起始时间',
`change_time` datetime DEFAULT NULL COMMENT '可抢单起始时间',
`rob_time` datetime DEFAULT NULL COMMENT '可抢单结束时间',
`status` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '1' COMMENT '工单状态;1=未指派,2=已指派,3=处理中,4=已办结',
`appraise_level` int DEFAULT '0' COMMENT '评价等级;1-5星',
`has_notice` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '0' COMMENT '是否通知',
`has_refund` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '1' COMMENT '是否支持退款;0=否;1=是;',
`has_open` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '1' COMMENT '是否能重新打开;0=否;1=是;',
`followup_uid` bigint DEFAULT '0' COMMENT '跟进人uid',
`rob_uid` bigint DEFAULT '0' COMMENT '抢单人uid',
PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=53 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci ROW_FORMAT=DYNAMIC COMMENT='机构工单数据表';
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

# 2.管理后台

对应 [资产管理系统 -> 物业 -> 物业报修 -> 工单列表] 菜单，对应 xhrt-admin 项目的 @/views/bus/application/Category/workOrderList 目录。

# 水电抄表

水电抄表，由 AppEnergyController 提供接口。

# 1.表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段 
CREATE TABLE `energy` (
`id` bigint unsigned NOT NULL AUTO_INCREMENT COMMENT '编号',
`type` bigint NOT NULL DEFAULT '1' COMMENT '设备表种类',
`org_id` bigint DEFAULT NULL COMMENT '机构ID',
`village_id` bigint NOT NULL DEFAULT '0' COMMENT '项目ID',
`build_id` bigint NOT NULL DEFAULT '0' COMMENT '楼宇ID',
`purpose` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '用途 1-分表 2-总表 3-公摊表',
`name` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '名称',
`number` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '表具编号',
`magnification` decimal(19,2) NOT NULL DEFAULT '0.00' COMMENT '倍率',
`original_reading` decimal(19,2) NOT NULL DEFAULT '0.00' COMMENT '原始读数',
`max_reading` decimal(19,2) NOT NULL DEFAULT '0.00' COMMENT '最大读数',
`meter_time` date DEFAULT NULL COMMENT '抄录时间',
`public_type` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '公摊方式 1-不公摊 2-按分表用量比例公摊 3-按租客租赁面积比例公摊 4-按房源数量平均公摊',
`builds` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '授予用户管理的项目和楼宇，json存储',
`layer_ids` varchar(5000) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '楼层id,1,2,3',
`room_ids` varchar(5000) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '绑定房间信息，1,2,3',
`contract_ids` varchar(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '合同ids',
`remark` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
`status` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '0' COMMENT '状态，1启动，0审核中，4禁用',
`device_id` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '厂商id',
`device_type` varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '设备类型',
`device_serial` varchar(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '设备序列号',
`property_id` bigint NOT NULL DEFAULT '0' COMMENT '资产的ID',
`device_off` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '1' COMMENT '设备通断状态 0通，1断',
`device_status` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '0' COMMENT '设备状态 0无 1离线 2断电 3电量过低',
`last_heart_time` datetime DEFAULT NULL COMMENT '上次心跳时间',
`remote_valve_control` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '1' COMMENT '是否开启远程阀控/1是0否',
`is_remind` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '是否提醒过 1是0否、send_remind_value(低于提醒值)，send_zero_value（小于0）',
`current_remaining` decimal(10,2) DEFAULT '0.00' COMMENT '当前余量',
`payment_type` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '0' COMMENT '付费类型 0是后付费 1是预付费',
PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=20 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci ROW_FORMAT=DYNAMIC COMMENT='自定义表';
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

# 2.管理后台

对应 [资产管理系统 -> 物业 -> 水电抄表 ] 菜单，对应 xhrt-admin 项目的 @/views/bus/application/WaterElectricity/Tablemanage 目录

更新时间: 6/14/2025, 3:02:16 PM

← ERP演示 →