随访登记系统详细使用说明(网站版)
用于培训 PI / CRC / 录入员 / 随访护士
本系统用于科研随访登记,不用于诊疗决策;请勿录入姓名、电话、身份证、住院号等 PII。
1)核心概念(培训先讲这 3 点)
- 入口:管理端
/staff(需要登录),录入端 /p/<token>(无需登录)。
- 组织:project(项目)→ patient_code(研究编号)→ visit(访视记录)。
- 合并键:多中心最终按
center_code + patient_code 合并。
2)上线准备(管理员一次性完成)
- 创建 Supabase 项目并记录
Project URL 与 anon key。
- 在 SQL Editor 运行
supabase/migrations/0001_core.sql。
- Auth 配置 Redirect URLs(至少包含
/staff 与 /p/*)。
- 在
site/config.js 填写 SUPABASE_URL 和 SUPABASE_ANON_KEY。
- 部署静态站点(Publish directory:
site)。
3)标准操作流程(SOP)
步骤 1:管理员创建项目
- 进入
/staff,邮箱魔法链接登录。
- 创建项目并填写:项目名、
center_code、module。
示例:项目 IgAN 前瞻随访队列 2026;center_code BJ01;module IGAN
步骤 2:录入患者基线
- 必填:
patient_code(如 BJ01-0001)
- IGAN 可选填 Oxford MEST-C
步骤 3:生成 token 并分发
- 在患者行点击“生成随访 token”。
- 将
/p/<token> 链接发给随访录入人员。
步骤 4:随访人员录入访视
示例第 1 次:2026-03-15,132/84,Scr 1.42,UPCR 0.88
示例第 2 次:2026-06-15,128/80,Scr 1.31,UPCR 0.62
步骤 5:管理员质控与导出
- 检查缺失值/异常值。
- 生成 Snapshot。
- 导出论文包 ZIP 并进行统计分析。
4)实战演示模板(15 分钟培训)
- 创建项目:
IgAN-BJ-2026(center_code: BJ01)。
- 新增患者:
BJ01-0123,MEST-C: M1 E0 S1 T0 C1。
- 发送 token 给护士 A。
- 完成两次随访录入并核查时间递增、数值合理。
5)填写规范
- patient_code 建议格式:中心代码 + 流水号(如
BJ01-0001)。
- 日期统一
YYYY-MM-DD。
- 缺失值留空,不要用 0 代替。
- 统一单位,异常值先复核再提交。
6)FAQ
Q:收到了登录邮件但进不去?
A:通常是 Redirect URLs 配置缺失,请检查 Supabase Auth 配置。
Q:可以录入姓名电话吗?
A:不可以,只能用研究编号。
Q:如何保证论文复现?
A:先生成 Snapshot,再基于 Snapshot 导出论文包并引用 snapshot ID。
提示:如需离线培训资料,可同时使用仓库版详细文档 docs/USER_MANUAL_CN.md。
你可以直接把这个链接发给用户:/user-manual-cn