23e5cb4006
核心功能: - M3 配方记录: 创建/编辑/详情/可视化编辑/AI提取/版本历史/版本对比 - M1 颜色引擎: D3.js 色相环/滑条微调/ΔE计算/取色棒/AI配色推荐 - M2 可视化编辑器: ECharts饼图/成分滑条/AI预测/雷达图/仪表盘 - M4 配方推演: 约束设置/SSE推演/方案对比/散点图 - 平台: NL智能搜索/项目管理/CSV导出/JWT认证/全局搜索 技术栈: - 前端: React + Vite + Tailwind CSS 4 + Zustand + TanStack Query - 后端: Fastify 5 + Prisma 7 + PostgreSQL + pgvector - AI: OpenAI/DeepSeek API 调用 + Prompt模板 + 缓存/降级/限流 - 测试: Vitest 42 tests (26 API集成 + 16 色彩模块)
69 lines
3.5 KiB
Markdown
69 lines
3.5 KiB
Markdown
# CONTEXT.md — 配方研发智能平台
|
||
|
||
## 项目概述
|
||
|
||
AI 驱动的化妆品配方研发智能平台（纯 Web 端），为化妆品研发工程师提供颜色管理、可视化配方调整、配方记录管理和配方推演四大核心能力。
|
||
|
||
## 领域词汇表
|
||
|
||
### 核心实体
|
||
|
||
| 术语 | 英文 | 定义 |
|
||
| :--- | :--- | :--- |
|
||
| **配方** | Formula | 一组成分按特定比例和工艺组合的完整方案，包含多个相 |
|
||
| **相** | Phase | 配方中按工艺阶段划分的组成部分（如油相、水相、后添加相），每个相包含若干成分 |
|
||
| **成分** | Ingredient | 化妆品原料，按功能分类（乳化剂、保湿剂、防腐剂等），有 INCI 名称和中文名 |
|
||
| **配方版本** | FormulaVersion | 配方的某个时间点快照，记录该版本完整的成分列表和比例 |
|
||
| **颜色配方** | ColorFormula | 颜色调配的专门记录，含目标色值（Lab/潘通）、色浆组合、实际 ΔE |
|
||
| **色浆** | Colorant | 用于调配颜色的基础着色剂（如氧化铁红、二氧化钛等） |
|
||
| **色差** | Delta E (ΔE) | 两颜色之间的感知差异量化值，标准为 CIEDE2000，目标 ≤ 1.0 |
|
||
|
||
### 配方指标
|
||
|
||
| 术语 | 英文 | 定义 |
|
||
| :--- | :--- | :--- |
|
||
| **肤感指数** | Sensory Index | AI 模型基于成分组合预测的使用肤感评分（0-100），含铺展性、吸收速度、黏腻度等子维度 |
|
||
| **稳定性评分** | Stability Score | AI 预测的配方稳定性评分（0-100），考量成分相容性和乳化稳定性 |
|
||
| **成本估算** | Cost Estimate | 基于各成分单价和比例计算的单位成本（元/kg） |
|
||
|
||
### 色彩科学
|
||
|
||
| 术语 | 英文 | 定义 |
|
||
| :--- | :--- | :--- |
|
||
| **CIELAB** | CIELAB | 设备无关的颜色空间（L*亮度, a*红绿轴, b*黄蓝轴），平台内部颜色表示标准 |
|
||
| **Display P3** | Display P3 | 广色域色彩空间，色域比 sRGB 大 25%，平台渲染目标色域 |
|
||
| **潘通色号** | Pantone | 国际标准色卡编号系统，颜色匹配输入格式之一 |
|
||
| **取色棒** | Color Picker / EyeDropper | 从参考图片中提取颜色的交互工具 |
|
||
|
||
### 配方推演
|
||
|
||
| 术语 | 英文 | 定义 |
|
||
| :--- | :--- | :--- |
|
||
| **推演** | Exploration | 基于约束条件生成多个候选配方方案的过程 |
|
||
| **逆向推演** | Reverse Exploration | 从目标功效指标反推成分组合的推理过程 |
|
||
| **Pareto 前沿** | Pareto Frontier | 成本-功效等多目标优化中，无法在不损害其他目标的情况下改进某一目标的最优解集合 |
|
||
|
||
### AI 相关
|
||
|
||
| 术语 | 英文 | 定义 |
|
||
| :--- | :--- | :--- |
|
||
| **预测** | Prediction | AI 根据成分比例预测肤感/稳定性/成本等指标 |
|
||
| **推荐** | Recommendation | AI 根据约束条件推荐成分或配方方案 |
|
||
| **置信度** | Confidence | AI 预测结果的可靠程度评分 |
|
||
| **降级** | Fallback | AI API 不可用时返回缓存结果或友好提示的容错机制 |
|
||
| **Prompt 模板** | Prompt Template | 每种 AI 能力的标准化提示词模板，包含角色、上下文、输出格式 |
|
||
| **向量搜索** | Vector Search | 将配方/查询转为向量，通过 pgvector HNSW 索引进行语义相似搜索 |
|
||
|
||
## 架构约定
|
||
|
||
- **ADRs**: `docs/adr/` — 架构决策记录
|
||
- **PRD**: `.scratch/formula-rd-platform/PRD.md`
|
||
- **Issues**: `.scratch/<feature-slug>/issues/`
|
||
|
||
## 当前 ADRs
|
||
|
||
| ADR | 主题 | 状态 |
|
||
| :--- | :--- | :--- |
|
||
| [0001](./docs/adr/0001-architecture-stack.md) | 整体技术栈选型 | 已决议 |
|
||
| [0002](./docs/adr/0002-ai-api-strategy.md) | AI 通过外部 API 调用 | 已决议 |
|