c58ca26969
架构 - 后端从 flat routes/ 重构为 modules/<domain>/ 模块化结构（8个模块） - 四层架构：Route -> Service -> Repository -> Prisma - 新增 shared/ 基础设施（AppError 异常体系、ALS 上下文、prom-client 指标） - 前端 Toast/Skeleton/Alert 组件基建 + formulaService 模板 安全 - JWT 签名算法修复（HS256 用 createHmac 而非 createHash） - 密码哈希 async scrypt + timingSafeEqual - API Key 从 localStorage 迁移至服务端 runtime/config.json - Helmet 安全头 + rate-limit 全局限流 100 req/min - 全局 auth preHandler + RBAC + Ownership 中间件 颜色引擎 - 色匹配切换为 cube 粗筛 + CIEDE2000 精排 - PantoneColor 表 + 种子数据 + 搜索端点 - AI 配色 Prompt 注入成分库 colorant 列表 配方推演 - 本地优化引擎（同 category 替换 + 成本排序） - baseFormulaId 支持 + Pareto 散点图 文档 - ADR-0003 四层架构、ADR-0004 RBAC 授权模型 - 更新 ADR-0001/0002 - api-reference.md（29端点）、project-overview.md 部署 - Dockerfile * 2 + nginx.conf + docker-compose.prod.yml - 健康探针 + 优雅关闭 + pg_dump 备份脚本 - ESLint + Prettier + tsconfig strict
配方研发智能平台
AI 驱动的化妆品配方研发辅助工具（纯 Web 端）。
功能模块
| 模块 | 功能 |
|---|---|
| 配方记录 | 创建/编辑/详情/可视化编辑、AI 提取、版本历史与对比、自然语言搜索 |
| 颜色引擎 | D3.js 交互色相环、Lab/RGB 滑条微调、HEX/RGB/Lab/潘通色号输入、CIEDE2000 ΔE 实时计算、取色棒（EyeDropper API + Canvas 降级）、AI 配色推荐、皮肤材质预览 |
| 可视化编辑器 | ECharts 环形饼图、成分比例滑条 ±0.1%、AI 实时指标预测（SSE）、雷达图（肤感子维度）、仪表盘（稳定性评分） |
| 配方推演 | 多约束条件设置（成本/指标/排除成分）、SSE 流式推演、方案卡片实时生成、成本-功效散点图、方案对比表 |
| 平台 | JWT 认证、项目管理、CSV 导出、全局搜索、深色/浅色主题 |
技术栈
- 前端: React 19 + TypeScript + Vite + Tailwind CSS 4
- 状态管理: Zustand + TanStack Query
- 图表: ECharts + D3.js
- 色彩科学: color.js（CIELAB + Display P3 + CIEDE2000）
- 后端: Fastify 5 + TypeScript
- 数据库: PostgreSQL 16 + pgvector
- ORM: Prisma 7
- AI: OpenAI / DeepSeek API + Prompt 模板 + 缓存/降级/限流
- 测试: Vitest（42 tests）
快速开始
环境要求
- Node.js 24+
- pnpm 11+
- Docker
初始化数据库
docker compose up -d --build postgres
cd backend
pnpm install
npx prisma migrate deploy
npx tsx prisma/seed.ts
或一键初始化：
bash scripts/init-db.sh
启动
# 终端 1 - 后端
cd backend && pnpm dev
# 终端 2 - 前端
cd frontend && pnpm dev
AI 配置
进入「设置」页面：
- 选择 Mock/Real 模式
- 填入 OpenAI / DeepSeek API Key
- 点击「测试」验证连通性
- 点击「保存配置」
项目结构
color_full/
├── frontend/ # React 前端
│ └── src/
│ ├── components/ # 可复用组件
│ ├── pages/ # 页面组件
│ ├── layouts/ # 布局
│ ├── stores/ # Zustand stores
│ ├── hooks/ # 自定义 hooks
│ └── lib/ # 工具（色彩/API）
├── backend/ # Fastify 后端
│ └── src/
│ ├── routes/ # API 路由
│ ├── services/ # 业务逻辑（AI）
│ └── lib/ # 工具
├── docker/ # Dockerfile（pgvector）
├── docs/adr/ # 架构决策记录
├── .scratch/ # PRD + Issues
└── scripts/ # 脚本
测试
cd backend && pnpm test # 26 tests
cd frontend && pnpm test # 16 tests
License
Private