hzdyjs/docs/需求文档/心理咨询预约需求/心理咨询预约系统需求说明.md

心理健康系统-心理咨询预约功能需求说明（xljk_consultation）

1. 项目定位

• 一级模块：心理健康系统（Mental Health System）
• 二级功能：心理咨询预约（Consultation Appointment）
• 功能标识前缀：xljk_consultation
• 其他二级功能举例：心理健康测评（xljk_evaluation）、心理危机干预等

2. 主要功能

2.1 预约时段管理（心理健康管理员）

• 设置咨询师工作日历（可选上午/下午、时间段、最大预约数、状态）
• 支持批量配置、复制、日历/表格视图

2.2 预约申请与处理

• 学生自主预约
• 咨询师处理预约（确认/拒绝/记录到访情况/填写咨询内容）
• 预约三次不到自动限制

2.3 咨询记录管理

• 咨询师填写沟通时长、内容
• 历史记录可查

2.4 统计与报表

• 按学期统计预约数、到访数、到访率、沟通时长
• 支持班级、专业等维度

2.5 角色权限

• 管理员：配置时段、管理咨询师、查阅统计
• 咨询师：处理预约、填写记录、查阅统计
• 班主任：查阅本班学生预约情况
• 学生：自主预约、查阅个人记录

3. 数据结构设计（表名全部以xljk_consultation_为前缀）

3.1 咨询师表（xljk_consultation_counselor）

字段名	类型	说明
id	bigint(20) NOT NULL	主键ID
tenant_id	varchar(20) NOT NULL DEFAULT '000000'	租户编号
create_dept	bigint(20) DEFAULT NULL	创建部门
create_by	bigint(20) DEFAULT NULL	创建者
create_time	datetime DEFAULT NULL	创建时间
update_by	bigint(20) DEFAULT NULL	更新者
update_time	datetime DEFAULT NULL	更新时间
deleted	tinyint(1) DEFAULT 0	删除标志（0代表存在 1代表删除）
name	varchar(50)	咨询师姓名
work_no	varchar(20)	工号
title	varchar(50)	职称
specialty	varchar(255)	专长领域
introduction	text	简介
status	char(1)	状态（0正常 1停用）

3.2 预约时段表（xljk_consultation_schedule）

字段名	类型	说明
id	bigint(20) NOT NULL	主键ID
tenant_id	varchar(20) NOT NULL DEFAULT '000000'	租户编号
create_dept	bigint(20) DEFAULT NULL	创建部门
create_by	bigint(20) DEFAULT NULL	创建者
create_time	datetime DEFAULT NULL	创建时间
update_by	bigint(20) DEFAULT NULL	更新者
update_time	datetime DEFAULT NULL	更新时间
deleted	tinyint(1) DEFAULT 0	删除标志（0代表存在 1代表删除）
counselor_id	bigint(20)	咨询师ID
schedule_date	date	日期
morning_enabled	tinyint(1)	上午启用
morning_start_time	time	上午开始
morning_end_time	time	上午结束
afternoon_enabled	tinyint(1)	下午启用
afternoon_start_time	time	下午开始
afternoon_end_time	time	下午结束
max_appointments	int	最大预约数
current_appointments	int	当前预约数
status	char(1)	0可预约 1已满 2停用

3.3 预约记录表（xljk_consultation_appointment）

字段名	类型	说明
id	bigint(20) NOT NULL	主键ID
tenant_id	varchar(20) NOT NULL DEFAULT '000000'	租户编号
create_dept	bigint(20) DEFAULT NULL	创建部门
create_by	bigint(20) DEFAULT NULL	创建者
create_time	datetime DEFAULT NULL	创建时间
update_by	bigint(20) DEFAULT NULL	更新者
update_time	datetime DEFAULT NULL	更新时间
deleted	tinyint(1) DEFAULT 0	删除标志（0代表存在 1代表删除）
student_id	bigint(20)	学生ID
student_name	varchar(50)	学生姓名
student_no	varchar(20)	学号
phone	varchar(20)	手机号
major	varchar(100)	专业
class_name	varchar(50)	班级
counselor_id	bigint(20)	咨询师ID
schedule_id	bigint(20)	预约时段ID
appointment_date	date	预约日期
time_slot	char(1)	0上午 1下午
status	char(1)	0待处理 1已确认 2已完成 3已取消 4未到访
apply_time	datetime	申请时间
process_time	datetime	处理时间
process_remark	varchar(500)	处理备注

3.4 咨询记录表（xljk_consultation_record）

字段名	类型	说明
id	bigint(20) NOT NULL	主键ID
tenant_id	varchar(20) NOT NULL DEFAULT '000000'	租户编号
create_dept	bigint(20) DEFAULT NULL	创建部门
create_by	bigint(20) DEFAULT NULL	创建者
create_time	datetime DEFAULT NULL	创建时间
update_by	bigint(20) DEFAULT NULL	更新者
update_time	datetime DEFAULT NULL	更新时间
deleted	tinyint(1) DEFAULT 0	删除标志（0代表存在 1代表删除）
appointment_id	bigint(20)	预约记录ID
visit_status	char(1)	0正常到访 1未到访
duration	int	沟通时长（分钟）
content	text	咨询内容

