Skip to content

P
pac
Commit d587df92 by luoqi
Options

fix(web): connect host image links and appointment phone placeholders

parent fa9ba3be
Pipeline #3816 failed in 0 seconds
Showing with 245 additions and 33 deletions
apps/pac-docs/content/docs/integration/overview.mdx
......@@ -93,15 +93,17 @@ PAC 出站 API 统一 ISO 8601 带时区 + 整数分。
```jsonc
{
"VIEW_PATIENT": "https://host.example.com/patient/{patientId}",
"VIEW_EMR": "https://host.example.com/emr?patientId={patientId}",
"CREATE_APPOINTMENT": "https://host.example.com/appointment/new?patientId={patientId}",
"VIEW_XRAY": null, // null = 不支持,按钮不渲染
"VIEW_MEDICAL_RECORD": "https://host.example.com/emr?patientId={patientId}",
"CREATE_APPOINTMENT": "https://host.example.com/appointment/new?patientId={patientId}&phone={phone}",
"VIEW_IMAGE": "https://host.example.com/patients/{patientId}/images",
"CALL_PATIENT": null
}
```
**只提供宿主方能支持的**,不写或填 `null` 都行。占位符 `{patientId}` / `{appointmentId}` / `{emrId}` / `{clinicId}` / `{userId}` 按字面替换。
`{patientId}` 使用宿主患者 ID；新建预约可用 `{phone}` 带入患者联系电话。查看影像可按 `{patientId}` 打开患者影像中心，或按 `{imageId}` 打开单张影像。已配置影像模板时优先使用模板；未配置时，影像记录中的完整文件链接仍可打开。
**打开方式**:PAC 前端 `window.open(url)`(新标签)或 `_top`(整页跳宿主页)。患者上下文经 URL 参数带过去,宿主页预填。
**动作没有独立页(是弹窗 / 组件)**:宿主给一个能触发弹窗的**深链参数**即可,仍是链接 —— 无需 postMessage:
......
apps/pac-web/src/components/plan-detail/drawer.tsx
......@@ -6,6 +6,8 @@ import { Chip } from './shared';
import { ChainDetailView } from './chain-viz';
import { EmrSoapView } from './emr-soap-view';
import { FactsTimeline } from './facts-timeline';
import { HostImageLink } from './host-image-link';
import type { HostActionContext } from '@/lib/image-action-url';
import { ToothTimeline } from './tooth-timeline';
import { PersonaDetailList } from './persona-detail-list';
import type { Chain, PersonaFeature, PlanReason } from './mock-data';
......@@ -25,6 +27,8 @@ export function Drawer({
reason,
reasons,
facts,
hostActionContext,
sourceUnit,
fmtRel,
returnVisits,
summaryOverride,
......@@ -47,6 +51,8 @@ export function Drawer({
reasons: PlanReason[];
/// v2.1:所有 active fact(FactsTimeline + ImageDrawer 用)
facts: AdaptedFact[];
hostActionContext: HostActionContext;
sourceUnit?: string | null;
fmtRel: (d: Date) => string;
/// 历史联系(诊所回访)结构化记录 — 「历史联系」卡片「详情」抽屉用
returnVisits: ReturnVisitItem[];
......@@ -91,19 +97,19 @@ export function Drawer({
subtitle = imageFacts.length > 0
? `最早 ${imageFacts[imageFacts.length - 1]?.occurredAt?.slice(0, 10) ?? '—'} ~ 最近 ${imageFacts[0]?.occurredAt?.slice(0, 10) ?? '—'}`
: '无影像 fact';
body = <ImageFactsView facts={imageFacts} />;
body = <ImageFactsView facts={imageFacts} hostActionContext={hostActionContext} sourceUnit={sourceUnit} />;
width = 'w-[640px]';
} else if (kind === 'facts') {
title = `患者事实时间轴(${facts.length})`;
subtitle = '按时间倒序';
body = <FactsTimeline facts={facts} />;
body = <FactsTimeline facts={facts} hostActionContext={hostActionContext} sourceUnit={sourceUnit} />;
width = 'w-[640px]';
} else if (kind === 'treatments') {
// 治疗历史卡「详情」:同 facts 时间轴,默认只勾选治疗(可在 chip 里再放开看其余)
const txCount = facts.filter((f) => f.type === 'treatment_record').length;
title = `治疗时间轴(${txCount})`;
subtitle = '仅治疗 · 时间倒序(治疗计划可在上方筛选打开)';
body = <FactsTimeline facts={facts} initialTypes={['treatment_record']} />;
body = <FactsTimeline facts={facts} initialTypes={['treatment_record']} hostActionContext={hostActionContext} sourceUnit={sourceUnit} />;
width = 'w-[640px]';
} else if (kind === 'return-visits') {
title = `历史联系(${returnVisits.length})`;
......@@ -207,14 +213,15 @@ function StreamingHint() {
// ImageFactsView — image_record fact 列表(真实数据)
// 影像原图走宿主系统(actionUrls.VIEW_IMAGE);此处只展示 metadata + finding
// ──────────────────────────────────────────
function ImageFactsView({ facts }: { facts: AdaptedFact[] }) {
function ImageFactsView({ facts, hostActionContext, sourceUnit }: {
facts: AdaptedFact[];
hostActionContext: HostActionContext;
sourceUnit?: string | null;
}) {
if (facts.length === 0) {
return (
<div className="text-center py-12 text-sm text-slate-400">
无影像 fact
<div className="text-[10.5px] mt-1.5">
(DW 给的是 metadata + URL,原图走宿主影像系统跳转)
</div>
暂无已同步的影像资料
</div>
);
}
......@@ -255,11 +262,14 @@ function ImageFactsView({ facts }: { facts: AdaptedFact[] }) {
source encounter: {encId}
</div>
)}
<div className="mt-1.5">
<HostImageLink context={hostActionContext} sourceUnit={sourceUnit} fact={f} />
</div>
</div>
);
})}
<div className="text-[10.5px] text-slate-400 pt-2 border-t">
如需查看原始 DICOM,请跳转宿主影像系统(deep-link 待 host actionUrls 接入)
影像原件由宿主影像系统提供
</div>
</div>
);
......
apps/pac-web/src/components/plan-detail/facts-timeline.tsx
......@@ -21,6 +21,8 @@ import {
import { diagnosisCodeNameZh, treatmentCategoryNameZh } from '@pac/types';
import { cn } from '@/lib/utils';
import type { AdaptedFact } from './adapt-data';
import { HostImageLink } from './host-image-link';
import type { HostActionContext } from '@/lib/image-action-url';
/**
* FactsTimeline — 患者事实时间轴(drawer 用)
......@@ -34,10 +36,14 @@ import type { AdaptedFact } from './adapt-data';
export function FactsTimeline({
facts,
initialTypes,
hostActionContext,
sourceUnit,
}: {
facts: AdaptedFact[];
/// 初始勾选的 fact_type(缺省全选);如治疗历史卡「详情」传 ['treatment_record'] → 默认只看治疗时间轴
initialTypes?: string[];
hostActionContext: HostActionContext;
sourceUnit?: string | null;
}) {
if (facts.length === 0) {
return <div className="text-center py-12 text-sm text-slate-400">无 fact</div>;
......@@ -155,7 +161,7 @@ export function FactsTimeline({
<div className="relative pl-6">
<div className="absolute left-[10px] top-1 bottom-1 w-px bg-slate-200" />
{sorted.map((f) => (
<TimelineRow key={f.id} fact={f} />
<TimelineRow key={f.id} fact={f} hostActionContext={hostActionContext} sourceUnit={sourceUnit} />
))}
</div>
)}
......@@ -292,7 +298,11 @@ function StatBlock({ label, children }: { label: string; children: React.ReactNo
// 单个 fact 时间轴行
// ─────────────────────────────────────────────
function TimelineRow({ fact }: { fact: AdaptedFact }) {
function TimelineRow({ fact, hostActionContext, sourceUnit }: {
fact: AdaptedFact;
hostActionContext: HostActionContext;
sourceUnit?: string | null;
}) {
const meta = FACT_META[fact.type] ?? FACT_META_FALLBACK;
const Icon = meta.Icon;
......@@ -314,8 +324,6 @@ function TimelineRow({ fact }: { fact: AdaptedFact }) {
const { title, note } = factSummary(fact);
const rightLines = rightColumn(fact);
const imageUrl = fact.content?.image_file_url ??
(fact.type === 'image_record' ? fact.content?.file_url : null);
return (
<div className="relative pb-3">
......@@ -340,10 +348,7 @@ function TimelineRow({ fact }: { fact: AdaptedFact }) {
{note && (
<div className="text-[11px] text-slate-500 leading-snug mt-0.5 line-clamp-2">{note}</div>
)}
{typeof imageUrl === 'string' && /^https?:\/\//i.test(imageUrl) && (
<a href={imageUrl} target="_blank" rel="noopener noreferrer"
className="text-[11px] text-brand-600 hover:underline">查看影像</a>
)}
<HostImageLink context={hostActionContext} sourceUnit={sourceUnit} fact={fact} />
</div>
{rightLines.length > 0 && (
<div className="flex flex-col items-end gap-0.5 text-[11.5px] text-slate-600 tabular-nums whitespace-nowrap">
......
apps/pac-web/src/components/plan-detail/host-image-link.test.tsx 0 → 100644
import { beforeEach, describe, expect, it, vi } from 'vitest';
import { renderToStaticMarkup } from 'react-dom/server';
import { HOST_ACTION_META } from '@pac/types';
import { resolveActionUrl } from '@/lib/action-url';
import { resolveImageActionUrl, type ImageActionFact } from '@/lib/image-action-url';
import { HostImageLink } from './host-image-link';
import { FactsTimeline } from './facts-timeline';
import type { AdaptedFact } from './adapt-data';
const state = vi.hoisted(() => ({ actionUrls: {} as Record<string, string | null> }));
vi.mock('@/stores/auth-store', () => ({
useAuthStore: { getState: () => ({ user: { actionUrls: state.actionUrls } }) },
}));
const context = {
patientId: 'host-patient-123',
phone: '+86 13800000000',
brandId: 'brand-1',
clinicId: 'target-clinic',
medicalRecordNumber: 'MR-123',
};
const fact: AdaptedFact = {
id: 'pac-fact-uuid', type: 'image_record', kind: 'actual', status: 'active',
occurredAt: '2026-10-15T06:40:00Z', plannedFor: null,
clinicId: 'image-clinic', title: null, summary: null,
content: { image_external_id: 'host-image-456', file_url: 'oss/relative.jpg' },
};
beforeEach(() => { state.actionUrls = {}; });
describe('宿主预约与影像跳转', () => {
it('预约模板同时填入宿主患者 ID 和 URL 编码后的原始电话', () => {
state.actionUrls.CREATE_APPOINTMENT = 'https://host.example/appointment?patientId={patientId}&phone={phone}';
const result = new URL(resolveActionUrl('CREATE_APPOINTMENT', context, '普尔')!);
expect(result.searchParams.get('patientId')).toBe('host-patient-123');
expect(result.searchParams.get('phone')).toBe('+86 13800000000');
expect(HOST_ACTION_META.CREATE_APPOINTMENT.placeholders).toContain('{phone}');
});
it('患者级影像中心不依赖已同步影像或 imageId', () => {
state.actionUrls.VIEW_IMAGE = 'https://host.example/patients/{patientId}?tabKey=12';
expect(renderToStaticMarkup(<HostImageLink context={context} />))
.toContain('href="https://host.example/patients/host-patient-123?tabKey=12"');
expect(HOST_ACTION_META.VIEW_IMAGE.placeholders).toContain('{patientId}');
});
it('患者卡片仅在配置了影像插槽时显示紧凑的「影像 →」链接', () => {
const link = <HostImageLink context={context} label="影像 →" className="text-[10.5px] text-brand-700 hover:underline" />;
expect(renderToStaticMarkup(link)).toBe('');
state.actionUrls.VIEW_IMAGE = 'https://host.example/patients/{patientId}?tabKey=12';
const html = renderToStaticMarkup(link);
expect(html).toContain('影像 →');
expect(html).toContain('text-[10.5px] text-brand-700 hover:underline');
expect(html).toContain('/patients/host-patient-123?tabKey=12');
});
it('影像事实优先用宿主模板,传源 imageId、该影像诊所及患者电话', () => {
state.actionUrls.VIEW_IMAGE = 'https://host.example/images/{imageId}?patientId={patientId}&clinicId={clinicId}&phone={phone}';
const result = new URL(resolveImageActionUrl(context, '普尔', fact)!);
expect(result.pathname).toBe('/images/host-image-456');
expect(result.searchParams.get('patientId')).toBe('host-patient-123');
expect(result.searchParams.get('clinicId')).toBe('image-clinic');
expect(result.searchParams.get('phone')).toBe(context.phone);
});
it('未配置模板时保留完整文件链接', () => {
expect(resolveImageActionUrl(context, null, {
...fact, content: { ...fact.content, file_url: 'https://files.example/image.jpg?signature=abc' },
})).toBe('https://files.example/image.jpg?signature=abc');
});
it('相对文件路径不能直接打开', () => {
expect(resolveImageActionUrl(context, null, fact)).toBeUndefined();
});
it('没有 imageId 时不渲染单张影像模板的空链接', () => {
state.actionUrls.VIEW_IMAGE = 'https://host.example/images/{imageId}';
expect(renderToStaticMarkup(<HostImageLink context={context} />)).toBe('');
});
it('缺少模板所需的患者 ID 时回退到文件链接', () => {
state.actionUrls.VIEW_IMAGE = 'https://host.example/patients/{patientId}';
expect(resolveImageActionUrl({}, null, {
...fact, content: { file_url: 'https://files.example/image.jpg' },
})).toBe('https://files.example/image.jpg');
});
it('沿用患者品牌换域规则,不把瑞泰影像带去瑞尔门户', () => {
state.actionUrls.VIEW_IMAGE = 'https://arrail-test.5i5ya.com/images/{imageId}';
expect(resolveImageActionUrl(context, '瑞泰', fact))
.toBe('https://rytime-test.5i5ya.com/images/host-image-456');
});
it('影像分析关联诊断使用对应的源影像 ID', () => {
state.actionUrls.VIEW_IMAGE = 'https://host.example/images/{imageId}';
const linked: ImageActionFact = {
type: 'diagnosis_record', content: { source_image_external_id: 'linked-image' },
};
expect(resolveImageActionUrl(context, null, linked)).toBe('https://host.example/images/linked-image');
expect(resolveImageActionUrl(context, null, { type: 'diagnosis_record', content: { code: 'K02' } }))
.toBeUndefined();
});
it('真实时间轴的影像入口使用患者模板,按新标签页打开', () => {
state.actionUrls.VIEW_IMAGE = 'https://host.example/patients/{patientId}?tabKey=12';
const html = renderToStaticMarkup(
<FactsTimeline facts={[fact]} hostActionContext={context} sourceUnit="普尔" />,
);
expect(html).toContain('href="https://host.example/patients/host-patient-123?tabKey=12"');
expect(html).toContain('target="_blank"');
expect(html).toContain('rel="noopener noreferrer"');
});
});
apps/pac-web/src/components/plan-detail/host-image-link.tsx 0 → 100644
'use client';
import { HOST_LINK_PROPS, openHostUrl } from '@/lib/action-url';
import { resolveImageActionUrl, type HostActionContext, type ImageActionFact } from '@/lib/image-action-url';
export function HostImageLink({
context,
sourceUnit,
fact,
label = '查看影像',
className = 'text-[11px] text-brand-600 hover:underline',
}: {
context: HostActionContext;
sourceUnit?: string | null;
fact?: ImageActionFact;
label?: string;
className?: string;
}) {
const url = resolveImageActionUrl(context, sourceUnit, fact);
if (!url) return null;
return (
<a
href={url}
{...HOST_LINK_PROPS}
className={className}
onClick={(e) => {
e.preventDefault();
openHostUrl(url);
}}
>
{label}
</a>
);
}
apps/pac-web/src/components/plan-detail/plan-detail-app.tsx
......@@ -33,6 +33,7 @@ import { isEmbedded } from '@/lib/embed';
import { hostActionMode, openHostAction } from '@/lib/host-message';
import { CloseOpportunityDialog } from './close-opportunity-dialog';
import { resolveActionUrl, openHostUrl, HOST_LINK_PROPS } from '@/lib/action-url';
import { HostImageLink } from './host-image-link';
import {
cn,
formatGender,
......@@ -464,6 +465,7 @@ export function PlanDetailApp({
// 未配置 → 回调传 undefined → 按钮不渲染(PAC 默认无此动作)。预约:CREATE_APPOINTMENT 跳转。
const hostActionCtx = {
patientId: patient.externalId,
phone: patient.phone,
brandId: patient.brandId,
clinicId: plan?.targetClinicId,
medicalRecordNumber: patient.medicalRecordNumber,
......@@ -586,12 +588,7 @@ export function PlanDetailApp({
// 宿主 actionUrls.CREATE_APPOINTMENT(会话下发)→ 通用占位替换 → 打开宿主页。
// 未配置则提示去配,不写死任何 URL。缺失键清空。
// ⚠️ URL 先解析:没配的话**不该先把单结了**再告诉他跳不过去。
const url = resolveActionUrl('CREATE_APPOINTMENT', {
patientId: patient.externalId,
brandId: patient.brandId,
clinicId: plan?.targetClinicId,
medicalRecordNumber: patient.medicalRecordNumber,
}, patient.sourceUnit);
const url = resolveActionUrl('CREATE_APPOINTMENT', hostActionCtx, patient.sourceUnit);
if (!url) {
showToast('amber', '未配置新建预约', '请在宿主管理页配置 actionUrls.CREATE_APPOINTMENT');
return false;
......@@ -713,9 +710,7 @@ export function PlanDetailApp({
setPersonaFocusKey(key);
setDrawerOpen('persona');
}}
onOpenImage={() =>
showToast('slate', '影像调阅', '跳转宿主页面')
}
hostActionContext={hostActionCtx}
onOpenProfile={() =>
showToast('slate', '患者档案', '跳转宿主页面')
}
......@@ -994,6 +989,8 @@ export function PlanDetailApp({
reason={focusedReason ?? reasons[0]!}
reasons={reasons}
facts={facts}
hostActionContext={hostActionCtx}
sourceUnit={patient.sourceUnit}
fmtRel={fmtRel}
returnVisits={returnVisits}
summaryOverride={summaryOverride}
......@@ -1629,7 +1626,7 @@ function IdentityCard({
patient,
features,
onOpenPersonaFeature,
onOpenImage,
hostActionContext,
onOpenProfile,
}: {
patient: typeof mockPatient;
......@@ -1637,7 +1634,7 @@ function IdentityCard({
features: typeof mockPersona.features;
/** 点关键标签 → 开画像详情抽屉并滚到那一条 */
onOpenPersonaFeature: (featureKey: string) => void;
onOpenImage: () => void;
hostActionContext: Record<string, string | null | undefined>;
onOpenProfile: () => void;
}) {
// 关键标签 —— 姓名下面直接展示,客服不用点开抽屉就能判断「能不能打、该聊什么」。
......@@ -1699,6 +1696,12 @@ function IdentityCard({
</span>
</div>
<div className="flex items-center gap-2 flex-none">
<HostImageLink
context={hostActionContext}
sourceUnit={patient.sourceUnit}
label="影像 →"
className="text-[10.5px] text-brand-700 hover:underline whitespace-nowrap"
/>
{/* 潜在治疗入口已上移到顶栏「潜在」按钮(与 预约 / 回访 同处右上角动作区)。 */}
{/* 原始档案 —— 宿主 VIEW_PATIENT 跳转(占位 {patientId}/{medicalRecordNumber});未配则不渲染 */}
{originalArchiveUrl ? (
......
apps/pac-web/src/lib/image-action-url.ts 0 → 100644
import { actionTemplate, resolveActionUrl } from './action-url';
export type HostActionContext = Record<string, string | null | undefined>;
export interface ImageActionFact {
type: string;
clinicId?: string | null;
content?: Record<string, unknown> | null;
}
/** 影像入口统一用宿主模板;没有可用模板时保留完整文件链接。 */
export function resolveImageActionUrl(
context: HostActionContext,
sourceUnit?: string | null,
fact?: ImageActionFact,
): string | undefined {
const content = fact?.content ?? {};
const imageId = content.image_external_id ?? content.source_image_external_id;
if (fact && fact.type !== 'image_record' && fact.type !== 'image_analysis_record'
&& !imageId && !content.image_file_url) return undefined;
const ctx: HostActionContext = {
...context,
clinicId: fact?.clinicId ?? context.clinicId,
imageId: typeof imageId === 'string' ? imageId : undefined,
};
const template = actionTemplate('VIEW_IMAGE');
// 患者级入口没有 imageId,不能把单张影像模板里的标识清空后跳走。
const missingId = ['patientId', 'imageId'].some((key) =>
template?.includes(`{${key}}`) && !ctx[key]);
if (template?.trim() && !missingId) {
return resolveActionUrl('VIEW_IMAGE', ctx, sourceUnit);
}
const fileUrl = content.image_file_url ?? (fact?.type === 'image_record' ? content.file_url : null);
return typeof fileUrl === 'string' && /^https?:\/\//i.test(fileUrl) ? fileUrl : undefined;
}
apps/pac-web/vitest.config.ts 0 → 100644
import { fileURLToPath } from 'node:url';
import { defineConfig } from 'vitest/config';
export default defineConfig({
resolve: { alias: { '@': fileURLToPath(new URL('./src', import.meta.url)) } },
esbuild: { jsx: 'automatic' },
test: { maxWorkers: 1 },
});
packages/types/src/enums/index.ts
......@@ -127,11 +127,11 @@ export type HostActionKey = (typeof HostActionKey)[keyof typeof HostActionKey];
export const HOST_ACTION_META: Record<HostActionKey, { label: string; placeholders: string[] }> = {
VIEW_PATIENT: { label: '查看患者档案(原始档案)', placeholders: ['{patientId}', '{medicalRecordNumber}'] },
EDIT_PATIENT: { label: '编辑患者信息', placeholders: ['{patientId}'] },
CREATE_APPOINTMENT: { label: '新建预约', placeholders: ['{patientId}', '{doctorId}'] },
CREATE_APPOINTMENT: { label: '新建预约', placeholders: ['{patientId}', '{phone}', '{doctorId}'] },
VIEW_APPOINTMENT: { label: '查看预约', placeholders: ['{appointmentId}'] },
VIEW_ENCOUNTER: { label: '查看接诊', placeholders: ['{encounterId}'] },
VIEW_MEDICAL_RECORD: { label: '查看病历(电子病历)', placeholders: ['{brandId}', '{clinicId}', '{medicalRecordNumber}', '{patientId}'] },
VIEW_IMAGE: { label: '查看影像', placeholders: ['{imageId}'] },
VIEW_IMAGE: { label: '查看影像', placeholders: ['{patientId}', '{imageId}', '{phone}', '{brandId}', '{clinicId}', '{medicalRecordNumber}'] },
VIEW_PAYMENT: { label: '查看账单/收款', placeholders: ['{paymentId}', '{orderId}'] },
ADD_NOTE: { label: '添加备注', placeholders: ['{patientId}'] },
OPEN_WECOM_CHAT: { label: '打开企微会话', placeholders: ['{patientId}', '{wecomExternalUserId}'] },
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment