ZYT/zyt

Files

T

2026-08-10 17:29:05 +08:00

38 KiB

Raw Blame History

admin 医生端源码审计

审计日期：2026-08-10
参考项目：D:\web\zyt\admin
审计方式：只读检查 Vue/TypeScript 源码、API 封装、路由守卫、Pinia store、业务组件和权限判断；未修改 admin 项目，也未把 README 当作结论来源。

1. 结论摘要

admin 是 Vue 3 + TypeScript + Vite + Element Plus + Pinia 项目。医生端并不是一套独立的静态路由：除登录、H5 诊单和只读诊单外，页面路径、标题、组件和菜单权限都由登录后 GET /adminapi/auth.admin/mySelf 返回的 menu 动态注入。
医生相关页面的全局状态很少。Pinia 只持有认证用户、权限、动态菜单、全局站点配置、布局与多标签；接诊台、处方、患者、问诊列表的查询条件和业务状态均保留在各页面的 ref/reactive 中，分页统一使用 usePaging。
“患者列表”有两个不同实现：
- 医生/一诊工作台的“我的患者”：src/views/first_visit/my_patients/index.vue，带患者、订单、面诊进度三个工作区，服务端按当前角色和部门数据范围收窄。
- 平台注册用户列表：src/views/consumer/lists/index.vue，仅展示头像、昵称、账号、手机号、渠道和注册时间，不是医生业务患者工作台。
“问诊列表”也有两个相关实现：
- 挂号/问诊执行列表：src/views/tcm/appointment/list.vue，默认“今天 + 待接诊”，支持通话、视频二维码、完成、开方、取消。
- 诊单/患者业务列表：src/views/tcm/diagnosis/index.vue，围绕诊单、挂号、确认、开方、医助指派、二维码和视频旁观。最终菜单叫什么、URL 是什么取决于后端 menu 配置，不应仅根据文件名硬编码。
实际视频问诊主链是 src/components/chat-dialog/index.vue：腾讯云 Chat UIKit 单聊 + TUICallKit 音视频；通话前后还串联后端通话记录、TRTC 房间绑定、云端混流录制、可选浏览器本地录制、截屏写医生备注。src/components/video-call/index.vue 是另一套旧/独立实现，目前源码中没有被任何页面引用。
处方领域要区分三类对象：
- 处方库模板：tcm.prescriptionLibrary，供医生复用药材组合。
- 已开处方：tcm.prescription，处方笺、患者、医师签名、主辅方、审核与作废。
- 处方业务订单：tcm.prescriptionOrder，收货、费用、双审、支付单、药房和物流履约；它不是支付单 zyt_order。

2. 关键源码与路由

2.1 页面定位

业务	关键源文件（绝对路径）	路由结论
登录	D:\web\zyt\admin\src\views\account\login.vue	静态精确路由 /login
接诊台	D:\web\zyt\admin\src\views\patient\reception\index.vue	动态菜单组件键应指向 patient/reception/index；实际 URL 取 menu[].paths
我的处方库	D:\web\zyt\admin\src\views\consumer\prescription\list.vue	动态菜单组件键应指向 consumer/prescription/list；实际 URL 取 menu[].paths
药品库（不是处方库）	D:\web\zyt\admin\src\views\doctor\medicine.vue	动态菜单组件键应指向 doctor/medicine
已开处方/处方管理	D:\web\zyt\admin\src\views\consumer\prescription\index.vue	动态菜单组件键应指向 consumer/prescription/index
处方业务订单	D:\web\zyt\admin\src\views\consumer\prescription\order_list.vue	动态菜单组件键应指向 consumer/prescription/order_list
我的患者	D:\web\zyt\admin\src\views\first_visit\my_patients\index.vue	动态菜单组件键应指向 first_visit/my_patients/index
平台用户列表	D:\web\zyt\admin\src\views\consumer\lists\index.vue	动态菜单组件键应指向 consumer/lists/index
问诊/挂号列表	D:\web\zyt\admin\src\views\tcm\appointment\list.vue	动态菜单组件键应指向 tcm/appointment/list
诊单列表	D:\web\zyt\admin\src\views\tcm\diagnosis\index.vue	动态菜单组件键应指向 tcm/diagnosis/index；另有静态 H5 路由 /tcm/diagnosis/h5
诊单编辑/只读抽屉	D:\web\zyt\admin\src\views\tcm\diagnosis\edit.vue	被多个页面异步复用，不一定是独立菜单
患者只读详情	D:\web\zyt\admin\src\views\tcm\diagnosis\readonly.vue	静态精确路由 /tcm/diagnosis-readonly?id=诊单ID
预约视频问诊	D:\web\zyt\admin\src\views\tcm\diagnosis\appointment.vue	抽屉组件，由诊单列表/我的患者调用
诊间开方	D:\web\zyt\admin\src\components\tcm-prescription\index.vue	复用组件，由问诊列表和诊单编辑调用
聊天与视频问诊	D:\web\zyt\admin\src\components\chat-dialog\index.vue	浮动组件，由接诊台及问诊列表调用
医助视频旁观	D:\web\zyt\admin\src\views\tcm\diagnosis\components\AssistantWatchCallDialog.vue	诊单列表内异步组件

2.2 动态路由机制

关键文件：

