Section 01
项目定位与运行环境
本系统为极明科技专用的正式业务平台，核心涵盖成员身份管理、荣誉资产沉淀、官方认证查询、年度成长回溯。系统设计以长期可用、稳定可信为第一原则。
推荐服务器规格
香港节点
Linux 系统
12核 CPU
12G 内存
技术栈取舍（第一版）
- 后端：单体 FastAPI + Uvicorn/Gunicorn
- 前端：Vue 3 + Vite 构建，极简科技风，Nginx 托管
- 数据库：MySQL 8.0 主数据库
- 任务调度：APScheduler（轻量级）
- 存储/进程：本地目录起步，systemd/Supervisor 守护，必启 HTTPS
Section 02
核心模块架构
系统按功能划分为八大模块，分阶段推进，确保主干优先落地。
1 后台管理中心
- JWT Token 鉴权与密码加密存储
- 超级管理员与普通管理员权限划分
- 数据大盘监控与精细化操作日志追责
2 成员管理基石
- 全生命周期管理（新增 / 编辑 / 软删除）
- 区分公司成员与团队成员，动态计算真实年龄
- 安全防线：身份证哈希存储，脱敏展示，拒绝明文裸奔
3 荣誉与资产沉淀
- 图文视频素材上传与管理，严格校验文件体积与类型
- 每条荣誉设置
visibility字段，精确控制对外曝光
4 官方认证查询（对外品牌口径）
通过"姓名 + 身份证 + 人脸活体校验"三要素核验。
提交信息 → 状态校验 → 人脸比对 → 记录日志 → 返回脱敏结果
- 认证成功：展示官方数字签章、脱敏资料与公开荣誉
- 认证失败：统一模糊提示，防暴力枚举
5 生日提醒与运营
- 每日凌晨扫描，提前 7 天自动 SMTP 邮件通知管理员
6 AI 年度回溯视频（二期增强）
- 抓取年度荣誉素材，通过 MoviePy 后台异步拼接、配乐、转场
Section 03
前端视觉与体验规范
前端分为后台管理端与公开查询端两套体验。拒绝花哨营销感，传递官方威严感。
极简科技风
高留白设计
黑白灰主色
品牌蓝点缀
- 管理端：严谨的表格排版，清晰的状态标识
- 查询端：认证结果页必须配备极明科技"官方认证"数字签章
Section 04
系统安全与上线合规底线
第一目标是稳定、可信、安全、可维护。第二目标才是高级、智能、好看。
- 数据隔离：.env 配置绝对不入 Git 仓库
- 隐私保护：接口禁止返回完整身份证，临时人脸照片定期销毁
- 系统防御：公开认证接口必须配置强限流，防恶意刷库；上传目录与代码隔离
- 灾备机制：每日 MySQL 增量/全量备份，每周媒体文件备份，保留 7-30 天
Section 05
服务器资源分配策略
针对 12 核 12G 算力的最优调度方案。
2–4G
MySQL 内存池
4–8
FastAPI Worker
1–2
AI 视频并发
12C / 12G
总算力
- AI 视频生成：作为重计算任务，必须限制并发（单次排队 1-2 个），避免压垮主业务
- 演进方向：数据膨胀后，优先接入 OSS 对象存储，而非盲目扩容 CPU