开发指南

# 【租客】租客管理、租客员工

友情提示： 该模块中的租客与招商模块中的租客具有相同的意义

租客模块，由 xcmd-module-asset 后端模块的 owner 包实现，主要有租客信息、租客员工等功能。如下图所示：

# 租客信息

租客信息，由 VillageController 提供接口。

# 1.表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段 
CREATE TABLE `owner` (
`id` bigint unsigned NOT NULL AUTO_INCREMENT COMMENT '编号',
`org_id` int DEFAULT NULL COMMENT '机构ID',
`name` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '租客名称',
`is_personal` tinyint NOT NULL DEFAULT '0' COMMENT '是否个人，1个人，0公司',
`is_suggest` smallint NOT NULL DEFAULT '0' COMMENT '是否推荐;0=不推荐;1=推荐;',
`type` smallint NOT NULL DEFAULT '0' COMMENT '目标对象;0=正常租客;1=收款对象;2=付款对象;',
`sham` smallint NOT NULL DEFAULT '0' COMMENT '虚拟身份注册;0=无;1=虚拟个人注册;2=虚拟企业注册;',
`contact_id` int DEFAULT NULL COMMENT '联系人',
`contact_sign_id` int DEFAULT NULL COMMENT '租客合同签署人id',
`contact_notice_id` int DEFAULT NULL COMMENT '缴费通知单联系人',
`approval_contact_id` int DEFAULT '0' COMMENT '审批联系人id',
`certificate_number` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '证件号码',
`industry_id` int DEFAULT NULL COMMENT '行业分类id',
`village_id_list` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '租客绑定的项目id,使用，隔开',
`build_bind` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '租客绑定的项目楼宇房源信息',
`tel` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '联系方式',
`email` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '邮箱',
`tenant_no` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '租客编码',
`website_link` varchar(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '官网地址',
`logo` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '企业logo',
`company_desc` mediumtext CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '企业简介',
`business_info_founding_time` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '成立日期',
`business_info_business_term` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '营业期限',
`registered_capital` decimal(28,2) DEFAULT NULL COMMENT '注册资金',
`invoice_info` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '开票信息-修改为默认发票模板',
`business_info` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '工商信息',
`tag_info` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '租客标签',
`diy_field` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '自定义字段',
`is_advance_notice` smallint DEFAULT '0' COMMENT '是否开启公司代付通知',
`is_archive` smallint DEFAULT '0' COMMENT '是否归档',
`bank` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '开户行',
`account` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '账号',
`bank_phone` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '电话',
`taxpayer_identification_number` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '纳税人识别号',
`invoice_type` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '发票类型0=增值税普通发票1=增值税专用发票2=增值税电子普通发票',
`billing_address` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '开票地址',
PRIMARY KEY (`id`) USING BTREE,
KEY `idx_org_id` (`org_id`) USING BTREE,
KEY `idx_contact_id` (`contact_id`) USING BTREE,
KEY `idx_industry_id` (`industry_id`) USING BTREE,
KEY `idx_business_info_founding_time` (`business_info_founding_time`) USING BTREE,
KEY `idx_business_info_business_term` (`business_info_business_term`) USING BTREE,
KEY `idx_contact_notice_id` (`contact_notice_id`) USING BTREE,
KEY `idx_contact_sign_id` (`contact_sign_id`) USING BTREE,
KEY `idx_village_id` (`village_id_list`) USING BTREE,
KEY `idx_advance_notice` (`is_advance_notice`) USING BTREE,
KEY `idx_is_suggest` (`is_suggest`) USING BTREE,
KEY `idx_is_archive` (`is_archive`) USING BTREE,
KEY `idx_approval_contact_id` (`approval_contact_id`) USING BTREE,
KEY `idx_type` (`type`) USING BTREE,
KEY `idx_sham` (`sham`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=193 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

# 2.管理后台

对应 [资产管理系统 -> 租客 -> 租客列表] 菜单，对应 xhrt-admin 项目的 @/views/bus/owner 目录。

# 租客员工

租客员工，由 VillageUserController 提供接口。

# 1.表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段 
CREATE TABLE `village_user` (
`id` bigint unsigned NOT NULL AUTO_INCREMENT COMMENT '编号',
`uniqid_id` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '人员针对房间的唯一编号',
`user_id` int DEFAULT NULL COMMENT '用户表ID，可能为空',
`owner_id` int DEFAULT NULL COMMENT '归属租客ID',
`build_id` int DEFAULT NULL COMMENT '楼栋ID',
`org_id` int DEFAULT NULL COMMENT '部门ID',
`village_id` int DEFAULT NULL COMMENT '项目ID',
`name` varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '人员名称（128位加密）',
`phone` varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '人员手机号（128位加密）',
`email` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '住户联系邮箱',
`address` varchar(150) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '通讯地址',
`is_default` tinyint NOT NULL DEFAULT '0' COMMENT '是否为默认租客住户联系人',
`type` smallint DEFAULT NULL COMMENT '0+房主，10+家属，20+租户，30+物业人员，40+服务人员，50+访客',
`effective_time_start` timestamp NULL DEFAULT NULL COMMENT '有效期开始（特别指访客）',
`effective_time_end` timestamp NULL DEFAULT NULL COMMENT '有效期结束（特别指访客）',
`idcard_type` enum('idcard','gangaotai','passport') CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT 'idcard' COMMENT '证件类型（大陆身份证、港澳台、护照等）',
`idcard` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '证件号（128位加密）',
`birth_year` smallint DEFAULT NULL COMMENT '出生年（年月日尽量从身份证中获取）',
`birth_month` smallint DEFAULT NULL COMMENT '出生月（年月日尽量从身份证中获取）',
`birth_day` smallint DEFAULT NULL COMMENT '出生日（年月日尽量从身份证中获取）',
`sex` tinyint DEFAULT '0' COMMENT '性别（1男，2女，0未知）（年月日尽量从身份证中获取）',
`edu_type` tinyint DEFAULT NULL COMMENT '学历信息',
`work_year` varchar(30) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '工作年限',
`grad_school` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '毕业院校',
`sk_cert` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '技能证书',
`idcard_img` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '身份证照片(包含手持身份证图片){"front_url":"","back_url":"","hand_url":""}',
`photo` varchar(1000) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '照片网址（128加密）,后期若有多个用英文逗号分割',
`photo_status` tinyint DEFAULT '10' COMMENT '照片数据状态（0+正常，10+审核中，20+失败）',
`photo_status_desc` tinyint DEFAULT NULL COMMENT '照片状态的描述文本（一般用于状态失败原因描述）',
`in_advance` smallint DEFAULT '0' COMMENT '是否拥有代付权限',
`in_advance_notice` smallint DEFAULT '0' COMMENT '是否代付通知',
`status` tinyint NOT NULL DEFAULT '0' COMMENT '数据状态（0审核中，1正常，4拒绝）',
`last_choose_time` datetime DEFAULT NULL COMMENT '租客端最后选择此身份的时间',
PRIMARY KEY (`id`) USING BTREE,
UNIQUE KEY `unique_uniqid_village_id` (`uniqid_id`,`village_id`) USING BTREE,
KEY `idx_village_id` (`village_id`) USING BTREE,
KEY `idx_user_id` (`user_id`) USING BTREE,
KEY `idx_owner_id` (`owner_id`) USING BTREE,
KEY `idx_build_id` (`build_id`) USING BTREE,
KEY `idx_is_default` (`is_default`) USING BTREE,
KEY `idx_in_advance` (`in_advance`) USING BTREE,
KEY `idx_advance_notice` (`in_advance_notice`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=26 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

# 2.管理后台

对应 [资产管理系统 -> 租客 -> 租客员工管理] 菜单，对应 xhrt-admin 项目的 @/views/village/Architecture 目录

更新时间: 6/14/2025, 10:20:11 AM

← 【招商】招商信息、线索 →