D:\web\zyt\admin\src\router\routes.ts
D:\web\zyt\admin\src\router\index.ts
D:\web\zyt\admin\src\permission.ts
D:\web\zyt\admin\src\stores\modules\user.ts

流程：

常量路由只注册 /login、/403、/change-password、/bind-work-wechat、/user/setting、/doctor/progress、/tcm/diagnosis/h5 和 /tcm/diagnosis-readonly 等少数页面。
登录成功后 GET /auth.admin/mySelf。
user store 保存 data.user、data.permissions，并把 data.menu 交给 filterAsyncRoutes。
每个后端菜单项使用以下字段转为 Vue Router：
- paths：路由路径；
- component：src/views 下的组件键；
- name：菜单标题；
- perms：写入 route.meta.perms；
- is_show：控制 meta.hidden；
- is_cache：控制 keepAlive；
- params：默认 query；
- selected：activeMenu；
- type：目录或菜单。
permission.ts 把转换后的路由动态挂到根布局；第一个可见菜单成为 / 的重定向目标。

因此，本仓库源码能确定组件和静态路由，但不能单独确定接诊台、处方库、已开处方、我的患者、问诊列表的生产 URL 与菜单标题。要得到精确值，必须取得当前环境 /auth.admin/mySelf 的 menu 响应或检查服务端菜单表。

3. 登录、认证、权限和状态管理

3.1 登录链路

关键文件：

D:\web\zyt\admin\src\views\account\login.vue
D:\web\zyt\admin\src\api\user.ts
D:\web\zyt\admin\src\stores\modules\user.ts
D:\web\zyt\admin\src\utils\request\index.ts
D:\web\zyt\admin\src\utils\auth.ts

账号密码：

POST /login/account
请求：account、password、terminal=1。
响应被页面使用的字段：token、is_paw、need_bind_work_wechat。
token 写入本地缓存键 token，后续请求通过请求拦截器放到 HTTP 头 token。
“记住账号”只缓存 account，不缓存密码，缓存键为 account。

企业微信：

GET /login/workWechatConfig，使用 enabled、corp_id、agent_id。
企业微信内置浏览器走 OAuth，scope=snsapi_privateinfo、state=admin_login。
普通浏览器动态加载 https://wwcdn.weixin.qq.com/node/wework/wwopen/js/wwLogin-1.2.7.js 显示扫码登录。
回调 code 通过 POST /login/workWechatLogin，参数 code、terminal=1。
另有 POST /auth.admin/bindWorkWechat、POST /auth.admin/unbindWorkWechat。

守卫：

is_paw=0 强制跳转 /change-password，并通过 POST /login/changeFirstPassword 修改。
need_bind_work_wechat=true 强制进入 /bind-work-wechat。
没有 token 的非白名单路由跳 /login?redirect=原地址。
/auth.admin/mySelf 没有任何有效菜单时清认证并跳 /403。
响应码约定：1 成功、0 失败、-1 登录失效、10 需要绑定企微、2 打开新页面、-2 未安装。

3.2 Pinia 与页面状态

Store/Hook	文件	职责
user	D:\web\zyt\admin\src\stores\modules\user.ts	token、userInfo、routes、perms、isPaw；登录、退出、企微登录、加载个人信息
app	D:\web\zyt\admin\src\stores\modules\app.ts	网站配置、OSS 图片地址、移动端/侧栏状态、视图刷新
tabs	D:\web\zyt\admin\src\stores\modules\multipleTabs.ts	多标签与 keep-alive 缓存
setting	D:\web\zyt\admin\src\stores\modules\setting.ts	本地布局、主题配置
usePaging	D:\web\zyt\admin\src\hooks\usePaging.ts	页码、page_size、loading、count、lists、extend；支持 silent 静默刷新

列表接口统一期待服务端 data 为：

lists：当前页数组；
count：总数；
extend：额外统计、日期、权限范围等扩展数据。

页面内筛选和弹窗状态不进入 Pinia。这一约定适合桌面端复用：认证/权限做全局 store，业务工作台保持页面级 store 或 view-model。

3.3 权限判断语义

关键文件：

D:\web\zyt\admin\src\install\directives\perms.ts
D:\web\zyt\admin\src\utils\perm.ts

需要特别注意两套语义不同：

v-perms 数组是“任一权限命中即可显示”（OR）。
hasPermission 数组是“数组内每个权限都必须存在”（AND）。
permissions 含星号时视为全部权限。

多数业务调用只传单个权限，因此差异暂时不明显；复用时不要把多权限数组在两处互换。

4. 业务页面审计

4.1 接诊台

源码：

D:\web\zyt\admin\src\views\patient\reception\index.vue
D:\web\zyt\admin\src\api\patient.ts
D:\web\zyt\admin\src\views\tcm\diagnosis\components\PatientInfoCard.vue
D:\web\zyt\admin\src\views\tcm\diagnosis\components\PatientCaseCard.vue
D:\web\zyt\admin\src\views\tcm\diagnosis\components\DailyMatrix.vue
D:\web\zyt\admin\src\views\patient\reception\components\NoteTimeline.vue

页面行为：