3.5 未到访记录表（xljk_consultation_no_show）

字段名	类型	说明
id	bigint(20) NOT NULL	主键ID
tenant_id	varchar(20) NOT NULL DEFAULT '000000'	租户编号
create_dept	bigint(20) DEFAULT NULL	创建部门
create_by	bigint(20) DEFAULT NULL	创建者
create_time	datetime DEFAULT NULL	创建时间
update_by	bigint(20) DEFAULT NULL	更新者
update_time	datetime DEFAULT NULL	更新时间
deleted	tinyint(1) DEFAULT 0	删除标志（0代表存在 1代表删除）
student_id	bigint(20)	学生ID
appointment_id	bigint(20)	预约记录ID
no_show_date	date	未到访日期
expire_date	date	限制到期日
status	char(1)	0生效中 1已过期 2已解除

4. API设计（全部以/xljk/consultation为前缀）

4.1 预约时段管理

• GET /api/xljk/consultation/schedule/list
• GET /api/xljk/consultation/schedule/{id}
• POST /api/xljk/consultation/schedule
• PUT /api/xljk/consultation/schedule
• DELETE /api/xljk/consultation/schedule/{ids}
• POST /api/xljk/consultation/schedule/batch
• POST /api/xljk/consultation/schedule/copy
• GET /api/xljk/consultation/schedule/calendar

4.2 预约管理

• GET /api/xljk/consultation/appointment/list
• GET /api/xljk/consultation/appointment/{id}
• POST /api/xljk/consultation/appointment/apply
• POST /api/xljk/consultation/appointment/process
• POST /api/xljk/consultation/appointment/record
• GET /api/xljk/consultation/appointment/record/{appointmentId}
• POST /api/xljk/consultation/appointment/cancel
• GET /api/xljk/consultation/appointment/student

4.3 咨询师管理

• GET /api/xljk/consultation/counselor/list
• GET /api/xljk/consultation/counselor/{id}
• POST /api/xljk/consultation/counselor
• PUT /api/xljk/consultation/counselor
• DELETE /api/xljk/consultation/counselor/{ids}

4.4 统计与报表

• GET /api/xljk/consultation/statistics/overview
• GET /api/xljk/consultation/statistics/by-class
• GET /api/xljk/consultation/statistics/by-major
• GET /api/xljk/consultation/statistics/by-semester

4.5 预约限制管理

• GET /api/xljk/consultation/no-show/list # 查询未到访记录列表
• GET /api/xljk/consultation/no-show/{id} # 获取未到访记录详情
• PUT /api/xljk/consultation/no-show/{id}/release # 解除预约限制
• GET /api/xljk/consultation/no-show/check-limitation # 检查学生是否被限制预约

5. 权限标识建议

• xljk:consultation:schedule:list
• xljk:consultation:appointment:apply
• xljk:consultation:appointment:process
• xljk:consultation:appointment:record
• xljk:consultation:counselor:list
• xljk:consultation:statistics:view
• xljk:consultation:noshow:list # 查看未到访记录列表
• xljk:consultation:noshow:query # 查看未到访记录详情
• xljk:consultation:noshow:release # 解除预约限制

6. 业务流程

6.1 预约流程

1. 管理员设置预约时段
2. 学生发起预约申请
3. 咨询师处理预约申请（确认/拒绝）
4. 系统通知学生预约结果

6.2 咨询流程

1. 学生按预约时间到访
2. 咨询师进行咨询
3. 咨询师记录咨询情况（到访情况、沟通时长、咨询内容）
4. 系统更新预约状态为"已完成"

6.3 未到访处理流程

1. 学生未按预约时间到访
2. 咨询师记录为"未到访"
3. 系统在xljk_consultation_no_show表中创建未到访记录
4. 系统检查30天内学生未到访次数
5. 如达到三次未到访，系统自动限制7天内不能预约（从最后一次未到访日期算起，不含当天）
6. 限制期间学生尝试预约时，系统提示预约受限及解除日期

6.4 预约限制解除流程

1. 自动解除：

   • 系统定期检查限制记录
   • 限制期满7天后，自动将状态更新为"已过期(1)"
   • 状态更新后，学生可以正常预约

2. 手动解除：

   • 心理健康管理员可通过"预约限制解除"菜单查看限制记录
   • 管理员可手动解除限制，将状态更改为"已解除(2)"
   • 手动解除后，学生立即可以正常预约

3. 限制状态说明：

   • "生效中(0)"：限制当前有效，学生无法预约
   • "已过期(1)"：限制已自动到期，学生可以预约
   • "已解除(2)"：限制被管理员手动解除，学生可以预约

7. 其他说明

• 咨询内容属于高度敏感信息，需要特别注意保密
• 预约规则可能需要根据实际情况进行调整
• 当前仅支持一位咨询师，后续可扩展多咨询师
• 所有表均包含基础字段（创建者、创建时间、更新者、更新时间、逻辑删除、租户ID）
• 预约限制功能中，30天内累计三次未到访的计算以no_show_date字段为准
• 预约限制到期日计算公式：expire_date = no_show_date + 7天（不包含未到访当天）
• 预约限制解除页面仅显示有限制的记录（即status有值的记录）