104 lines
2.8 KiB
Markdown
104 lines
2.8 KiB
Markdown
# 配方研发智能平台
|
||
|
||
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
|
||
|
||
### 初始化数据库
|
||
|
||
```bash
|
||
docker compose up -d --build postgres
|
||
cd backend
|
||
pnpm install
|
||
npx prisma migrate deploy
|
||
npx tsx prisma/seed.ts
|
||
```
|
||
|
||
或一键初始化：
|
||
|
||
```bash
|
||
bash scripts/init-db.sh
|
||
```
|
||
|
||
### 启动
|
||
|
||
```bash
|
||
# 终端 1 - 后端
|
||
cd backend && pnpm dev
|
||
|
||
# 终端 2 - 前端
|
||
cd frontend && pnpm dev
|
||
```
|
||
|
||
访问 http://localhost:5173
|
||
|
||
### AI 配置
|
||
|
||
进入「设置」页面：
|
||
1. 选择 Mock/Real 模式
|
||
2. 填入 OpenAI / DeepSeek API Key
|
||
3. 点击「测试」验证连通性
|
||
4. 点击「保存配置」
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
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/ # 脚本
|
||
```
|
||
|
||
## 测试
|
||
|
||
```bash
|
||
cd backend && pnpm test # 26 tests
|
||
cd frontend && pnpm test # 16 tests
|
||
```
|
||
|
||
## License
|
||
|
||
Private
|