开发指南

# 【建筑】资产信息、楼宇、房间

友情提示： 该系统中资产、建筑、项目三者是一个意思。

资产模块，由 xcmd-module-asset 后端模块的 village 包实现，主要有资产信息、楼宇、房间等功能。如下图所示：

# 资产信息

资产信息，由 VillageController 提供接口。

# 1.表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段 
CREATE TABLE `village` (
  `id` bigint unsigned NOT NULL AUTO_INCREMENT COMMENT '编号',
  `name` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目名称',
  `short_name` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目名称缩写',
  `describe` varchar(5000) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目介绍',
  `logo` varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目LOGO',
  `district_txt` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目省市区地址',
  `address` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目详细地址',
  `lng` decimal(10,6) DEFAULT NULL COMMENT '落座经度（gcj02）',
  `lat` decimal(10,6) DEFAULT NULL COMMENT '落座纬度（gcj02）',
  `management_area` decimal(16,2) DEFAULT '0.00' COMMENT '管理面积',
  `rentable_area` decimal(16,2) DEFAULT '0.00' COMMENT '可招商面积',
  `room_rentable_count` int DEFAULT '0' COMMENT '可招商房源数量',
  `room_count` int DEFAULT '0' COMMENT '总房源数量',
  `tag_id_arr` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '标签（数组存储）',
  `wechat_number` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目公众号的微信号',
  `status` tinyint NOT NULL DEFAULT '1' COMMENT '数据状态',
  `three_dimensional_file` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '3D模型',
  `three_dimensional_id` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '3D模型物体ID',
  `dimensional_bg_img` varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '楼宇图片',
  `room_status_color` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '房源到期的颜色值数组',
  `org_id` int NOT NULL DEFAULT '0' COMMENT '当前管理的机构ID',
  `country_id` int NOT NULL DEFAULT '0' COMMENT '国家ID',
  `province_id` bigint NOT NULL DEFAULT '0' COMMENT '省份ID',
  `city_id` bigint NOT NULL DEFAULT '0' COMMENT '城市ID',
  `district_id` bigint NOT NULL DEFAULT '0' COMMENT '区县ID',
  `street_id` bigint NOT NULL DEFAULT '0' COMMENT '街道/乡镇ID',
  `community_id` bigint NOT NULL DEFAULT '0' COMMENT '社区/村ID',
  `room_min_price` decimal(10,2) DEFAULT NULL COMMENT '房间最低单价（月）',
  `room_average_price` decimal(10,2) DEFAULT NULL COMMENT '房间平均单价（月）',
  `traffic_info` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '附近公共交通相关信息',
  `type` varchar(30) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '业态',
  `extra_config` varchar(1024) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '额外扩展配置',
  `vr_link` varchar(5000) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'vr链接',
  `video` varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '视频地址',
  `vr_video_sort` tinyint NOT NULL DEFAULT '0' COMMENT 'VR视频导致的排序（VR和视频30，VR20，视频10，没有0）',
  `month_hits` int NOT NULL DEFAULT '0' COMMENT '月浏览数（计划任务统计）',
  `sort` int DEFAULT NULL COMMENT '排序值',
  `micro_service_config` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '围绕项目服务的子项目配置信息，例如人脸识别设备',
  `street_code` char(9) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '街道编码',
  `village_type` varchar(100) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '楼宇类型',
  PRIMARY KEY (`id`) USING BTREE,
  KEY `idx_org_id` (`org_id`) USING BTREE,
  KEY `idx_type` (`type`) USING BTREE,
  KEY `idx_sort` (`sort`) USING BTREE,
  KEY `idx_country_id` (`country_id`) USING BTREE,
  KEY `idx_province_id` (`province_id`) USING BTREE,
  KEY `idx_city_id` (`city_id`) USING BTREE,
  KEY `idx_district_id` (`district_id`) USING BTREE,
  KEY `idx_street_id` (`street_id`) USING BTREE,
  KEY `idx_community_id` (`community_id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=13 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
51
52

# 2.管理后台

对应 [资产管理系统 -> 建筑 -> 园区列表] 菜单，对应 xhrt-admin 项目的 @/views/village/Campus 目录。

# 楼宇

楼宇，由 BuildController 提供接口。

# 1.表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段 
CREATE TABLE `village_build` (
  `id` bigint unsigned NOT NULL AUTO_INCREMENT COMMENT '编号',
  `build_number` varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '楼栋编号',
  `build_name` varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '楼栋名称',
  `logo` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '楼宇lOGO',
  `zone_id` int DEFAULT NULL COMMENT '分区ID',
  `village_id` int DEFAULT NULL COMMENT '项目ID',
  `have_unit` tinyint NOT NULL DEFAULT '0' COMMENT '有没有单元，1有，0没有',
  `district_txt` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '项目省市区地址',
  `country_id` int NOT NULL DEFAULT '0' COMMENT '国家ID',
  `province_id` bigint NOT NULL DEFAULT '0' COMMENT '省份ID',
  `city_id` bigint NOT NULL DEFAULT '0' COMMENT '城市ID',
  `district_id` bigint NOT NULL DEFAULT '0' COMMENT '区县ID',
  `street_id` bigint NOT NULL DEFAULT '0' COMMENT '街道/乡镇ID',
  `community_id` bigint NOT NULL DEFAULT '0' COMMENT '社区/村ID',
  `lng` decimal(10,6) DEFAULT NULL COMMENT '落座经度（gcj02）',
  `lat` decimal(10,6) DEFAULT NULL COMMENT '落座纬度（gcj02）',
  `address` varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '地址',
  `floor_height` decimal(11,2) DEFAULT NULL COMMENT '标准层高',
  `property_right` varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '产权性质',
  `build_area` decimal(11,2) DEFAULT NULL COMMENT '建筑面积',
  `property_area` decimal(11,2) DEFAULT NULL COMMENT '产权面积',
  `rentable_area` decimal(11,2) DEFAULT NULL COMMENT '可租面积',
  `self_use_area` decimal(11,2) DEFAULT NULL COMMENT '自用面积',
  `supporting_area` decimal(11,2) DEFAULT NULL COMMENT '配套面积',
  `property_number` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '产权编号',
  `land_number` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '土地编号',
  `estate_number` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '不动产证编号',
  `parking_area` decimal(11,2) DEFAULT NULL COMMENT '车位面积',
  `parking_count` int DEFAULT NULL COMMENT '车位数量',
  `management_area` decimal(11,2) DEFAULT NULL COMMENT '管理面积',
  `room_count` int NOT NULL DEFAULT '0' COMMENT '房间总数',
  `rent_in_area` decimal(11,2) DEFAULT '0.00' COMMENT '在租面积',
  `rent_in_room` int NOT NULL DEFAULT '0' COMMENT '在租房间数',
  `rent_in_contract` int NOT NULL DEFAULT '0' COMMENT '在租合同数',
  `invitation_room_count` int NOT NULL DEFAULT '0' COMMENT '招商房间总数',
  `revenue_target` json DEFAULT NULL COMMENT '营收目标(数组存储)',
  `account_default` int DEFAULT NULL COMMENT '默认收支账户',
  `extra_config` json DEFAULT NULL COMMENT '默认配置',
  `tag_info` json DEFAULT NULL COMMENT '楼宇标签',
  `is_hot` tinyint NOT NULL DEFAULT '0' COMMENT '是否热门',
  `sort` int NOT NULL DEFAULT '0' COMMENT '排序，越大越前',
  `status` tinyint NOT NULL DEFAULT '1' COMMENT '数据状态(1使用，0隐藏)',
  `three_dimensional_file` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '3D模型',
  `three_dimensional_id` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '3D模型物体ID',
  `dimensional_bg_img` varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '实景图',
  `org_id` int DEFAULT '0' COMMENT '当前管理的机构ID',
  PRIMARY KEY (`id`) USING BTREE,
  KEY `idx_zone_id` (`zone_id`) USING BTREE,
  KEY `idx_village_id` (`village_id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=23 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
51

# 2.管理后台

对应 [资产管理系统 -> 建筑 -> 建筑列表] 菜单，对应 xhrt-admin 项目的 @/views/village/Architecture 目录

# 房间

房间，由 RoomController 提供接口。

# 1.表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段 
CREATE TABLE `village_room` (
  `id` bigint unsigned NOT NULL AUTO_INCREMENT COMMENT '编号',
  `room_number` int DEFAULT NULL COMMENT '房间编号',
  `room_name` varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '房间名称',
  `room_alias_id` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '' COMMENT '房间管理编号',
  `parent_room_id` int DEFAULT NULL COMMENT '父级房间编号',
  `sub_room_count` smallint DEFAULT '0' COMMENT '子房间总数',
  `sub_room_rent_count` smallint DEFAULT '0' COMMENT '子房间已租总数',
  `build_area` decimal(12,2) DEFAULT NULL COMMENT '建筑面积',
  `inside_area` decimal(12,2) DEFAULT NULL COMMENT '套内面积（实际使用面积）',
  `rental_area` decimal(12,2) DEFAULT NULL COMMENT '计租面积',
  `rental_area_in` decimal(12,2) DEFAULT NULL COMMENT '计租面积（在租）',
  `charging_area` decimal(12,2) DEFAULT NULL COMMENT '计费面积',
  `charging_area_in` decimal(12,2) DEFAULT NULL COMMENT '计费面积（在租）',
  `lease_start` datetime DEFAULT NULL COMMENT '租赁开始时间',
  `lease_end` datetime DEFAULT NULL COMMENT '租赁结束时间',
  `deliver_time` datetime DEFAULT NULL COMMENT '交付时间',
  `invitation_status` tinyint DEFAULT NULL COMMENT '1招商，0不招商（出租后默认设置不招商）',
  `investment_policy` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '招商政策',
  `investment_conditions` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '招商条件',
  `images` longtext CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '图集数组',
  `price_unit` enum('square_month','square_day','month','day','year') CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '价格单位',
  `price_unit_min` enum('square_month','square_day','month','day','year') CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '底价单位',
  `pre_unit_price` decimal(10,2) DEFAULT NULL COMMENT '预租单价',
  `pre_unit_price_min` decimal(10,2) DEFAULT NULL COMMENT '最低价格',
  `tag_id_arr` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '房源标签ID数组',
  `contract_info` longtext CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '合同情况，记录时间、执行情况，用于判断是否逾期',
  `contract_count` int DEFAULT '0' COMMENT '在租合同数',
  `decoration` enum('exquisite','simple','none','standard','luxury') CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '装修情况',
  `property_right` varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '产权性质',
  `floor_height` decimal(10,4) DEFAULT NULL COMMENT '标准层高',
  `load_max` varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '荷载值',
  `layer_id` int DEFAULT NULL COMMENT '楼层ID',
  `unit_id` int DEFAULT NULL COMMENT '单元ID',
  `build_id` int DEFAULT NULL COMMENT '楼栋ID',
  `zone_id` int DEFAULT NULL COMMENT '分区ID',
  `village_id` int DEFAULT NULL COMMENT '项目ID',
  `sort` int DEFAULT '0' COMMENT '排序，越大越前',
  `status` tinyint unsigned DEFAULT '1' COMMENT '数据状态(1公开，2隐藏，0关闭)',
  `three_dimensional_id` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '' COMMENT '3D模型物体ID',
  `room_status` tinyint DEFAULT '10' COMMENT '状态(<10空置状态，<20已预订，<30出租中)',
  `house_type` varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '房源类型',
  `record_no` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '房源备案号',
  `promoter_money` decimal(10,2) DEFAULT NULL COMMENT '推广佣金',
  `promoter_money_unit` varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '推广佣金单位',
  `extra_config` longtext CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '额外扩展配置',
  `vr_link` varchar(5000) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'vr链接',
  `video` varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '视频地址',
  `vr_video_sort` tinyint DEFAULT '0' COMMENT 'VR视频导致的排序（VR和视频30，VR20，视频10，没有0）',
  `month_hits` int DEFAULT '0' COMMENT '月浏览数（计划任务统计）',
  `split_parent_area` tinyint DEFAULT '0' COMMENT '是否占用了父房间的面积',
  `is_lock` tinyint DEFAULT '0' COMMENT '是否锁定房源(1锁定，0正常(取消锁定))',
  `is_unreal` smallint DEFAULT '0' COMMENT '0=真实房间;1=非真实房间',
  `extra_lock` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '锁定房源面积信息',
  `price_unit_max` enum('square_month','square_day','month','day','year') COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '高价单位',
  `price_unit_ave` enum('square_month','square_day','month','day','year') COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '均价单位',
  `pre_unit_price_max` decimal(10,2) DEFAULT NULL COMMENT '最高价格',
  `pre_unit_price_ave` decimal(10,2) DEFAULT NULL COMMENT '平均价格',
  PRIMARY KEY (`id`) USING BTREE,
  KEY `idx_layer_id` (`layer_id`) USING BTREE,
  KEY `idx_unit_id` (`unit_id`) USING BTREE,
  KEY `idx_build_id` (`build_id`) USING BTREE,
  KEY `idx_zone_id` (`zone_id`) USING BTREE,
  KEY `idx_village_id` (`village_id`) USING BTREE,
  KEY `idx_status` (`status`) USING BTREE,
  KEY `idx_contract_count` (`contract_count`) USING BTREE,
  KEY `idx_room_status` (`room_status`) USING BTREE,
  KEY `idx_creator` (`creator`) USING BTREE,
  KEY `idx_is_lock` (`is_lock`) USING BTREE,
  KEY `idx_parent_room_id` (`parent_room_id`) USING BTREE,
  KEY `idx_room_alias_id` (`room_alias_id`) USING BTREE,
  KEY `idx_is_unreal` (`is_unreal`) USING BTREE,
  KEY `idx_deliver_time` (`deliver_time`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=783 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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

# 2.管理后台

对应 [资产管理系统 -> 建筑 -> 租控管理] 菜单，对应 xhrt-admin 项目的 @/views/village/managementCenter 目录

更新时间: 6/13/2025, 5:13:16 PM

← 【租客】租客管理、租客员工 →