默认显示当天 status=1 待接诊；可切到 status=4 已过号。
搜索字段 patient_name；分页 page_no/page_size，固定每页 15。
每 5 秒静默刷新队列和已选患者详情；页面隐藏时暂停，恢复可见后立即刷新。
队列使用无限滚动，并按 id 去重。
队列行主要字段：id、patient_id、patient_name、patient_phone、diagnosis_id、doctor_id/name、assistant_id/name、appointment_date/time、gender、age、status/status_desc、has_prescription、remark。
详情结构按源码使用为：
- appointment：挂号；
- diagnosis：诊单/病例；
- doctor_notes：医生备注、舌苔和报告。
日常记录不依赖 reception 响应完整下发，而由 DailyMatrix 继续按 diagnosis_id 调 trackingWindow/trackingNotes。

操作：

通知医助：POST /doctor.appointment/notifyAssistant，参数 id=挂号ID。
发起通话：先 POST /tcm.diagnosis/getCallSignature，参数 patient_id、diagnosis_id，再打开 ChatDialog。
备注：POST /doctor.appointment/addDoctorNote，参数 diagnosis_id、content，可追加 tongue_images、report_files。
编辑病历：复用 tcm/diagnosis/edit.vue。
完成接诊：POST /doctor.appointment/complete，参数 id=挂号ID；页面允许 status=1 或 4。

权限：

doctor.appointment/addDoctorNote
tcm.diagnosis/edit
doctor.appointment/complete

源码中的“通知医助”和“发起通话”按钮没有 v-perms；只能依赖页面菜单权限和后端接口鉴权，桌面端若拆成独立入口应补显式能力判断。

4.2 我的处方库

源码：

D:\web\zyt\admin\src\views\consumer\prescription\list.vue
D:\web\zyt\admin\src\api\tcm.ts
D:\web\zyt\admin\src\components\medicine-name-select\index.vue

模型与筛选：

查询：prescription_name、formula_type（主方/辅方）、is_public（0 仅自己、1 所有人）。
列表：id、prescription_name、formula_type、herbs、is_public、disable_edit、creator_id/name、create_time。
herbs 项：medicine_id（可选）、name、dosage。
编辑：id、prescription_name、formula_type、herbs、is_public、disable_edit。
disable_edit=1 表示导入模板后锁定整张处方的药材，不可增删改，只能再次导入覆盖。

接口：

GET /tcm.prescriptionLibrary/lists
POST /tcm.prescriptionLibrary/add
POST /tcm.prescriptionLibrary/edit
POST /tcm.prescriptionLibrary/delete，参数 id
GET /tcm.prescriptionLibrary/detail，参数 id（API 已封装，但当前列表弹窗直接使用行数据）

权限：

wcf.prescription/add
wcf.prescription/read
wcf.prescription/edit
wcf.prescription/delete

所有权：

普通用户只可编辑/删除 creator_id 等于当前 userInfo.id 的模板。
root=1 或 role_ids 包含 0、3 可管理全部模板。
诊间/已开处方导入模板时会额外传 prescribing_creator_id，通常取处方 creator_id，新增时取当前登录用户 id。

4.3 药品库（容易和处方库混淆）

源码：D:\web\zyt\admin\src\views\doctor\medicine.vue

接口：

GET /doctor.medicine/lists
POST /doctor.medicine/add
POST /doctor.medicine/edit
POST /doctor.medicine/delete
GET /doctor.medicine/detail

模型：

id、name、supplier、unit、settlement_price、retail_price、stock、image、status、remark。
图片上传直接 POST 到 VITE_APP_BASE_URL + /api/upload/image，并携带 token 头。

当前页面的增删改按钮没有 v-perms。它是药材主数据管理，不应直接当作“我的处方库”复刻。

4.4 已开处方/处方管理

源码：

D:\web\zyt\admin\src\views\consumer\prescription\index.vue
D:\web\zyt\admin\src\components\tcm-prescription\index.vue
D:\web\zyt\admin\src\api\tcm.ts

列表筛选：

sn：处方编号模糊查；
patient_name；
creator_ids：开方医师多选；
audit_filter：all、pending、passed、not_passed、rejected；
source_filter：all、manual、system；
start_time、end_time（按创建时间）。

列表核心字段：

id、sn、prescription_type；
is_system_auto：0 手工、1 空白处方/系统代开；
patient_name、gender、age、phone；
audit_status、audit_remark、business_prescription_audit_rejected、business_prescription_audit_remark；
void_status、void_by_name、void_time；
doctor_name、creator_id、assistant_name、prescription_date、create_time；
has_prescription_order。

处方编辑/详情模型：

关联：id、diagnosis_id、creator_id。
患者：patient_name、gender、age、visit_no、prescription_date。
诊断：tongue、tongue_image、pulse、pulse_condition、clinical_diagnosis。
药材：herbs，每项 medicine_id、name、dosage、formula_type（主方/辅方）、locked。
剂型/用法：prescription_type、dosage_amount、dosage_unit、dosage_bag_count、need_decoction、bags_per_dose、dose_count、dose_unit、usage_days、times_per_day、usage_instruction、usage_time、usage_way、dietary_taboo、usage_notes。
辅方用法 aux_usage：dosage_amount、dosage_bag_count、need_decoction、bags_per_dose、times_per_day、usage_days、prescription_name（部分页面保留模板名）。
医师：doctor_name、doctor_signature（PNG data URL，保存前必填）。
可见性/审核：is_shared、visible_role_ids、audit_status、audit_time、audit_by_name、audit_remark。

