code/├── main.py                         # 应用入口，路由注册与生命周期管理├── config.py                       # 全局配置（密钥、数据库路径、Token 有效期）├── database.py                     # 数据库引擎与会话管理├── models.py                       # SQLAlchemy 数据模型定义├── schemas.py                      # Pydantic 请求/响应数据模型├── auth.py                         # 认证与授权（JWT、密码哈希、权限守卫）├── data_loader.py                  # CSV 数据自动导入├── requirements.txt                # Python 依赖清单├── foodstruct_nutritional_facts.csv  # 原始食品营养数据集（1171 条）├── food_nutrition.db               # SQLite 数据库文件│├── routers/│   ├── __init__.py│   ├── auth_router.py              # 认证相关 API（登录、注册、获取当前用户）│   ├── food_router.py              # 食品 CRUD API│   ├── dashboard_router.py         # 仪表盘概览 API│   ├── basic_router.py             # 基础分析 API（分类分布、营养素对比）│   ├── stat_router.py              # 统计分析 API（相关性、检验、雷达图）│   ├── density_router.py           # 营养密度分析 API│   ├── mining_router.py            # 高级挖掘 API（聚类、PCA、健康评分）│   └── user_router.py              # 用户管理 API（仅管理员）│├── templates/│   ├── base.html                   # 基础布局模板（顶栏 + 侧边栏 + 内容区）│   ├── login.html                  # 登录页面│   ├── register.html               # 注册页面│   ├── index.html                  # 数据仪表盘首页│   ├── category.html               # 分类分布分析页│   ├── nutrient_compare.html       # 营养素对比分析页│   ├── macronutrient.html          # 宏量营养素分析页│   ├── calorie.html                # 热量对比分析页│   ├── correlation.html            # 相关性热力图分析页│   ├── stat_test.html              # 统计检验分析页│   ├── radar.html                  # 雷达图对比分析页│   ├── density.html                # 营养密度分析页│   ├── clustering.html             # 聚类分析页│   ├── mining_advanced.html        # 高级挖掘分析页│   ├── data_manage.html            # 数据管理页（管理员）│   └── user_manage.html            # 用户管理页（管理员）│└── static/    ├── css/    │   └── style.css               # 全局样式（设计系统）    └── js/        ├── app.js                  # 核心 JS（认证、API 封装、UI 控制）        ├── charts.js               # ECharts 图表配置与渲染        └── food_name_zh.js         # 食品名中英文翻译字典（1171 条）

┌─────────────────────────────────────────────────┐│                   浏览器 (Browser)                ││  ┌──────────┐  ┌──────────┐  ┌───────────────┐  ││  │  Bootstrap │  │  ECharts │  │  DataTables   │  ││  │  (UI 框架) │  │ (图表库) │  │  (数据表格)   │  ││  └─────┬────┘  └────┬─────┘  └──────┬────────┘  ││        └────────────┼───────────────┘            ││                     │  HTTP / AJAX               │└─────────────────────┼───────────────────────────┘                      │┌─────────────────────┼───────────────────────────┐│              FastAPI 服务端 (Uvicorn)             ││  ┌──────────────────┼────────────────────────┐  ││  │           Jinja2 模板引擎                   │  ││  │   (服务端渲染 HTML 页面骨架)                 │  ││  └──────────────────┼────────────────────────┘  ││  ┌──────────────────┼────────────────────────┐  ││  │            API 路由层 (Routers)             │  ││  │  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────────┐  │  ││  │  │ Auth │ │ Food │ │ Stat │ │ Mining   │  │  ││  │  └──┬───┘ └──┬───┘ └──┬───┘ └────┬─────┘  │  ││  └─────┼────────┼────────┼──────────┼────────┘  ││  ┌─────┼────────┼────────┼──────────┼────────┐  ││  │     └────────┴────────┴──────────┘        │  ││  │         SQLAlchemy ORM + Pydantic         │  ││  └──────────────────┬───────────────────────┘  ││  ┌──────────────────┼───────────────────────┐  ││  │     认证中间件 (JWT + bcrypt)             │  ││  └──────────────────┬───────────────────────┘  │└─────────────────────┼───────────────────────────┘                      │┌─────────────────────┼───────────────────────────┐│               SQLite 数据库                      ││         ┌───────┐  ┌───────────┐                ││         │ users │  │   foods   │                ││         └───────┘  └───────────┘                │└─────────────────────────────────────────────────┘

用户输入账号密码       │       ▼POST /api/auth/login       │       ▼  bcrypt 验证密码 ──── 失败 → 401 "用户名或密码错误"       │       ▼ 成功  JWT 签发 (HS256, 有效期 24h)       │       ▼  前端存储 token 至 localStorage       │       ▼  后续请求 Header: Authorization: Bearer        │       ▼  FastAPI 依赖注入解码 JWT → 获取当前用户       │       ├── require_user  → 未登录返回 401       └── require_admin → 非管理员返回 403

ρ = 1 - (6 Σd²) / (n(n²-1))

健康评分 = 收益分 × 0.75 + 惩罚分 × 0.25

pip install -r requirements.txt

python main.py