西藏巴青项目

我的预约（机构）— 技术方案

依据：我的预约(机构)功能需求.md（同目录）；关联 我的预约(兽医)技术方案.md、我的预约(专家) 草稿与功能需求

1. 技术架构

项	说明
整体	RuoYi v3.9.2（springboot2 分支）单体后端 + 若依 Vue2 管理端
运行时	JDK 8、Spring Boot 2.x、Spring MVC、MyBatis、Druid
数据库	MySQL 5.7.39，InnoDB，`utf8mb4`
关联表	`biz_medical_resource`（机构 `resource_type=3`，`sys_user_id` 绑定登录用户）
预约数据	与兽医/专家共用 `biz_service_appointment`（见 §2）；本模块无写接口
移动端	机构预约 `INSERT` 由「预约服务」完成；本模块为机构后台只读查询

后端分层（机构模块）

层	职责
`Controller`	分页列表、详情；`@PreAuthorize`；`AjaxResult` / `TableDataInfo`
`Service`	解析当前机构 `provider_id`、机构合法状态校验、越权校验
`Mapper` + XML	共用 `BizServiceAppointmentMapper`，按 `provider_type=2` 查询
`support`	`OrgAppointmentValidation`、`OrgAppointmentStatusResolver`、`OrgProviderResolver`；复用 `ServiceAppointmentRules`

代码包（建议）：com.ruoyi.web.modules.diagnosis（与兽医预约、医疗资源同域）
共用实体/Mapper：BizServiceAppointment、BizServiceAppointmentMapper（兽医模块已建则复用，不重复建表）
初始化脚本：sql/biz_service_appointment.sql（三端共用，机构迭代前须已执行）

2. 关联方案设计（三端共用）

2.1 统一预约主表 `biz_service_appointment`

`provider_type`	服务对象	`provider_id` 指向	后台模块	移动端提交后 `status`
`1`	兽医	`biz_medical_resource.id`（`resource_type=1`）	我的预约（兽医）	`0` 待确认
`2`	诊疗机构	`biz_medical_resource.id`（`resource_type=3`）	我的预约（机构）	`5` 已预约
`3`	科技专家	`biz_tech_resource.id`（`resource_type=1`）	我的预约（专家）	`0` 待确认

机构与兽医共用 biz_medical_resource，以 resource_type 区分行；机构账号绑定 resource_type=3 的记录。

2.2 状态枚举（库表 `status` → 机构展示）

值	常量	机构展示	机构列表可筛	兽医/专家
`5`	`BOOKED`	已预约	✓	—
`3`	`CANCELLED`	已取消	✓	✓
`4`	`COMPLETED`	已完成	✓	✓
`0/1/2`	待确认/已确认/已拒绝	不得出现	—	✓

应用层：provider_type=2 时，status 仅允许 3、4、5；列表筛选传入 0/1/2 视为非法。

2.3 三端接口对照

模块	Base Path	写操作
兽医	`/diseaseTreatment/myAppointment/vet`	确认、拒绝
机构（本文档）	`/diseaseTreatment/myAppointment/org`	无
专家	`/techService/myAppointment/expert`	确认、拒绝；评价列表

2.4 当前登录人解析（机构）

loginUser.userId
  → biz_medical_resource
      WHERE sys_user_id = ? AND resource_type = 3
        AND account_assigned = 1 AND del_flag = '0'
  → provider_id = id

列表/详情 WHERE provider_type = 2 AND provider_id = ?

无绑定：列表返回空；详情/越权访问返回「未绑定机构资源，无法查询预约」。

Mapper 扩展（与兽医 selectVetResourceBySysUserId 对称）

SELECT ... FROM biz_medical_resource
WHERE sys_user_id = #{sysUserId}
  AND resource_type = 3
  AND account_assigned = 1
  AND del_flag = '0'
LIMIT 1

2.5 机构与兽医/专家差异（实现约束）

项	机构	兽医/专家
列表 SQL	同表；`provider_type=2`；可不返回 `reject_reason` 列给前端（或返回但前端不展示）	`provider_type=1/3`
详情	全字段只读；不展示 `rejectReason`、评价	兽医无评价；专家有评价子表
状态标签	`OrgAppointmentStatusResolver`（三态）	`VetAppointmentStatusResolver`（五态）
专家评价表	不涉及	仅专家 `biz_service_appointment_review`（待建）

3. 数据库设计

3.1 复用表 `biz_service_appointment`

机构模块不新增业务表；字段与兽医方案 §3.1 一致。机构侧关心字段如下：

字段	机构用途
`provider_type`	固定 `2`
`provider_id`	机构医疗资源主键
`appointee_name` / `appoint_date` / `time_start` / `time_end`	列表（日期）+ 详情（时段）
`contact_phone`	列表 + 详情
`service_address` / `service_requirement`	仅详情（列表前端不展示，SQL 可仍查询）
`status`	`5/3/4`
`reject_reason` / `confirm_time` / `reject_time`	机构流程不使用，不展示

DDL：见 sql/biz_service_appointment.sql（项目已提供则无需重复执行）。

3.2 机构列表查询（Mapper XML 语义）