状态规则：

audit_status：0 待审核、1 已通过、2 已驳回。
驳回处方会同时作废。
“已通过且未作废”的有效处方不能普通编辑/删除。
新增时前端强制 audit_status=0；编辑保存后提示重新进入待审核。
诊间开方组件会保存 case_record 病历快照，并在已有 appointment_id 处方时直接进入只读查看。
已存在业务订单时，诊间组件禁止作废处方。

主要接口：

GET /tcm.prescription/lists
GET /tcm.prescription/detail，参数 id
POST /tcm.prescription/add
POST /tcm.prescription/edit
POST /tcm.prescription/delete，参数 id
POST /tcm.prescription/patchPatient，参数 id、patient_name、phone、gender
POST /tcm.prescription/audit，参数 id、action=approve|reject、remark
POST /tcm.prescription/void，参数 id
GET /tcm.prescription/listByDiagnosis，参数 diagnosis_id
GET /tcm.prescription/getByAppointment，参数 appointment_id

权限：

cf.prescription/add、read、edit、audit、del
tcm.prescription/patchPatient
tcm.prescriptionLibrary/lists
tcm.prescriptionOrder/create、lists、setShipMode
finance.account_log/lists
tcm.prescriptionOrder/editRemarkExtra

角色补充：消费者处方页将 root 或 role_ids 0、3 视为可审核角色；仍应以后端和 cf.prescription/audit 为最终判定。

4.5 处方业务订单

源码：

D:\web\zyt\admin\src\views\consumer\prescription\order_list.vue
D:\web\zyt\admin\src\views\consumer\prescription\components\PrescriptionOrderDetailDrawer.vue
D:\web\zyt\admin\src\views\consumer\prescription\components\prescription-order-utils.ts

此页面是已开处方的相邻履约域。核心字段：

id、order_no、prescription_id、diagnosis_id；
recipient_name、recipient_phone、region、shipping_address；
fee_type、amount、internal_cost；
prescription_audit_status、payment_slip_audit_status；
fulfillment_status；
linked_pay_order_count、linked_pay_order_id、linked_pay_paid_total；
medication_days、service_channel、service_package；
express_company、tracking_number、ship_mode；
doctor_name、creator_id/name、assistant_id；
remark_extra、remark_assistant；
药房提交号和状态。

审核状态统一为 0 待审核、1 已通过、2 已驳回。履约状态：

1 待双审通过
2 待发货
3 已完成
4 已取消
5 已发货
6 已签收
7 进行中
8 暂不制药
9 拒收
10 退款
11 保留药方
12 制药缓发

核心接口：

GET /tcm.prescriptionOrder/lists、detail、paidPayOrders、logs、logisticsTrace、export
POST /tcm.prescriptionOrder/create、edit、withdraw、ddcode
POST /tcm.prescriptionOrder/auditPrescription、auditPayment、revokeRxAudit、revokePayAudit
POST /tcm.prescriptionOrder/ship、complete、refund、requestCompletion
POST /tcm.prescriptionOrder/addPayOrder、linkPayOrder
POST /tcm.prescriptionOrder/patchPrescriptionPatient、patchPrescriptionUsage、updateAmount
POST /tcm.prescriptionOrder/setShipMode、uploadToPharmacy
POST /tcm.prescriptionOrder/submitGancaoRecipel、previewGancaoRecipel、confirmGancaoSubmission
POST /tcm.prescriptionOrder/batchAssignAssistant、addLog

主要权限：

tcm.prescriptionOrder/detail、edit、export、ddcode、ship、addPayOrder、complete、refund、withdraw
tcm.prescriptionOrder/auditPrescription、auditPayment
tcm.prescriptionOrder/setShipMode、uploadToPharmacy、editRemarkExtra
finance.account_log/lists、prescription.order/finance

前端还存在角色级显示规则：

role 2：医助；
role 6：下单角色；
role 3、8：下单筛选豁免；
role 0、3、6：财务字段；
role 0、3：可绕过双审后的创建人编辑锁、可批量改派；
业务订单处方审核角色在共享工具中为 0、3、6。

这些数字与服务端配置耦合，不宜在新客户端再次散落硬编码。

4.6 我的患者

首选医生端实现：

D:\web\zyt\admin\src\views\first_visit\my_patients\index.vue
D:\web\zyt\admin\src\api\first_visit.ts

页面结构：

“患者列表”“订单管理”“面诊进度”三个工作区。
筛选 keyword、status_filter、start_date、end_date。
status_filter：unbooked 未预约、pending_interview 待面诊、completed 已完成、missed 已过号。
日期快捷：今天、明天、后天、近 7 天、近 30 天、自定义。
extend.summary 返回 today/tomorrow/day_after 计数。
extend.dates 返回对应日期。
extend.scope.label 直接展示后端判定的数据范围。

列表使用字段：

diagnosis_id 或 id、source_patient_id；
patient_name、gender_desc、age、phone_masked、has_id_card；
assistant_id/name；
appointment_id、appointment_doctor_id/name、appointment_status、appointment_status_text、appointment_time_text；
revisit_count、confirmed、confirmation_text、diagnosis_date_text。

