可帮助放射科医师管理肺结节多次随访,支持患者-结节-随访三层模型录入,自动计算体积倍增时间,实现RBAC+JWT权限控制、结节状态机、多读者一致性差异提示及CSV导出与日志审计。【此简介由AI生成】
Access rate limit exceeded. Please log in to continue.
肺结节随访影像参数与体积倍增时间系统
1. 项目选题名称及一句话功能说明
项目选题名称: 肺结节随访影像参数与体积倍增时间系统
一句话功能说明: 面向放射科医师的肺结节多次随访管理平台,支持患者-结节-随访三层模型录入(径线、体积、算法版本),自动计算 VDT(体积倍增时间),实现 RBAC+JWT 数据范围权限控制、结节状态机、多读者一致性差异提示、CSV导出与日志审计。
2. 项目运行说明
环境要求
- 前端: Node.js >= 18, npm >= 8
- 后端 Mock: Python 3.10 (conda 环境
demo), FastAPI, uvicorn
快速启动
1. 启动 Mock API 后端
# 激活 conda 环境
conda activate demo
# 进入 mock-server 目录
cd mock-server
# 启动 FastAPI 服务
python -m uvicorn main:app --reload --host 0.0.0.0 --port 8000
或直接双击 start-backend.bat
后端启动成功后访问 http://localhost:8000/docs 可查看 Swagger API 文档。
2. 启动 Vue 前端
# 安装依赖(首次运行)
npm install
# 启动开发服务器
npm run dev
或直接双击 start-frontend.bat
前端启动成功后访问 http://localhost:5173
演示账号
| 角色 | 用户名 | 密码 | 说明 |
|---|---|---|---|
| 管理员 | admin | admin123 | 全量管理所有数据 |
| 医师 | doctor | doctor123 | 仅可查看白名单授权患者(1,2,3) |
| 医师 | doctor2 | doctor123 | 仅可查看白名单授权患者(3,4,5) |
| 普通用户 | user1 | user123 | 基础用户 |
3. 项目目录结构
symptom-guide-frontend/
├── mock-server/ # Python FastAPI Mock 后端
│ └── main.py # Mock API 服务(患者/结节/随访/VDT/权限全部接口)
├── public/ # 静态资源
├── src/
│ ├── api/ # API 请求封装
│ │ ├── index.js # axios 实例 + 拦截器(JWT 附加、统一异常处理)
│ │ └── modules.js # 按模块封装的 API 接口(患者/结节/随访/VDT/管理)
│ ├── assets/css/ # 全局样式
│ │ └── global.css
│ ├── router/ # Vue Router 路由配置
│ │ └── index.js # 路由定义 + 路由守卫(RBAC权限控制)
│ ├── store/ # Pinia 状态管理
│ │ └── user.js # 用户状态(token、角色、登录登出)
│ ├── views/ # 页面组件
│ │ ├── LoginPage.vue # 登录页面
│ │ ├── RegisterPage.vue # 注册页面
│ │ ├── public/ # 公开页面
│ │ │ ├── PublicLayout.vue # 公共导航布局
│ │ │ ├── HomePage.vue # 首页(功能介绍 + 数据概览 + VDT公式)
│ │ │ ├── FeedbackPage.vue # 匿名反馈提交
│ │ │ └── DisclaimerPage.vue # 医学免责声明
│ │ ├── doctor/ # 医师工作台页面
│ │ │ ├── DoctorLayout.vue # 医师侧边栏布局
│ │ │ ├── PatientList.vue # 授权患者列表(JWT数据范围)
│ │ │ ├── PatientDetail.vue # 患者详情 + 结节列表
│ │ │ ├── NoduleDetail.vue # 结节详情 + 随访记录 + VDT趋势
│ │ │ ├── FollowupCreate.vue # 新增随访记录
│ │ │ └── VdtCalculate.vue # VDT独立计算器
│ │ └── admin/ # 管理员页面
│ │ ├── AdminLayout.vue # 管理后台布局(侧边栏)
│ │ ├── PatientManage.vue # 患者管理
│ │ ├── NoduleManage.vue # 结节管理(含状态机)
│ │ ├── FollowupManage.vue # 随访记录管理
│ │ ├── ReaderBatch.vue # 读者批次(多读者一致性差异提示)
│ │ ├── UserManage.vue # 用户管理(RBAC角色权限)
│ │ └── LogAudit.vue # 日志审计
│ ├── App.vue # 根组件
│ └── main.js # 入口(Element Plus/Pinia/Router)
├── index.html # HTML 模板
├── vite.config.js # Vite 配置(代理到 Mock 后端)
├── package.json
├── start-backend.bat # 一键启动后端
├── start-frontend.bat # 一键启动前端
└── README.md
4. 已实现页面与核心功能清单
4.1 页面清单
| 页面 | 路由 | 功能说明 |
|---|---|---|
| 登录页 | /login | 用户登录,JWT Token 获取,演示账号快捷登录 |
| 注册页 | /register | 用户注册,表单校验 |
| 首页 | / | 功能介绍、数据概览统计、VDT公式说明 |
| 意见反馈 | /feedback | 匿名/实名反馈提交,反馈列表展示 |
| 免责声明 | /disclaimer | VDT公式假设说明、医学免责声明、数据合规 |
| 授权患者列表 | /doctor/patients | 医师查看白名单授权患者,支持筛选分页 |
| 患者详情 | /doctor/patient/:id | 患者信息 + 结节列表 |
| 结节详情 | /doctor/nodule/:id | 结节信息 + 随访记录 + VDT趋势图 |
| 新增随访 | /doctor/followup/create/:noduleId | 录入径线/体积/算法版本,自动计算VDT |
| VDT计算器 | /doctor/vdt | 独立VDT计算工具,输入两次体积和间隔天数 |
| 患者管理 | /admin/patients | 管理员管理患者信息 |
| 结节管理 | /admin/nodules | 管理员管理结节(含状态机:活跃/稳定/术后) |
| 随访管理 | /admin/followups | 管理员管理随访记录 |
| 读者批次 | /admin/reader-batches | 多读者一致性差异提示 |
| 用户管理 | /admin/users | 管理员修改用户角色、启用/禁用用户 |
| 日志审计 | /admin/logs | 管理员查看系统操作日志 |
4.2 登录流程技术串联
用户在 LoginPage.vue 输入账号密码
→ 前端表单校验通过后调用 loginApi()
→ axios 请求 POST /api/auth/login
→ Mock 后端验证账号密码,生成 JWT Token
→ 返回 {token, username, role, userId}
→ Pinia store 保存到 state 和 localStorage
→ 路由守卫检查 token 实现权限控制
→ 根据 role 跳转:admin → /admin, doctor → /doctor/patients
4.3 RBAC + JWT 数据范围权限控制
- 路由守卫:
router/index.js中beforeEach检查requiresAuth和requiresAdmin - JWT Token:axios 拦截器自动在请求头附加
Authorization: Bearer <token> - 角色类型:
admin(管理员全量)、doctor(医师白名单)、user(普通用户) - 数据范围:医师只能查看白名单授权的患者列表(如 doctor 只能看患者1,2,3)
- 管理员专属:/admin/* 路径需要 admin 角色
4.4 VDT 体积倍增时间计算
公式: VDT = (Δt × ln2) / ln(V₂/V₁)
- Δt:两次随访间隔天数
- V₁:前次体积测量值(mm³)
- V₂:后次体积测量值(mm³)
- 假设:肺结节体积呈近似指数增长
- VDT > 400天通常提示良性/稳定,VDT < 400天需密切关注
4.5 结节状态机
活跃 → 稳定(VDT > 400天或体积缩小)
活跃 → 术后(患者接受手术)
稳定 → 活跃(体积增大或VDT缩短)
4.6 多读者一致性
当同一结节由不同读者(AI系统 vs 人工测量)进行测量时,系统自动记录差异(径线差值、体积差值),超出阈值时标记为"差异已审核"或"一致性良好"。
4.7 统一异常处理
- axios 响应拦截器统一处理 401(重新登录)、403(无权限)、其他错误
- Element Plus ElMessage 全局错误提示
5. Mock 接口说明
所有接口均为 Mock 模拟数据,后端尚未就绪。以下是 Mock 接口清单及替换计划:
| Mock 接口 | 方法 | 说明 | 替换计划 |
|---|---|---|---|
| /api/auth/login | POST | 用户登录 | 对接后端 SysUserController 登录接口 |
| /api/auth/register | POST | 用户注册 | 对接后端用户注册接口 |
| /api/patients | GET | 患者列表(分页+筛选+JWT数据范围) | 对接后端患者查询接口 |
| /api/patients/:id | GET | 患者详情(含结节列表) | 对接后端患者详情接口 |
| /api/patients/:id/export | GET | 导出患者随访CSV | 对接后端导出接口 |
| /api/nodules/:id | GET | 结节详情(含随访记录+VDT) | 对接后端结节详情接口 |
| /api/followups | POST | 新增随访记录(自动计算VDT) | 对接后端随访录入接口 |
| /api/vdt/calculate | POST | VDT独立计算 | 对接后端VDT计算服务 |
| /api/stats/overview | GET | 统计概览 | 对接后端统计接口 |
| /api/feedback | POST/GET | 反馈提交与列表 | 对接后端反馈管理接口 |
| /api/feedback/:id/reply | PUT | 回复反馈 | 对接后端回复接口 |
| /api/admin/patients | GET/POST | 管理员患者管理 | 对接后端管理员接口 |
| /api/admin/nodules | GET/POST/PUT/DELETE | 管理员结节管理 | 对接后端结节CRUD接口 |
| /api/admin/followups | GET/DELETE | 管理员随访管理 | 对接后端随访管理接口 |
| /api/admin/reader-batches | GET | 读者批次查询 | 对接后端读者批次接口 |
| /api/admin/users | GET/PUT/DELETE | 管理员用户管理 | 对接后端用户管理接口 |
| /api/admin/logs | GET | 日志审计 | 对接后端日志查询接口 |
替换方式: 前端 src/api/modules.js 中所有接口地址保持不变,只需将 Vite 代理目标从 localhost:8000(Mock)改为真实后端地址(如 localhost:8080)即可无缝切换。
6. AI 使用记录摘要与隐私合规说明
AI 使用记录
-
需求分析阶段: 使用 AI 辅助解读课程讲义要求,梳理项目技术架构(Vue 3 + FastAPI Mock + RBAC)
- 提示词用途:"帮我分析综合项目开发前端要求,梳理技术栈和功能清单"
- 人工修改:根据自身项目选题设计了肺结节随访的三层数据模型
-
编码阶段: 使用 AI 生成前端页面组件和 Mock 数据
- 提示词用途:"生成 Vue 3 肺结节随访管理页面,支持患者-结节-随访三层模型"
- 人工修改:调整了VDT计算逻辑、补充了多读者一致性差异提示功能
-
测试阶段: 使用 AI 辅助排查路由守卫和 JWT Token 传递问题
- 提示词用途:"Vue Router beforeEach 导航守卫跳转死循环问题排查"
- 人工修改:优化了登录后重定向逻辑和数据范围权限控制
隐私/数据合规说明
本项目使用的所有测试数据均为虚构的模拟数据,未使用任何真实患者信息。Mock 数据中的姓名、手机号、影像参数等均为编造内容,仅用于功能演示和开发测试,符合隐私保护与数据合规要求。
技术栈: Vue 3 + Vue Router + Pinia + Element Plus + Axios + Vite (前端) | FastAPI + uvicorn (Mock 后端)
医学免责声明: 本系统仅供课程学习使用,VDT计算结果不构成任何临床诊断或治疗建议。
Introduction
可帮助放射科医师管理肺结节多次随访,支持患者-结节-随访三层模型录入,自动计算体积倍增时间,实现RBAC+JWT权限控制、结节状态机、多读者一致性差异提示及CSV导出与日志审计。【此简介由AI生成】
Customize your domain