lung-nodule-followup-frontend:基于 Vue 生态的肺结节随访管理平台

可帮助放射科医师管理肺结节多次随访,支持患者-结节-随访三层模型录入,自动计算体积倍增时间,实现RBAC+JWT权限控制、结节状态机、多读者一致性差异提示及CSV导出与日志审计。【此简介由AI生成】

Branch1Tags0

肺结节随访影像参数与体积倍增时间系统

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 使用记录

  1. 需求分析阶段: 使用 AI 辅助解读课程讲义要求,梳理项目技术架构(Vue 3 + FastAPI Mock + RBAC)

    • 提示词用途:"帮我分析综合项目开发前端要求,梳理技术栈和功能清单"
    • 人工修改:根据自身项目选题设计了肺结节随访的三层数据模型
  2. 编码阶段: 使用 AI 生成前端页面组件和 Mock 数据

    • 提示词用途:"生成 Vue 3 肺结节随访管理页面,支持患者-结节-随访三层模型"
    • 人工修改:调整了VDT计算逻辑、补充了多读者一致性差异提示功能
  3. 测试阶段: 使用 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