操作与接口：

GET /firstvisit.myPatient/lists
GET /firstvisit.myPatient/assistants
POST /firstvisit.myPatient/assign：id、assistant_id、is_inherit=0|1
POST /firstvisit.myPatient/fillIdCard：id、id_card
POST /firstvisit.myPatient/createAppointment：预约完整参数
POST /firstvisit.myPatient/cancelAppointment：id=挂号ID
订单工作区另使用 /firstvisit.myPatient/orders、orderDetail、orderEdit 及双审/发货/退款等受限代理接口。
面诊进度使用 GET /firstvisit.myPatient/progress。

权限：

tcm.diagnosis/edit
tcm.diagnosis/readonlyDetail
tcm.diagnosis/guahao
tcm.diagnosis/assign

服务端按当前角色与部门范围裁剪数据；前端不自行拼接 doctor_id 或 department_id 来模拟数据权限。

平台用户列表 D:\web\zyt\admin\src\views\consumer\lists\index.vue 使用 GET /user.user/lists，字段是 avatar、nickname、account、mobile、channel、create_time，只适合账号管理，不适合医生患者列表。

4.7 问诊/挂号列表

源码：

D:\web\zyt\admin\src\views\tcm\appointment\list.vue
D:\web\zyt\admin\src\api\doctor.ts

默认条件：

status=1 待接诊；
start_date=end_date=今天；
date_preset=today；
20 秒静默轮询；
include_status_counts=1 时从 extend.status_count 一次返回各状态角标。

状态：

1 待接诊/已预约
2 已取消
3 已完成
4 已过号

筛选：

patient_name、doctor_name；
status；
start_date、end_date、date_preset；
diagnosis_confirmed；
assistant_dept_id（选父部门含子级）。

行字段：

id、patient_id、diagnosis_id；
patient_name、patient_phone、gender、age、height、weight；
doctor_id/name、assistant_name；
appointment_date、appointment_time、period；
diagnosis_confirmed；
has_prescription、prescription_is_system_auto、prescription_audit_status、prescription_void_status；
status/status_desc、remark。

操作：

编辑患者：复用诊单编辑抽屉。
视频二维码：生成小程序码。
通话：获取签名并打开 ChatDialog。
完成：POST /doctor.appointment/complete，可同时 POST addDoctorNote。
开方/查看：复用 TcmPrescription；有效已审核处方显示“查看”。
取消：POST /doctor.appointment/cancel。

权限：

tcm.diagnosis/edit
tcm.diagnosis/videoQr
doctor.appointment/prescription
doctor.appointment/complete
tcm.diagnosis/kaifang
doctor.appointment/cancel
doctor.appointment/addDoctorNote（完成时备注能力）

角色判断：role_id 为 1 医生、2 医助；两者之外才显示医生姓名筛选。此处同时兼容 role_id 单值或数组，但其他页面多使用 role_ids，说明 user 模型尚未完全统一。

4.8 诊单列表

源码：

D:\web\zyt\admin\src\views\tcm\diagnosis\index.vue
D:\web\zyt\admin\src\views\tcm\diagnosis\edit.vue
D:\web\zyt\admin\src\views\tcm\diagnosis\readonly.vue

列表筛选字段：

keyword、diagnosis_type、syndrome_type、assistant_id；
diagnosis_confirmed、appointment_date、has_appointment；
latest_appointment_start_date/end_date/channel_source；
latest_assign_start_date/end_date；
pending_booking、completed_appointment、pending_assign；
pending_assign_order_month、pending_assign_keyword；
sort_unserved_days。

列表使用字段：

id、patient_name、gender_desc、age；
assistant_id/assistant、assign_read_at；
appointments 或聚合的 appointment_doctor_name、appointment_time_text、appointment_status；
has_appointment、diagnosis_confirmed；
has_prescription、followup_time_text、followup_doctor_name、followup_rx_voided；
unserved_days、last_blood_record_at；
video_call_hint。

video_call_hint：

state：none、pending_room、live 等；
label；
start_time、end_time。

操作权限：

tcm.diagnosis/add、edit、delete、readonlyDetail
tcm.diagnosis/assign
tcm.diagnosis/kaifang
tcm.diagnosis/guahao、guahaoLogList
tcm.diagnosis/videoQr
tcm.diagnosis/order
tcm.diagnosis/watchCall

诊单编辑模型的核心字段：

标识：id、patient_id。
患者：patient_name、id_card、phone、gender、age、marital_status、height、weight、region。
诊断：diagnosis_date、diagnosis_type、syndrome_type、diabetes_type、diabetes_discovery_year、local_hospital_diagnosis、local_hospital_name。
指标：systolic_pressure、diastolic_pressure、fasting_blood_sugar。
现病史多选：appetite、water_intake、diet_condition、weight_change、body_feeling、sleep_condition、eye_condition、head_feeling、sweat_condition、skin_condition、urine_condition、stool_condition、kidney_condition、fatty_liver_degree。
既往史：past_history、trauma_history、surgery_history、allergy_history、family_history、pregnancy_history。
医疗内容：symptoms、tongue_coating、pulse、treatment_principle、prescription、doctor_advice、remark、current_medications。
归属与来源：assistant_id、status、create_source、show_card、external_userid。