WHERE provider_type = 2 AND provider_id = #{providerId}
  <if test="appointeeName != null and appointeeName != ''">
    AND appointee_name LIKE concat('%', #{appointeeName}, '%')
  </if>
  <if test="startDate != null and startDate != ''">
    AND appoint_date &gt;= #{startDate}
  </if>
  <if test="endDate != null and endDate != ''">
    AND appoint_date &lt;= #{endDate}
  </if>
  <if test="status != null">
    AND status = #{status}
  </if>
ORDER BY appoint_date DESC, create_time DESC, id DESC

详情/越权：id + provider_type=2 + provider_id=当前机构。

3.3 机构侧无需的子表

无分圈、无评价子表；不为机构单独建表。

4. 接口设计（机构）

统一响应：RuoYi AjaxResult / TableDataInfo（code、msg、data / rows、total）。

权限标识（示例）：diseaseTreatment:orgMyAppointment:list|query|complete（无 confirm/reject）

Base Path（示例）：/diseaseTreatment/myAppointment/org

#	说明	Method	URI	权限	要点
4.1	分页列表	GET	`/list`	`...:list`	Query：`pageNum`（默认 1）、`pageSize`（默认 20）、`appointeeName`（模糊）、`startDate`、`endDate`（`yyyy-MM-dd`）、`status`（仅 `3/4/5`）；禁止前端传 `providerId`
4.2	详情	GET	`/{id}`	`...:query`	校验 `provider_type=2` 且归属当前机构；返回详情全字段（见下表）

| 4.3 | 完成接诊 | POST | /complete/{id} | ...:complete | 前置 status=5（已预约）；更新 status=4（已完成） |

本期不提供：POST 确认/拒绝；除 完成接诊 外无其他写操作。

4.1 列表响应字段（建议）

与功能需求列表列对齐，后端可返回：

id、appointeeName、appointDate、contactPhone、status、statusLabel。

（timeStart、timeEnd、serviceAddress 等可由 SQL 查出但列表页不绑定，或不下发以减流量。）

4.2 详情 `data` 字段（建议）

字段	说明
`id`	主键
`appointeeName`	预约人
`appointDate`	`yyyy-MM-dd`
`timeStart` / `timeEnd`	时段；前端拼 `HH:mm~HH:mm`
`contactPhone`	联系电话
`serviceAddress`	服务地址
`serviceRequirement`	服务需求
`status` / `statusLabel`	状态码与展示名
`createTime`	提交时间（审计，可选）

不下发：rejectReason、confirmTime、rejectTime（机构无对应流程）。

4.3 业务错误（`msg` 示例）

场景	文案
日期筛选	结束日期不能早于开始日期
状态筛选非法	状态筛选无效
无机构绑定	未绑定机构资源，无法查询预约
越权	无权操作该预约记录 / 无权查看该预约记录
不存在	预约记录不存在或已删除

4.4 与兽医/专家接口差异（实现对照）

能力	机构	兽医	专家
列表	`GET .../org/list`	`GET .../vet/list`	`GET .../expert/list`
详情	`GET .../org/{id}`	`GET .../vet/{id}`	`GET .../expert/{id}`
确认	—	`POST .../vet/confirm/{id}`	`POST .../expert/confirm/{id}`
拒绝	—	`POST .../vet/reject/{id}`	`POST .../expert/reject/{id}`
评价	—	—	`GET .../expert/reviewList/{id}`

5. 实现要点

项	说明
越权	详情必须 `provider_type=2` 且 `provider_id=当前机构`
只读	Controller 仅 `GET`；Service 无 `insert/update` 预约方法
状态展示	`status=5` →「已预约」；勿与兽医「已确认」混用
数据串单防护	若查到 `status∈{0,1,2}` 且 `provider_type=2`，记日志并按「数据异常」处理（不展示或报错）
日志	详情查看可记 `@Log`（查询类，按平台惯例）
组件路径	`diseaseTreatment/myAppointment/org/index`

建议新增类（机构）

类	职责
`OrgProviderResolver`	`resource_type=3` 解析 `provider_id`
`OrgAppointmentValidation`	列表日期区间、`status∈{3,4,5}`
`OrgAppointmentStatusResolver`	三态中文标签
`OrgMyAppointmentServiceImpl`	列表/详情 scope
`BizOrgMyAppointmentController`	两个 GET 接口

复用（兽医已建）

ServiceAppointmentRules、BizServiceAppointment、BizServiceAppointmentMapper
扩展 Mapper：selectOrgAppointmentList、selectOrgAppointmentByIdAndProvider（或泛化 selectByProvider 减少重复）

6. 与上下游衔接

系统	说明
移动端预约服务	用户选机构并提交 → `INSERT`：`provider_type=2`，`status=5`
移动端取消	更新 `status=3`
已完成	业务闭环置 `status=4`
畜牧医疗资源管理	机构须已发布且已分配账号（角色 102）
我的预约（兽医）	同表不同 `provider_type`；列表互不可见

7. 菜单与权限（示例）

类型	名称	权限标识
菜单	我的预约（机构）	`diseaseTreatment:orgMyAppointment:list`
按钮	查询	`diseaseTreatment:orgMyAppointment:query`
按钮	完成接诊	`diseaseTreatment:orgMyAppointment:complete`

组件路径：diseaseTreatment/myAppointment/org/index（「牧业疫病诊疗服务」目录下）。

8. 交付清单

BizMedicalResourceMapper.selectOrgResourceBySysUserId（若尚未添加）
BizServiceAppointmentMapper 机构查询方法 + XML
OrgMyAppointmentController + Service + 校验/状态解析
菜单权限 SQL（机构，仅 list/query）
单元测试 + MockMvc（列表 scope、三态筛选、越权、无写接口）

9. 修订记录

版本	说明
1.0	初稿：共用 `biz_service_appointment`；机构只读接口；三态与兽医/专家关联；复用 diagnosis 包与医疗资源绑定

我的预约(机构)技术方案.md 11KB Историја Датотека