- 后端：fastapi, uvicorn, pydantic,alembic
- 前端：Vite v6, Svelte v5, TypeScript, Tailwind CSS v4
需求 → 模型 → Schema → Service → API → OpenAPI → 页面（组件）
后端：fastapi 生成 openapi.json 前端：@hey-api/openapi-ts 生成 API 客户端 python scripts/export_openapi.py cp openapi.json ../frontend/ npm run generate-api project/ ├── backend/ │ └── openapi.json └── frontend/
app/models/xxx.py → 数据库结构 app/schemas/xxx.py → 请求/响应格式 app/services/xxx.py → 业务逻辑 app/api/v1/xxx.py → 路由端点 app/api/v1/router.py → 注册路由
src/routes/dashboard/xxx/+page.svelte → 新页面 src/components/biz/Xxx.svelte → 业务组件 src/components/layout/DashboardSidebar.svelte → 导航入口
frontend/
├── .env.example
├── biome.json
├── package.json
├── package-lock.json
├── tsconfig.json
├── vite.config.ts
├── svelte.config.js
├── openapi.json # 从后端导出的 OpenAPI
├── playwright.config.ts
├── test-results/ # Playwright 运行产物
├── static/
│ ├── favicon.png
│ └── favicon.svg
├── tests/
│ ├── unit/ # Vitest 单元测试
│ └── e2e/ # Playwright E2E
│ ├── auth.spec.ts
│ └── todos.spec.ts
└── src/
│ ├── app.d.ts
│ ├── app.html
│ ├── styles/
│ │ └── app.css # Tailwind v4 入口 + 主题变量
│ ├── lib/
│ │ ├── api/ # @hey-api/openapi-ts 生成
│ │ │ ├── client.ts # fetch 客户端 + 拦截器
│ │ │ ├── index.ts # 入口，导出生成的 SDK
│ │ │ └── generated/ # 自动生成的类型和方法
│ │ ├── hsi/ # HSI 解析/渲染工具
│ │ │ ├── HSIParser.js
│ │ │ ├── HSIRenderer.js
│ │ │ ├── SpectrumChart.js
│ │ │ └── SpectrumExtractor.js
│ │ ├── schemas/
│ │ │ └── auth.ts # 表单校验（Zod）
│ │ ├── stores/
│ │ │ ├── auth.ts # 用户认证状态
│ │ │ └── ui.ts # 主题/语言/toast
│ │ ├── utils/
│ │ ├── api.ts # SDK 结果/错误处理
│ │ ├── cn.ts
│ │ ├── format.ts
│ │ └── storage.ts
│ │ └── index.ts
│ ├── components/
│ │ ├── layout/
│ │ │ ├── PublicHeader.svelte
│ │ │ ├── PublicFooter.svelte
│ │ │ ├── PublicLayout.svelte
│ │ │ ├── DashboardHeader.svelte
│ │ │ ├── DashboardSidebar.svelte
│ │ │ └── DashboardLayout.svelte
│ │ ├── ui/ # 基础组件库
│ │ │ ├── avatar/
│ │ │ ├── badge/
│ │ │ ├── button/
│ │ │ ├── card/
│ │ │ ├── checkbox/
│ │ │ ├── drawer/
│ │ │ ├── form/ # Felte 集成
│ │ │ ├── input/
│ │ │ ├── modal/
│ │ │ ├── pagination/
│ │ │ ├── select/
│ │ │ ├── skeleton/
│ │ │ ├── table/
│ │ │ ├── toast/
│ │ │ └── tooltip/
│ │ └── biz/
│ │ ├── LabelGroupFormModal.svelte
│ │ ├── LangSwitch.svelte
│ │ ├── LoginForm.svelte
│ │ ├── ProjectExportModal.svelte
│ │ ├── ProjectFormModal.svelte
│ │ ├── RegisterForm.svelte
│ │ ├── SpectralModeFormModal.svelte
│ │ ├── ThemeToggle.svelte
│ │ ├── TodoFormModal.svelte
│ │ └── UserMenu.svelte
│ ├── routes/
│ │ ├── +layout.svelte # 根布局（i18n/theme provider）
│ │ ├── +layout.ts # 全局 load
│ │ ├── +page.svelte # / 官网首页
│ │ ├── +error.svelte # 错误页
│ │ ├── auth/
│ │ │ ├── +layout.svelte # 认证页布局
│ │ │ ├── login/
│ │ │ │ └── +page.svelte
│ │ │ └── register/
│ │ │ └── +page.svelte
│ │ └── dashboard/
│ │ ├── +layout.svelte # 后台布局（需登录）
│ │ ├── +layout.ts # 鉴权守卫
│ │ ├── +page.svelte # 仪表盘首页
│ │ ├── fixed-preferences/
│ │ │ └── +page.svelte
│ │ ├── online-tasks/
│ │ │ └── +page.svelte
│ │ ├── preset-display-modes/
│ │ │ └── +page.svelte
│ │ ├── preset-labels/
│ │ │ └── +page.svelte
│ │ ├── profile/
│ │ │ └── +page.svelte
│ │ ├── projects/
│ │ │ └── +page.svelte
│ │ ├── settings/
│ │ │ └── +page.svelte
│ │ └── todos/
│ │ └── +page.svelte
backend/
├── .env.example
├── alembic.ini
├── openapi.json # 最新导出的 OpenAPI
├── requirements.txt
├── uploads/ # 用户上传文件等
├── scripts/
│ ├── export_openapi.py # 导出 openapi.json
│ └── seed.py # 开发数据填充
├── app/
│ ├── __init__.py
│ ├── main.py # FastAPI 入口
│ ├── core/
│ │ ├── __init__.py
│ │ ├── config.py # pydantic-settings 配置
│ │ ├── logging.py # structlog 配置
│ │ ├── rate_limit.py # 速率限制
│ │ └── security.py # JWT/密码哈希
│ ├── api/
│ │ ├── __init__.py
│ │ ├── deps.py # 依赖注入（get_db/get_current_user）
│ │ └── v1/
│ │ ├── __init__.py
│ │ ├── router.py # 汇总所有路由
│ │ ├── auth.py
│ │ ├── health.py
│ │ ├── label_groups.py
│ │ ├── projects.py
│ │ ├── samples.py
│ │ ├── spectral_modes.py
│ │ ├── todos.py
│ │ └── users.py
│ ├── models/
│ │ ├── __init__.py
│ │ ├── base.py # SQLAlchemy Base
│ │ ├── annotation_detail.py
│ │ ├── annotation_detail_mode.py
│ │ ├── annotation_sample.py
│ │ ├── annotation_spectrum.py
│ │ ├── display_algorithm.py
│ │ ├── label_group.py
│ │ ├── project.py
│ │ ├── spectral_mode.py
│ │ ├── todo.py
│ │ └── user.py
│ ├── schemas/
│ │ ├── __init__.py
│ │ ├── auth.py
│ │ ├── label_group.py
│ │ ├── project.py
│ │ ├── sample.py
│ │ ├── spectral_mode.py
│ │ ├── todo.py
│ │ └── user.py
│ ├── services/
│ │ ├── __init__.py
│ │ ├── auth.py
│ │ ├── display_algorithm.py
│ │ ├── label_group.py
│ │ ├── project.py
│ │ ├── sample.py
│ │ ├── spectral_mode.py
│ │ ├── todo.py
│ │ └── user.py
│ └── db/
│ ├── __init__.py
│ └── session.py # 数据库连接
├── alembic/
│ ├── env.py
│ ├── script.py.mako
│ └── versions/
│ ├── 82b27cfa3fe7_add_display_algorithms.py
│ └── 979506117e6b_initial_schema.py
└── tests/
├── conftest.py
├── api/
│ ├── test_auth.py
│ ├── test_label_groups.py
│ ├── test_projects.py
│ ├── test_spectral_modes.py
│ └── test_todos.py
└── services/ # 预留