详情响应还使用 patient_basic_locked、can_edit_patient_basic、latest_prescription_order。手机号/身份证是否显示明文由 tcm.diagnosis/phonePlain 控制；已有身份证通常只有明文权限才能修改。

诊单详情 Tab 权限：

tcm.diagnosis/chufang：处方
tcm.diagnosis/patientOrders：业务订单
tcm.diagnosis/huifang：视频回放
tcm.diagnosis/chat：聊天记录
tcm.diagnosis/assign 或 detail：指派记录
doctor.appointment/lists：挂号记录
tcm.diagnosis/dailyRecord：日常记录

5. 视频问诊完整链路

5.1 预约

源码：D:\web\zyt\admin\src\views\tcm\diagnosis\appointment.vue

目前预约类型只有 video。请求字段：

patient_id
doctor_id
appointment_date
period=all
appointment_time
appointment_type=video
remark
channel_source
channel_source_detail

普通入口 POST /doctor.appointment/create；“我的患者”入口 POST /firstvisit.myPatient/createAppointment。可用时段来自 GET /doctor.appointment/availableSlots，字段 doctor_id、appointment_date、period=all，响应使用 slots[].time、slots[].available。页面还读取医生排班并限制不能重复预约当天 status=1/4 的号。

5.2 医生发起通话

生产主组件：D:\web\zyt\admin\src\components\chat-dialog\index.vue

页面调用 open({ patientId, patientName, diagnosisId })。
POST /tcm.diagnosis/getCallSignature，请求 patient_id、diagnosis_id。
响应实际使用：
- sdkAppId
- userId（医生 IM/TRTC user ID）
- userSig
- patientUserId，缺省回退 patient_加患者ID
- assistant_id（群视频邀请）
- isLochostVod（是否启用浏览器本地录制）
Chat UIKit 登录并创建与 patientUserId 的 C2C 会话。
TUICallKitServer.init 初始化通话能力；只有成功后才显示 AudioCallPicker、VideoCallPicker 和群视频按钮。
beforeCalling 时 POST /tcm.diagnosis/startCall：
- diagnosis_id
- patient_id
- call_type=2（视频）
呼叫状态进入 calling/connected 后从 TUIStore 或 TUICallEngine 捕获 roomID/strRoomID，再 POST /tcm.diagnosis/bindCallRoom：
- diagnosis_id
- room_id（字符串）
bindCallRoom 的响应可带 cloud_recording.started、task_id、message；源码注释说明后端在这里触发腾讯云 CreateCloudRecording，混流模式由后端负责。
接通后，若 isLochostVod=true，前端从 TUICallKit 视频元素启动 MediaRecorder/Canvas 本地录制。
通话结束、挂断、IM 自定义挂断消息或用户关闭窗口时先 POST /tcm.diagnosis/endCall，再完成本地视频上传并 POST attachLocalCallRecording。

群视频调用 TUICallKitServer.calls，userIDList=[patientUserId, assistant_id]，type=VIDEO_CALL。

5.3 截屏、录制与回放

关键文件：

D:\web\zyt\admin\src\utils\call-local-recorder.ts
D:\web\zyt\admin\src\utils\call-video-screenshot.ts
D:\web\zyt\admin\src\views\tcm\diagnosis\components\CallRecordPanel.vue
D:\web\zyt\admin\src\views\tcm\diagnosis\components\RecordingPlaybackBlock.vue

视频浮窗“截屏”会：

抓取当前 video frame；
上传图片；
POST /doctor.appointment/addDoctorNote，把路径追加到 tongue_images。

通话记录字段：

id、call_type（1 语音、其他视为视频）
room_id
status：1 进行中、2 已结束、3 未接听、4 已取消
recording_status_text
recording_urls_list
start_time_text、end_time_text、duration_text

接口：

GET /tcm.diagnosis/getCallRecords，diagnosis_id
POST /tcm.diagnosis/attachLocalCallRecording，diagnosis_id、file_url、可选 call_record_id
POST /tcm.diagnosis/createManualCallRecord，diagnosis_id
POST /tcm.diagnosis/startCloudRecording，diagnosis_id（API 有封装，主组件当前通过 bindCallRoom 的后端联动启动）

5.4 医助旁观

入口在诊单列表。只有同时满足：

当前 userInfo.id 等于该诊单 assistant_id；
拥有 tcm.diagnosis/watchCall；
video_call_hint.state=live；

才可真正进入。

GET /tcm.diagnosis/watchCall，参数 diagnosis_id，响应使用：

sdkAppId
userId
userSig
roomId 或 strRoomId
patientName

旁观组件直接使用 trtc-sdk-v5 进入房间，只调用 startRemoteVideo，不开启本地摄像头或麦克风。pending_room 时显示入口提示但点击会阻止进入，等待房间号同步。

5.5 视频二维码

页面通过 POST /tcm.diagnosis/generateMiniProgramQrcode 生成 qrcode_url，常用字段：

diagnosis_id
patient_id
doctor_id（部分入口）
share_user_id
mini_program_path=pages/login/login（问诊列表入口）

调用前先 GET 小程序配置并校验 app_id。

6. API 总表

所有 URL 会被请求层加上 baseUrl 和 adminapi 前缀；下表写的是 API 封装中的业务路径。

6.1 认证

