人员培训和证书管理系统产品系统Vibe Coding

面向无人机、通用航空及测绘/巡检等作业单位的资质合规管理场景。企业持证人员分散在多部门，CAAC、UTC 等证书到期时间不一、复审节点多，以往靠 Excel 台账人工维护，极易出现"证书过期未复审、人员资质失效仍排班上岗"的合规风险。本系统让安全管理员与 HR 在浏览器或手机 APP 上随时查看全员证书台账，按到期日、部门、证书类型组合筛选，对临期证书自动预警，把"事后救火"变成"事前提醒"，覆盖日常台账维护、复审排期、外勤现场核验三类典型场景。

1）证书台账：141 条证书 18 字段全管理（持有人、身份证、部门、台账编号、证书名称、证书类型、颁发机构、颁发/到期日期、复审时间、证书扫描件、官网验证链接、备注等），支持多条件组合高级查询与详情查看 2）到期预警：按"证书到期日期"与"复审时间"自动计算剩余期限，临期证书提前预警，避免资质过期失效 3）人员与部门管理：维护人员档案与组织架构，证书按部门归口统计 4）权限与安全：JWT + bcrypt 鉴权、RBAC 角色权限、首次登录强制改密、管理员建号随机初始密码、审计日志（audit_logs）记录全部关键操作 5）多端访问：Web 浏览器直连 + Capacitor 打包 Android APK，手机端随时查；cpolar 内网穿透支持外网访问

技术栈：前端 Vue 3.5 + Element Plus 2.14 + Pinia + Vue Router，Vite 8 构建；后端 FastAPI + SQLAlchemy + Pydantic；SQLite 存用户/角色/审计日志；业务数据对接 WPS 多维表格 DBSheet API v7；Capacitor 8.4 打 Android APK；JWT + bcrypt 鉴权；cpolar 穿透部署。
架构亮点：① 双数据源分层——敏感数据（密码哈希、权限、审计）落本地 SQLite 保证安全与实时响应，业务数据（证书/人员/部门）直读 WPS 云表并做 5 分钟内存缓存，既尊重企业"表格即数据源"的现状，又彻底避免双写同步问题；② 前后端完全解耦，FastAPI 同时托管 /dist 静态资源与 /api/* 路由，一套代码 Web 与 APK 共用。
难点与解决：① WPS API 限流与网络延迟 → 5 分钟缓存 + 分页拉取，避免每次请求打穿云表；② SQLAlchemy 会话不感知外部写入（外部 sqlite3.exe 改库后接口仍读旧值）→ 统一走 ORM 写入，运行时禁止外部直连写库；③ Pydantic Schema 与 DB 可空性不匹配（email=NULL 触发 /auth/me 500）→ 响应模型改 Optional[str]，修复"改密显示失败"的假故障；④ 移动端混合内容与跨域 → 后端收敛 CORS 白名单、统一 HTTPS 域名。