799 lines
25 KiB
Markdown
799 lines
25 KiB
Markdown
---
|
||
title: 三端联调审计问题修复设计规格
|
||
created: 2026-05-01
|
||
status: draft
|
||
scope: 全量修复（15 项）
|
||
estimated_effort: 23h
|
||
phases: 3
|
||
---
|
||
|
||
# 三端联调审计问题修复设计规格
|
||
|
||
> 基于 `docs/discussions/2026-05-01-tri-platform-integration-audit.md` 审计报告，
|
||
> 经 4 个专家组（统一性治理/功能孤岛/小程序/数据质量）代码级分析后整合的修复方案。
|
||
|
||
## 问题总览
|
||
|
||
| 级别 | # | 问题 | 专家组 | 工作量 |
|
||
|------|---|------|--------|--------|
|
||
| P0 | 1 | erp-plugin 测试编译失败 | 基础设施 | 5min |
|
||
| P0 | 2 | 品牌命名与主题设置联动 | 统一性 | 2h |
|
||
| P1 | 3 | 告警页面侧边栏无入口 | 统一性 | 1h |
|
||
| P1 | 4 | 行动收件箱侧边栏无入口 | 孤岛 | 0.5h |
|
||
| P1 | 5 | 危急值告警端点 500 | 基础设施 | 0.5h |
|
||
| P1 | 6 | domain_events 堆积 1166 条 | 基础设施 | 1h |
|
||
| P2 | 7 | 患者详情关联导航缺失 | 统一性 | 2h |
|
||
| P2 | 8 | AI 分析列表无患者 Link | 统一性 | 1h |
|
||
| P2 | 9 | 小程序 AI 建议跳转错误 | 小程序 | 0.5h |
|
||
| P2 | 10 | 小程序通知 Tab 空壳 | 小程序 | 1h |
|
||
| P2 | 11 | 小程序咨询功能孤立 | 小程序 | 0.5h |
|
||
| P3 | 12 | AI 分析 SSE 无触发入口 | 孤岛 | 4h |
|
||
| P3 | 13 | 家属管理无 UI | 孤岛 | 3h |
|
||
| P3 | 14 | E2E 测试数据污染 | 基础设施 | 1h |
|
||
| P4 | 15 | 统计仪表盘消费验证 | 孤岛 | 1h |
|
||
|
||
## 实施阶段
|
||
|
||
- **Phase 1（快速修复，~5h）**: #1-#6 — 主题设置联动、菜单入口、测试修复、危急值 500、事件堆积
|
||
- **Phase 2（体验补全，~5.5h）**: #7-#11 — 导航关联、小程序修复
|
||
- **Phase 3（功能闭环，~9h）**: #12-#15 — AI SSE 入口、家属管理、E2E 清理、统计验证
|
||
|
||
---
|
||
|
||
## #1: erp-plugin 测试编译失败 [P0]
|
||
|
||
### 根因
|
||
|
||
`crates/erp-plugin/src/plugin_validator.rs` 的 `#[cfg(test)] mod tests` 中调用了 `parse_manifest()`，但该函数在同 crate 的 `manifest.rs` 中。测试模块的 `use super::*` 只引入 `plugin_validator` 模块的公开项。
|
||
|
||
### 修复
|
||
|
||
**文件**: `crates/erp-plugin/src/plugin_validator.rs`
|
||
|
||
在测试模块中添加 1 行导入：
|
||
|
||
```rust
|
||
#[cfg(test)]
|
||
mod tests {
|
||
use super::*;
|
||
use crate::manifest::parse_manifest; // 新增
|
||
```
|
||
|
||
### 验证
|
||
|
||
```bash
|
||
cargo test -p erp-plugin --no-run
|
||
```
|
||
|
||
---
|
||
|
||
## #2: 品牌命名与主题设置联动 [P0]
|
||
|
||
### 根因
|
||
|
||
1. 登录页 `Login.tsx` 硬编码 "HMR Platform"、副标题、版权信息
|
||
2. 后端 `ThemeResp` 只有 3 个字段（`primary_color`/`logo_url`/`sidebar_style`），缺少品牌名称、系统描述、版权等配置项
|
||
3. 前端主题设置页面 `ThemeSettings.tsx` 只展示 3 个字段，主题设置实际未起到管理品牌信息的作用
|
||
4. 侧边栏/页脚的品牌文字也是硬编码
|
||
|
||
### 设计思路
|
||
|
||
扩展现有主题设置体系，将品牌信息纳入主题配置。后端 ThemeResp 增加品牌字段，前端 ThemeSettings 页面增加品牌信息编辑区域，Login/MainLayout 从主题配置读取品牌信息。
|
||
|
||
### 后端修改
|
||
|
||
**文件**: `crates/erp-config/src/dto.rs` — ThemeResp 增加字段
|
||
|
||
```rust
|
||
pub struct ThemeResp {
|
||
// 已有字段
|
||
pub primary_color: Option<String>,
|
||
pub logo_url: Option<String>,
|
||
pub sidebar_style: Option<String>,
|
||
|
||
// 新增品牌字段
|
||
#[serde(skip_serializing_if = "Option::is_none")]
|
||
pub brand_name: Option<String>, // 品牌名称，如 "HMS 健康管理平台"
|
||
#[serde(skip_serializing_if = "Option::is_none")]
|
||
pub brand_slogan: Option<String>, // 品牌标语，如 "新一代健康管理平台"
|
||
#[serde(skip_serializing_if = "Option::is_none")]
|
||
pub brand_features: Option<String>, // 功能亮点，如 "患者管理 · 健康监测 · 随访管理 · AI 智能分析"
|
||
#[serde(skip_serializing_if = "Option::is_none")]
|
||
pub brand_copyright: Option<String>, // 版权信息，如 "HMS 健康管理平台 · ©汕头市智界科技有限公司"
|
||
}
|
||
```
|
||
|
||
**文件**: `crates/erp-config/src/handler/theme_handler.rs` — 默认值更新
|
||
|
||
```rust
|
||
fn default_theme() -> ThemeResp {
|
||
ThemeResp {
|
||
primary_color: None,
|
||
logo_url: None,
|
||
sidebar_style: None,
|
||
brand_name: Some("HMS 健康管理平台".into()),
|
||
brand_slogan: Some("新一代健康管理平台".into()),
|
||
brand_features: Some("患者管理 · 健康监测 · 随访管理 · AI 智能分析".into()),
|
||
brand_copyright: Some("HMS 健康管理平台 · ©汕头市智界科技有限公司".into()),
|
||
}
|
||
}
|
||
```
|
||
|
||
**新增公开端点**: `crates/erp-config/src/handler/theme_handler.rs`
|
||
|
||
```rust
|
||
/// GET /api/v1/public/theme — 公开主题端点（无需认证）
|
||
/// 只返回品牌信息，用于登录页等未认证场景。
|
||
pub async fn get_public_theme<S>(
|
||
State(state): State<ConfigState>,
|
||
Extension(ctx): Extension<TenantContext>,
|
||
) -> Result<JsonResponse<ApiResponse<PublicThemeResp>>, AppError>
|
||
where
|
||
ConfigState: FromRef<S>,
|
||
S: Clone + Send + Sync + 'static,
|
||
{
|
||
// 从 settings 读取，返回品牌字段即可
|
||
// 如果租户上下文不存在，返回默认品牌信息
|
||
}
|
||
```
|
||
|
||
此端点需要在 `erp-server` 的公开路由组（无需认证）中注册。
|
||
|
||
### 前端修改
|
||
|
||
**文件**: `apps/web/src/api/themes.ts` — 扩展 ThemeConfig
|
||
|
||
```typescript
|
||
export interface ThemeConfig {
|
||
primary_color?: string;
|
||
logo_url?: string;
|
||
sidebar_style?: 'light' | 'dark';
|
||
// 新增
|
||
brand_name?: string;
|
||
brand_slogan?: string;
|
||
brand_features?: string;
|
||
brand_copyright?: string;
|
||
}
|
||
```
|
||
|
||
**文件**: `apps/web/src/stores/app.ts` — 缓存主题配置
|
||
|
||
在 app store 中增加 `themeConfig: ThemeConfig | null` 字段，login 后自动加载并缓存到 localStorage。提供 `loadThemeConfig()` action。
|
||
|
||
**文件**: `apps/web/src/pages/settings/ThemeSettings.tsx` — 增加品牌信息区域
|
||
|
||
在现有表单下方增加"品牌信息"分组（Divider 分隔）：
|
||
|
||
```tsx
|
||
<Divider>品牌信息</Divider>
|
||
<Form.Item name="brand_name" label="品牌名称">
|
||
<Input placeholder="HMS 健康管理平台" />
|
||
</Form.Item>
|
||
<Form.Item name="brand_slogan" label="品牌标语">
|
||
<Input placeholder="新一代健康管理平台" />
|
||
</Form.Item>
|
||
<Form.Item name="brand_features" label="功能亮点">
|
||
<Input placeholder="患者管理 · 健康监测 · 随访管理 · AI 智能分析" />
|
||
</Form.Item>
|
||
<Form.Item name="brand_copyright" label="版权信息">
|
||
<Input placeholder="HMS 健康管理平台 · ©汕头市智界科技有限公司" />
|
||
</Form.Item>
|
||
```
|
||
|
||
**文件**: `apps/web/src/pages/Login.tsx` — 从主题配置读取
|
||
|
||
**关键问题**: 登录页在未认证状态下无法调用 `/api/v1/themes`（需要 token）。解决方案：
|
||
|
||
1. 登录页先尝试从 `localStorage('hms-theme-config')` 读取缓存的主题配置
|
||
2. 同时将后端 `GET /api/v1/themes` 端点增加一个**无需认证**的公开端点 `GET /api/v1/public/theme`（只返回品牌信息，不含 sidebar_style 等内部配置）
|
||
3. Login 组件 mount 时调用公开端点获取品牌信息，失败则用 localStorage 缓存，再失败用硬编码默认值
|
||
|
||
```tsx
|
||
// Login.tsx
|
||
const [brandConfig, setBrandConfig] = useState<{
|
||
brand_name?: string;
|
||
brand_slogan?: string;
|
||
brand_features?: string;
|
||
brand_copyright?: string;
|
||
} | null>(null);
|
||
|
||
useEffect(() => {
|
||
// 尝试从公开端点获取品牌信息
|
||
fetch('/api/v1/public/theme')
|
||
.then(res => res.json())
|
||
.then(data => {
|
||
const config = data?.data;
|
||
setBrandConfig(config);
|
||
localStorage.setItem('hms-theme-config', JSON.stringify(config));
|
||
})
|
||
.catch(() => {
|
||
// fallback: localStorage 缓存 → 默认值
|
||
const cached = localStorage.getItem('hms-theme-config');
|
||
if (cached) setBrandConfig(JSON.parse(cached));
|
||
});
|
||
}, []);
|
||
|
||
<h1 className="brand-title">{brandConfig?.brand_name || 'HMS 健康管理平台'}</h1>
|
||
<p className="brand-desc">{brandConfig?.brand_slogan || '新一代健康管理平台'}</p>
|
||
<p className="brand-sub-desc">{brandConfig?.brand_features || '患者管理 · 健康监测 · 随访管理 · AI 智能分析'}</p>
|
||
```
|
||
|
||
底部版权同理。
|
||
|
||
**文件**: `apps/web/src/layouts/MainLayout.tsx` — Footer 和侧边栏
|
||
|
||
侧边栏 Logo 文字和 Footer 版权信息也从 `themeConfig` 读取，带默认值 fallback。
|
||
|
||
### 验证
|
||
|
||
1. 在系统设置 → 主题设置中修改品牌名称为 "XX 医院健康管理"
|
||
2. 保存后刷新页面，侧边栏/页脚品牌文字更新
|
||
3. 登出后登录页显示新品牌名称
|
||
4. 未配置时回退到默认值 "HMS 健康管理平台"
|
||
|
||
---
|
||
|
||
## #3: 告警页面侧边栏无入口 [P1]
|
||
|
||
### 根因
|
||
|
||
数据库种子迁移 `m20260429_000095_seed_alert_device_menus.rs` 已插入告警菜单数据，但前端 `MainLayout.tsx` 的 `iconMap` 中缺少 `AlertOutlined`、`BellOutlined`、`ControlOutlined` 等图标映射。菜单数据返回后图标无法渲染。
|
||
|
||
### 修复
|
||
|
||
**文件**: `apps/web/src/layouts/MainLayout.tsx`
|
||
|
||
1. 在 import 区域补充图标：
|
||
|
||
```tsx
|
||
import {
|
||
// ... 已有导入 ...
|
||
AlertOutlined,
|
||
BellOutlined,
|
||
ControlOutlined,
|
||
InboxOutlined,
|
||
ApiOutlined,
|
||
ReadOutlined,
|
||
ExperimentOutlined,
|
||
} from '@ant-design/icons';
|
||
```
|
||
|
||
2. 在 `iconMap` 对象中补充映射：
|
||
|
||
```tsx
|
||
AlertOutlined: <AlertOutlined />,
|
||
BellOutlined: <BellOutlined />,
|
||
ControlOutlined: <ControlOutlined />,
|
||
InboxOutlined: <InboxOutlined />,
|
||
ApiOutlined: <ApiOutlined />,
|
||
ReadOutlined: <ReadOutlined />,
|
||
ExperimentOutlined: <ExperimentOutlined />,
|
||
```
|
||
|
||
### 验证
|
||
|
||
登录后侧边栏"健康管理"分组下出现：告警仪表盘、告警列表、告警规则、设备管理、透析管理、资讯管理菜单项，图标正确渲染。
|
||
|
||
---
|
||
|
||
## #4: 行动收件箱侧边栏无入口 [P1]
|
||
|
||
### 根因
|
||
|
||
前端代码已完整：`ActionInbox.tsx`（页面）、`ActionThreadDrawer.tsx`（组件）、`actionInbox.ts`（API）、`App.tsx:260`（路由注册）。仅缺数据库菜单种子数据。
|
||
|
||
### 修复
|
||
|
||
**新建迁移**: `crates/erp-server/migration/src/m20260501_000100_seed_action_inbox_menu.rs`
|
||
|
||
```sql
|
||
INSERT INTO menus (id, tenant_id, parent_id, title, path, icon, sort_order,
|
||
created_at, updated_at, is_active)
|
||
SELECT
|
||
'b0000003-0000-7000-8000-000000000020'::uuid,
|
||
t.id,
|
||
(SELECT id FROM menus WHERE path = '/health' AND tenant_id = t.id LIMIT 1),
|
||
'行动收件箱',
|
||
'/health/action-inbox',
|
||
'InboxOutlined',
|
||
36,
|
||
NOW(), NOW(), true
|
||
FROM tenants t
|
||
WHERE NOT EXISTS (
|
||
SELECT 1 FROM menus
|
||
WHERE path = '/health/action-inbox' AND tenant_id = t.id
|
||
);
|
||
```
|
||
|
||
同时需要种子关联 `health.action-inbox.list` 权限码（参照 `m20260501_000097_seed_menu_permissions.rs` 模式）。
|
||
|
||
### 验证
|
||
|
||
重启后端 → 刷新前端 → 侧边栏出现"行动收件箱"菜单项。
|
||
|
||
---
|
||
|
||
## #5: 危急值告警端点 500 [P1]
|
||
|
||
### 根因
|
||
|
||
代码逻辑链路完整（handler→service→entity 无 bug）。最可能根因是 `critical_alerts` 表在 RLS 批量启用迁移（m000086）之后才由 m000090 创建，导致该表缺少 RLS 策略。如果手工启用了 RLS 却无策略，查询会被阻断。
|
||
|
||
### 修复
|
||
|
||
**步骤 1**: 确认迁移状态和根因（强制验证）
|
||
|
||
```sql
|
||
-- 确认迁移已执行
|
||
SELECT * FROM seaql_migrations WHERE name LIKE '%090%';
|
||
|
||
-- 确认表存在
|
||
SELECT table_name FROM information_schema.tables
|
||
WHERE table_name IN ('critical_alerts', 'critical_alert_responses');
|
||
|
||
-- 确认 RLS 状态（关键：判断是否为 RLS 导致 500）
|
||
SELECT relname, relrowsecurity, relforcerowsecurity
|
||
FROM pg_class WHERE relname = 'critical_alerts';
|
||
-- 如果 relrowsecurity = false → 不是 RLS 问题，需查看 tracing 日志
|
||
-- 如果 relrowsecurity = true 且无 policy → 需要步骤 2
|
||
```
|
||
|
||
启动后端并调用端点，查看 tracing 日志中的具体错误信息：
|
||
```bash
|
||
cargo run
|
||
curl -H "Authorization: Bearer $TOKEN" http://localhost:3000/api/v1/health/critical-alerts
|
||
# 查看 tracing 输出确认根因
|
||
```
|
||
|
||
**步骤 2**: 根据步骤 1 结果决定是否补齐 RLS 策略
|
||
|
||
如果 RLS 已启用但缺少策略，**新建迁移**: `crates/erp-server/migration/src/m20260501_000101_rls_for_post_migration_tables.rs`
|
||
|
||
使用动态 SQL 扫描所有含 `tenant_id` 列但缺少 `tenant_isolation` 策略的表，自动补齐 RLS。
|
||
> **注意**: 此迁移需在 `migration/src/lib.rs` 中注册。
|
||
|
||
**步骤 3**: 在 `critical_alert_service.rs` 添加 tracing 日志（无论根因是 RLS 还是其他，都应加日志）
|
||
|
||
```rust
|
||
.map_err(|e| {
|
||
tracing::error!(error = %e, "查询危急值告警列表失败");
|
||
HealthError::DbError(e.to_string())
|
||
})?;
|
||
```
|
||
|
||
### 验证
|
||
|
||
```bash
|
||
curl -H "Authorization: Bearer $TOKEN" http://localhost:3000/api/v1/health/critical-alerts
|
||
# 期望: 200 + 空列表
|
||
```
|
||
|
||
---
|
||
|
||
## #6: domain_events 堆积 1166 条 [P1]
|
||
|
||
### 根因
|
||
|
||
清理函数 `cleanup_old_published_events()` 保留 90 天，项目运行不到 2 周，所有事件未满 90 天。
|
||
|
||
### 修复
|
||
|
||
**步骤 1**: 立即手动清理
|
||
|
||
```sql
|
||
INSERT INTO domain_events_archive
|
||
SELECT * FROM domain_events WHERE status = 'published';
|
||
DELETE FROM domain_events WHERE status = 'published'
|
||
AND id IN (SELECT id FROM domain_events_archive);
|
||
```
|
||
|
||
**步骤 2**: 调整保留期
|
||
|
||
**文件**: `crates/erp-server/src/tasks.rs` 第 26 行
|
||
|
||
```rust
|
||
// 修改前
|
||
"SELECT cleanup_old_published_events(90, 1000)"
|
||
// 修改后
|
||
"SELECT cleanup_old_published_events(7, 1000)"
|
||
```
|
||
|
||
**步骤 3**: 添加索引（可选）
|
||
|
||
```sql
|
||
CREATE INDEX IF NOT EXISTS idx_domain_events_status_created
|
||
ON domain_events (status, created_at ASC) WHERE status = 'pending';
|
||
```
|
||
|
||
### 验证
|
||
|
||
```sql
|
||
SELECT status, COUNT(*) FROM domain_events GROUP BY status;
|
||
-- 期望: published 数量大幅减少
|
||
```
|
||
|
||
---
|
||
|
||
## #7: 患者详情关联导航缺失 [P2]
|
||
|
||
### 根因
|
||
|
||
`PatientDetail.tsx` 有 5 个 Tab（基本信息/健康数据/随访/积分/AI建议），但无法跳转到预约、咨询、透析、全局随访等关联功能页面。
|
||
|
||
### 修复
|
||
|
||
**文件**: `apps/web/src/pages/health/PatientDetail.tsx`
|
||
|
||
在基本信息卡片与 Tabs 卡片之间添加快捷导航卡片：
|
||
|
||
```tsx
|
||
<Card style={{ marginBottom: 16, padding: '12px 16px' }}>
|
||
<Space size={8} wrap>
|
||
<Text type="secondary">快捷跳转:</Text>
|
||
<Button type="link" size="small"
|
||
onClick={() => navigate(`/health/appointments?patient_id=${id}`)}>
|
||
预约记录
|
||
</Button>
|
||
<Button type="link" size="small"
|
||
onClick={() => navigate(`/health/consultations?patient_id=${id}`)}>
|
||
咨询记录
|
||
</Button>
|
||
<Button type="link" size="small"
|
||
onClick={() => navigate(`/health/dialysis?patient_id=${id}`)}>
|
||
透析记录
|
||
</Button>
|
||
<Button type="link" size="small"
|
||
onClick={() => navigate(`/health/follow-up-tasks?patient_id=${id}`)}>
|
||
随访任务
|
||
</Button>
|
||
<Button type="link" size="small"
|
||
onClick={() => navigate(`/health/ai-analysis?patient_id=${id}`)}>
|
||
AI 分析
|
||
</Button>
|
||
</Space>
|
||
</Card>
|
||
```
|
||
|
||
**前提条件**: 目标页面需支持 URL 参数 `?patient_id=xxx` 过滤。需在以下页面添加 URL 参数读取：
|
||
|
||
- `AppointmentList.tsx`
|
||
- `ConsultationList.tsx`
|
||
- `DialysisManageList.tsx`
|
||
- `FollowUpTaskList.tsx`
|
||
- `AiAnalysisList.tsx`
|
||
|
||
各页面在初始化查询参数时从 `useSearchParams()` 读取 `patient_id` 并设为默认筛选条件。
|
||
|
||
### 验证
|
||
|
||
在患者详情页点击各快捷跳转按钮，确认目标页面自动按患者 ID 过滤。
|
||
|
||
---
|
||
|
||
## #8: AI 分析列表无患者 Link [P2]
|
||
|
||
### 根因
|
||
|
||
`AiAnalysisList.tsx` 的 `patient_id` 列只显示截断 ID（`v.slice(0, 8)`），无跳转。
|
||
|
||
### 修复
|
||
|
||
**文件**: `apps/web/src/pages/health/AiAnalysisList.tsx`
|
||
|
||
1. 添加 `import { Link } from 'react-router-dom';`
|
||
2. 修改列渲染：
|
||
|
||
```tsx
|
||
{
|
||
title: '患者',
|
||
dataIndex: 'patient_id',
|
||
key: 'patient_id',
|
||
width: 140,
|
||
render: (v: string) => (
|
||
<Link to={`/health/patients/${v}`} style={{ fontFamily: 'monospace', fontSize: 12 }}>
|
||
{v.slice(0, 8)}
|
||
</Link>
|
||
),
|
||
},
|
||
```
|
||
|
||
### 验证
|
||
|
||
AI 分析列表中患者 ID 列变为可点击链接，跳转到对应患者详情页。
|
||
|
||
---
|
||
|
||
## #9: 小程序 AI 建议跳转错误 [P2]
|
||
|
||
### 根因
|
||
|
||
`apps/miniprogram/src/pages/health/index.tsx` 第 179 行，AI 建议卡片 onClick 统一跳转到设置页 `/pages/pkg-profile/settings/index`，而非根据 `suggestion_type`（appointment/followup）跳转到对应功能页。
|
||
|
||
### 修复
|
||
|
||
**文件**: `apps/miniprogram/src/pages/health/index.tsx`
|
||
|
||
修改 onClick 处理逻辑：
|
||
|
||
```typescript
|
||
// 修改前
|
||
onClick={() => Taro.navigateTo({ url: '/pages/pkg-profile/settings/index' })}
|
||
|
||
// 修改后
|
||
onClick={() => {
|
||
if (item.suggestion_type === 'appointment') {
|
||
Taro.navigateTo({ url: `/pages/pkg-appointment/create/index?patientId=${item.patient_id}` });
|
||
} else if (item.suggestion_type === 'followup') {
|
||
Taro.navigateTo({ url: `/pages/pkg-followup/detail/index?id=${item.related_id}` });
|
||
} else {
|
||
Taro.navigateTo({ url: `/pages/health/index` }); // 通用回退
|
||
}
|
||
}}
|
||
```
|
||
|
||
### 验证
|
||
|
||
小程序健康页点击不同类型的 AI 建议卡片，确认跳转到正确页面。
|
||
|
||
---
|
||
|
||
## #10: 小程序通知 Tab 空壳 [P2]
|
||
|
||
### 根因
|
||
|
||
`apps/miniprogram/src/pages/messages/index.tsx` 第 34-37 行 `setNotifications([])` 硬编码空数组，注释"后续可对接独立通知 API"。
|
||
|
||
### 修复
|
||
|
||
**文件**: `apps/miniprogram/src/pages/messages/index.tsx`
|
||
|
||
1. 新建通知 API 服务：`apps/miniprogram/src/services/notification.ts`
|
||
|
||
后端 `erp-message` 模块通知端点完整：`GET /messages`（列表）、`PUT /messages/{id}/read`（标记已读）、`PUT /messages/read-all`（全部已读）、`GET /messages/unread-count`（未读计数）、`GET /messages/stream`（SSE 实时推送）。事件消费者覆盖 20 种事件类型。直接对接即可。
|
||
|
||
```typescript
|
||
import { api } from '@/services/request';
|
||
|
||
export const notificationService = {
|
||
list: (params?: { page?: number; page_size?: number }) =>
|
||
api.get('/messages', params),
|
||
markRead: (id: string) =>
|
||
api.put(`/messages/${id}/read`),
|
||
markAllRead: () =>
|
||
api.put('/messages/read-all'),
|
||
getUnreadCount: () =>
|
||
api.get('/messages/unread-count'),
|
||
};
|
||
```
|
||
|
||
2. 替换硬编码空数组为 API 调用：
|
||
|
||
```typescript
|
||
// 修改前
|
||
setNotifications([]);
|
||
|
||
// 修改后
|
||
try {
|
||
const res = await notificationService.list({ page: 1, page_size: 20 });
|
||
setNotifications(res?.data || []);
|
||
} catch {
|
||
setNotifications([]);
|
||
}
|
||
```
|
||
|
||
### 验证
|
||
|
||
小程序消息页"通知"Tab 展示从后端获取的数据列表。
|
||
|
||
---
|
||
|
||
## #11: 小程序咨询功能孤立 [P2]
|
||
|
||
### 根因
|
||
|
||
`/pages/consultation/index` 页面存在且已注册路由，但首页/健康页/个人中心均无入口。唯一入口在消息 Tab 的"咨询"子 Tab。
|
||
|
||
### 修复
|
||
|
||
**文件**: `apps/miniprogram/src/pages/profile/index.tsx`
|
||
|
||
在 `MENU_ITEMS` 数组中添加入口：
|
||
|
||
```typescript
|
||
// 在"我的预约"项附近添加
|
||
{
|
||
title: '在线咨询',
|
||
icon: 'chat',
|
||
url: '/pages/consultation/index',
|
||
},
|
||
```
|
||
|
||
**文件**: `apps/miniprogram/src/pages/index/index.tsx`
|
||
|
||
在首页快捷操作区添加咨询入口图标。
|
||
|
||
### 验证
|
||
|
||
小程序个人中心/首页出现"在线咨询"入口，点击进入咨询页面。
|
||
|
||
---
|
||
|
||
## #12: AI 分析 SSE 无触发入口 [P3]
|
||
|
||
### 根因
|
||
|
||
后端 4 个 SSE 端点就绪（lab-report/trends/checkup-plan/report-summary），前端无调用入口。
|
||
|
||
### 修复
|
||
|
||
#### 新建文件
|
||
|
||
**1. `apps/web/src/api/ai/analysisSse.ts`** — SSE 分析 API
|
||
|
||
```typescript
|
||
export type AnalysisType = 'lab-report' | 'trends' | 'checkup-plan' | 'report-summary';
|
||
|
||
export interface SseAnalysisOptions {
|
||
type: AnalysisType;
|
||
reportId?: string;
|
||
patientId?: string;
|
||
metrics?: string[];
|
||
onChunk: (content: string, index: number) => void;
|
||
onError: (message: string) => void;
|
||
onDone: (analysisId: string) => void;
|
||
}
|
||
|
||
export async function startAnalysis(options: SseAnalysisOptions): Promise<AbortController> {
|
||
const controller = new AbortController();
|
||
const endpoint = ENDPOINT_MAP[options.type];
|
||
// fetch POST → 读取 ReadableStream → 解析 SSE → 回调
|
||
return controller;
|
||
}
|
||
```
|
||
|
||
**2. `apps/web/src/components/AiAnalysisPanel.tsx`** — SSE 分析面板组件
|
||
|
||
展示：分析类型选择、实时流式内容（Markdown）、进度指示器、完成后跳转。
|
||
|
||
#### 修改文件
|
||
|
||
**3. `apps/web/src/pages/health/components/LabReportsTab.tsx`** — 每行添加"AI 解读"按钮
|
||
|
||
**4. `apps/web/src/pages/health/PatientDetail.tsx`** — AI 建议标签页添加"发起分析"按钮
|
||
|
||
**5. `apps/web/src/pages/health/AiAnalysisList.tsx`** — 顶部添加"新建分析"入口
|
||
|
||
### 验证
|
||
|
||
1. 在化验报告列表点击"AI 解读"，确认 SSE 流实时显示分析内容
|
||
2. 在患者详情点击"趋势分析"，确认分析完成并跳转历史详情
|
||
|
||
---
|
||
|
||
## #13: 家属管理无 UI [P3]
|
||
|
||
### 根因
|
||
|
||
后端 4 个 API + 前端 API 封装全部就绪，仅缺 PatientDetail 中的 Tab 组件。
|
||
|
||
### 修复
|
||
|
||
**新建文件**: `apps/web/src/pages/health/components/FamilyMembersTab.tsx`
|
||
|
||
```typescript
|
||
export function FamilyMembersTab({ patientId }: { patientId: string }) {
|
||
// Table: 姓名 | 关系 | 电话 | 身份证号 | 备注 | 操作
|
||
// DrawerForm: 添加/编辑家属（关系 Select: 父母/配偶/子女/兄弟姐妹/其他）
|
||
// AuthButton code="health.patient.manage"
|
||
}
|
||
```
|
||
|
||
**修改文件**: `apps/web/src/pages/health/PatientDetail.tsx`
|
||
|
||
在 Tabs `items` 数组中注册：
|
||
|
||
```typescript
|
||
{
|
||
key: 'family',
|
||
label: '家属管理',
|
||
children: id ? <FamilyMembersTab patientId={id} /> : null,
|
||
},
|
||
```
|
||
|
||
### 验证
|
||
|
||
患者详情页出现"家属管理"Tab，可添加/编辑/删除家属。
|
||
|
||
---
|
||
|
||
## #14: E2E 测试数据污染 [P3]
|
||
|
||
### 根因
|
||
|
||
E2E 测试无 teardown，30 个 `E2E患者_*` 永久残留。
|
||
|
||
### 修复
|
||
|
||
**步骤 1**: 立即清理
|
||
|
||
```sql
|
||
UPDATE patients SET deleted_at = NOW(), updated_at = NOW()
|
||
WHERE name LIKE 'E2E患者_%' AND deleted_at IS NULL;
|
||
```
|
||
|
||
**步骤 2**: 新建 `apps/web/e2e/fixtures/cleanup.ts`
|
||
|
||
```typescript
|
||
export async function cleanupE2EData(api: ApiClient): Promise<void> {
|
||
const patients = await api.get('/api/v1/health/patients?keyword=E2E');
|
||
for (const p of patients?.data?.data ?? []) {
|
||
if (p.name.startsWith('E2E')) await api.delete(`/api/v1/health/patients/${p.id}`);
|
||
}
|
||
}
|
||
```
|
||
|
||
**步骤 3**: 每个 E2E spec 的 `afterAll` 中调用 `cleanupE2EData`。
|
||
|
||
### 验证
|
||
|
||
数据库中 E2E 测试患者被清理，后续 E2E 测试运行后自动清理。
|
||
|
||
---
|
||
|
||
## #15: 统计仪表盘消费验证 [P4]
|
||
|
||
### 根因
|
||
|
||
审计报告称"统计仪表盘消费不足"。经代码验证，`DoctorDashboard.tsx` 和 `NurseDashboard.tsx` 已在消费 `pointsApi.getPersonalStats()`（分别在第 43 行和第 20 行）。9 个后端统计端点中 6 个已被前端消费，仅 `get_dashboard_stats`（聚合端点，被分别调用替代）和 3 个单独端点（被 `health-data` 聚合端点覆盖）未被直接调用，但功能上已覆盖。
|
||
|
||
### 修复
|
||
|
||
降级为验证任务：
|
||
|
||
1. 确认 DoctorDashboard/NurseDashboard 展示的个人统计指标是否完整（对比后端 `personal_stats` DTO 返回的全部字段）
|
||
2. 如果有遗漏字段（如 `abnormal_vital_signs`、`pending_lab_reviews`），在对应仪表盘中补充展示
|
||
3. 确认 `useStatsData.ts` 的 `tryFetch` 调用链无报错
|
||
|
||
### 验证
|
||
|
||
以医生角色登录 → 统计报表页 → 确认所有统计指标正常展示。
|
||
|
||
---
|
||
|
||
## 关键文件清单
|
||
|
||
| 文件 | 修改类型 | 问题# |
|
||
|------|---------|-------|
|
||
| `crates/erp-plugin/src/plugin_validator.rs` | 添加 1 行导入 | #1 |
|
||
| `apps/web/src/pages/Login.tsx` | 从主题配置读取品牌信息 | #2 |
|
||
| `apps/web/src/stores/app.ts` | 缓存 themeConfig | #2 |
|
||
| `apps/web/src/pages/settings/ThemeSettings.tsx` | 增加品牌信息表单 | #2 |
|
||
| `crates/erp-config/src/dto.rs` | ThemeResp 增加品牌字段 | #2 |
|
||
| `crates/erp-config/src/handler/theme_handler.rs` | 默认品牌值 | #2 |
|
||
| `apps/web/src/api/themes.ts` | 扩展 ThemeConfig 接口 | #2 |
|
||
| `apps/web/src/layouts/MainLayout.tsx` | Footer/Logo 从配置读取 | #2,#3 |
|
||
| `apps/web/src/layouts/MainLayout.tsx` | 图标导入+映射 | #3 |
|
||
| `migration/m20260501_000098_seed_action_inbox_menu.rs` | 新建迁移 | #4 |
|
||
| `migration/m20260501_000099_rls_for_post_migration_tables.rs` | 新建迁移 | #5 |
|
||
| `crates/erp-health/src/service/critical_alert_service.rs` | 添加 tracing | #5 |
|
||
| `crates/erp-server/src/tasks.rs` | 保留期 90→7 | #6 |
|
||
| `apps/web/src/pages/health/PatientDetail.tsx` | 快捷导航 | #7 |
|
||
| 5 个列表页面 | URL 参数支持 | #7 |
|
||
| `apps/web/src/pages/health/AiAnalysisList.tsx` | Link 添加 | #8 |
|
||
| `apps/miniprogram/src/pages/health/index.tsx` | 跳转逻辑 | #9 |
|
||
| `apps/miniprogram/src/pages/messages/index.tsx` | API 对接 | #10 |
|
||
| `apps/miniprogram/src/services/notification.ts` | 新建服务 | #10 |
|
||
| `apps/miniprogram/src/pages/profile/index.tsx` | 菜单项 | #11 |
|
||
| `apps/web/src/api/ai/analysisSse.ts` | 新建 SSE API | #12 |
|
||
| `apps/web/src/components/AiAnalysisPanel.tsx` | 新建组件 | #12 |
|
||
| `apps/web/src/pages/health/components/LabReportsTab.tsx` | AI 解读按钮 | #12 |
|
||
| `apps/web/src/pages/health/components/FamilyMembersTab.tsx` | 新建组件 | #13 |
|
||
| `apps/web/e2e/fixtures/cleanup.ts` | 新建清理 | #14 |
|
||
| `apps/web/src/pages/health/StatisticsDashboard/DoctorDashboard.tsx` | 个人统计 | #15 |
|
||
|
||
## 变更记录
|
||
|
||
| 日期 | 变更 |
|
||
|------|------|
|
||
| 2026-05-01 | 初始版本 — 4 专家组整合，15 项修复，3 阶段实施 |
|