方法	路径	关键请求/响应
POST	/login/account	account、password、terminal；返回 token、is_paw、need_bind_work_wechat
POST	/login/workWechatLogin	code、terminal；返回同登录结果
GET	/login/workWechatConfig	enabled、corp_id、agent_id
GET	/auth.admin/mySelf	返回 user、permissions、menu
POST	/login/logout	退出
POST	/login/changeFirstPassword	password、password_confirm
POST	/auth.admin/bindWorkWechat	code

6.2 挂号与接诊

方法	路径	关键字段
GET	/doctor.appointment/lists	status、start_date、end_date、patient_name、doctor_name、diagnosis_confirmed、assistant_dept_id、page_no、page_size
GET	/doctor.appointment/reception	id=挂号ID；返回 appointment、diagnosis、doctor_notes
GET	/doctor.appointment/detail	id
GET	/doctor.appointment/availableSlots	doctor_id、appointment_date、period
POST	/doctor.appointment/create	patient_id、doctor_id、appointment_date/time、appointment_type、渠道等
POST	/doctor.appointment/cancel	id
POST	/doctor.appointment/complete	id
POST	/doctor.appointment/notifyAssistant	id
POST	/doctor.appointment/addDoctorNote	diagnosis_id、content、tongue_images、report_files
GET	/doctor.appointment/doctorNotes	diagnosis_id
POST	/doctor.appointment/deleteDoctorNoteImage	note_id、image_type、image_path

6.3 诊单

方法	路径	关键字段
GET	/tcm.diagnosis/lists	诊单列表全部筛选 + page_no/page_size；返回 lists/count/extend
GET	/tcm.diagnosis/detail	id
GET	/tcm.diagnosis/readonlyDetail	id；返回 appointment、diagnosis、unserved_days、last_blood_record_at、doctor_notes
POST	/tcm.diagnosis/add	完整诊单模型
POST	/tcm.diagnosis/edit	完整诊单模型
POST	/tcm.diagnosis/delete	id
POST	/tcm.diagnosis/assign	id、assistant_id、可选 is_inherit；批量场景由前端逐条调用
GET	/tcm.diagnosis/getAssistants	医助选项
GET	/tcm.diagnosis/getDoctors	医生选项
POST	/tcm.diagnosis/checkPhone	phone 及排除 id
POST	/tcm.diagnosis/checkIdCard	id_card 及排除 id
POST	/tcm.diagnosis/fillIdCard	id、id_card
GET	/tcm.diagnosis/trackingWindow	id、start_date、end_date
GET	/tcm.diagnosis/trackingNotes	diagnosis_id
POST	/tcm.diagnosis/addTrackingNote	diagnosis_id、tracking_content

6.4 处方与业务订单

处方、处方库、业务订单接口已在 4.2、4.4、4.5 分节完整列出。实现时必须保留三个资源命名空间，不要把 prescription、prescriptionLibrary、prescriptionOrder 合并成一个“处方”接口。

6.5 视频

方法	路径	关键字段
POST	/tcm.diagnosis/getCallSignature	patient_id、diagnosis_id；返回 sdkAppId、userId、userSig、patientUserId、assistant_id、isLochostVod
POST	/tcm.diagnosis/startCall	diagnosis_id、patient_id、call_type
POST	/tcm.diagnosis/bindCallRoom	diagnosis_id、room_id
POST	/tcm.diagnosis/startCloudRecording	diagnosis_id
POST	/tcm.diagnosis/endCall	diagnosis_id
GET	/tcm.diagnosis/getCallRecords	diagnosis_id
POST	/tcm.diagnosis/attachLocalCallRecording	diagnosis_id、file_url、可选 call_record_id
POST	/tcm.diagnosis/createManualCallRecord	diagnosis_id
GET	/tcm.diagnosis/watchCall	diagnosis_id
POST	/tcm.diagnosis/generateMiniProgramQrcode	diagnosis_id、patient_id、doctor_id、share_user_id 等

7. 可复用约定

请求协议
- baseURL 来自 VITE_APP_BASE_URL，统一 URL 前缀 adminapi。
- token 放在名为 token 的请求头，不是 Bearer Authorization。
- POST 默认把 params 转为 body；GET 使用 params。
- 标准成功响应是 code=1，业务数据自动解包为 data。
- GET 网络失败默认最多重试 2 次，POST 不自动重试。
列表协议
- 请求 page_no、page_size。
- 响应 lists、count、extend。
- 定时刷新使用 getLists({ silent: true })，避免表格白屏闪烁。
标识约定
- diagnosis_id 是诊单主键。
- appointment.id 是挂号主键。
- prescription.id 是处方主键。
- prescriptionOrder.id 是处方业务订单主键。
- patientUserId 是腾讯云 IM/TRTC 用户名，通常 patient_加患者标识。
隐私
- 默认手机号 3-4-4 脱敏，身份证保留前 6 后 4。
- tcm.diagnosis/phonePlain 控制诊单编辑中的明文能力。
- 数据范围由后端按角色、部门、归属医助裁剪，前端只做 UI 能力门控。
复用组件
- 患者摘要/病例：PatientInfoCard、PatientCaseCard。
- 日常记录：DailyMatrix。
- 医生备注：NoteTimeline。
- 诊单编辑和只读：tcm/diagnosis/edit.vue 的 open、openViewOnly。
- 处方开立/查看：TcmPrescription 的 open、openById。
- 视频通讯：ChatDialog 的 open。
- 业务订单详情：PrescriptionOrderDetailDrawer。
状态文本
- 不建议在新客户端重复定义状态映射。优先抽取 D:\web\zyt\admin\src\views\consumer\prescription\components\prescription-order-utils.ts 中的审核、履约、支付、供货和物流格式化逻辑为共享领域模块。

8. 未知点、歧义与风险

动态菜单缺口：admin 前端仓库没有生产环境 /auth.admin/mySelf 的 menu 数据，因此接诊台、处方库、患者、问诊列表的精确 URL、菜单标题和页面级 route.meta.perms 仍未知。
API 类型不足：tcm.ts、doctor.ts 多数参数和返回值是 any；本文列出的响应字段来自实际页面读取，不等于完整服务端 schema。后续实现应抓取真实响应或检查服务端 DTO。
patient_id 语义有重载：
- 挂号行中 patient_id 常被当作诊单/患者标识；
- 我的患者 openAppointment 又把 diagnosis_id 或 id 同时写进 id 和 patient_id；
- ChatDialog 则把它转换为 patient_前缀的腾讯云用户。新客户端必须先确认数据库实体关系，不能只按字段名推断。
接诊台发起通话使用 diagnosis_id || row.id；row.id 本身是挂号 ID。若后端要求真正诊单 ID，这个回退可能只在特定历史数据下成立。
视频二维码参数疑点：tcm/appointment/list.vue 的一个入口把 diagnosis_id 赋为 row.doctor_id，而其他入口使用真正诊单 ID；这很可能是历史兼容或缺陷，应向后端核实后再复用。
权限命名不统一：
- 处方库用 wcf.prescription/*；
- 已开处方用 cf.prescription/*；
- 新增能力又混用 tcm.prescription/* 与 tcm.prescriptionOrder/*。不能按字符串前缀自动推导资源。
角色配置存在差异：
- 消费者处方审核页面写死 0、3；
- 业务订单共享工具写死 0、3、6；
- 多处注释都声称与服务端配置一致。最终角色应由服务端下发 capability，避免继续硬编码。
权限 UI 不是安全边界：部分接诊、药品和通话按钮没有 v-perms；所有写接口必须继续依赖服务端鉴权。
双 SDK 并存：
- 实际 ChatDialog 使用 @tencentcloud/call-uikit-vue；
- 未引用的 video-call/index.vue 使用 @trtc/calls-uikit-vue；
- 医助旁观直接使用 trtc-sdk-v5。新项目应明确只保留一套主叫/被叫 UI SDK，并将纯 TRTC 旁观作为独立只拉流能力。
src/components/video-call/index.vue 当前没有被任何 Vue/TS 源码引用，不应误认为生产主链。
PatientCaseCard 的 caseTypeLabel 无论 consultation_type 都返回“复诊”，属于明显展示逻辑疑点。
录制启动/停止部分依赖 TUICallKit 内部 store、引擎属性和方法包装，升级腾讯云 SDK 时风险较高，必须用真实双端通话、拒接、对端挂断、网络中断和房间号延迟场景回归。
处方业务订单大量前端角色规则与 server/config/project.php 注释耦合；当前审计范围只有 admin 前端，无法验证服务端配置是否已同步。

9. 面向新医生端的建议映射

若新项目要复刻医生工作流，建议按领域而不是按现有目录命名：

/login：复用认证协议和企业微信登录。
/reception：复用接诊台队列、详情、5 秒静默刷新与 ChatDialog。
/prescription-library：复用 prescriptionLibrary 模板及所有权规则。
/prescriptions：复用 tcm.prescription 列表、审核、作废、打印/下载。
/patients：优先复用 firstvisit.myPatient，而不是 user.user/lists。
/consultations：复用 doctor.appointment/lists 的今天待接诊视图。
/diagnoses：复用 tcm.diagnosis/lists 的完整诊单工作台。
/video-consultation：主叫链路复用 ChatDialog/TUICallKit；医助旁观保持独立 TRTC 只拉流组件。

这些建议 URL 是新端的信息架构建议，不是对 admin 当前动态 URL 的断言。

38 KiB Raw Blame History Unescape Escape

admin 医生端源码审计

1. 结论摘要

2. 关键源码与路由

2.1 页面定位

2.2 动态路由机制

3. 登录、认证、权限和状态管理

3.1 登录链路

3.2 Pinia 与页面状态

3.3 权限判断语义

4. 业务页面审计

4.1 接诊台

4.2 我的处方库

4.3 药品库（容易和处方库混淆）

4.4 已开处方/处方管理

4.5 处方业务订单

4.6 我的患者

4.7 问诊/挂号列表

4.8 诊单列表

5. 视频问诊完整链路

5.1 预约

5.2 医生发起通话

5.3 截屏、录制与回放

5.4 医助旁观

5.5 视频二维码

6. API 总表

6.1 认证

6.2 挂号与接诊

6.3 诊单

6.4 处方与业务订单

6.5 视频

7. 可复用约定

8. 未知点、歧义与风险

9. 面向新医生端的建议映射

38 KiB

Raw Blame History