产品模块说明书 — BlazorFactory

1. 模块总览

核心数据模型

实体	文件	说明
`ProductTemplate`	`Data/Products/ProductTemplate.cs`	成品/半成品产品档案：编码、名称、11种化妆品类别、批准文号、保质期、追踪方式
`ProductProduct`	`Data/Products/ProductProduct.cs`	原料/包材档案：INCI中英文名、CAS号、10种原料分类、安全限量
`MrpBom`	`Data/Products/MrpBom.cs`	产品配方（BOM）：配方编号、版本、标准批量、状态（草稿/待审/批准/停用/试产）
`MrpBomLine`	`Data/Products/MrpBomLine.cs`	配方明细行：原料配比（%）、标准用量（kg）、相（A/B/C）、投料顺序、消耗模式
`MrpRouting`	`Data/Manufacturing/MrpRouting.cs`	生产工序：19种工序类型（称量→乳化→灌装→装箱）、温度/搅拌/真空参数
`MrpRoutingTemplate`	`Data/Manufacturing/MrpRoutingTemplate.cs`	工艺模板：可复用的标准工艺步骤，关联配方时快速引用
`InciIngredient`	`Data/Products/InciIngredient.cs`	INCI标准原料：80种行业常用原料，含功能分类、法规状态、安全性标签
`CosmeticStandards`	`Data/Products/CosmeticStandards.cs`	化妆品检测标准：GB/T、QB/T标准号，含理化/微生物/毒理指标
`CosmeticSpecific`	`Data/Products/CosmeticSpecific.cs`	化妆品专项测试：防腐挑战、功效评价、斑贴试验

服务与接口

服务	接口	职责
`ProductService`	`IProductService`	产品/原料/配方/配方明细/工序/批次 CRUD + 配方审批/复制
`InciService`	`IInciService`	INCI 原料库管理、搜索、导入导出、与 ProductProduct 映射
`CosmeticTestService`	`ICosmeticTestService`	化妆品专项检测管理

2. 配方生命周期

  Draft → PendingApproval → Approved → (可被新版本替代 → Discontinued)
    ↓
  Trial (试产配方，验证后转正)

5 种配方状态

状态	含义	允许操作
Draft	草稿	编辑配方明细、添加工序、提交审批
PendingApproval	待审核	审批通过 / 退回修改
Approved	已批准	创建生产工单、复制新版本、停用
Discontinued	已停用	仅可查看历史
Trial	试产	用于中试/打样，验证后转正

3. 原料体系

原料类型（MaterialType）

类型	说明
RawMaterial	原材料（活性物、油脂、乳化剂等）
PackagingMaterial	包装材料（瓶、管、盒、标签）
Auxiliary	辅料（清洁剂、消毒剂）
SemiFinished	半成品（中间料体）

原料分类（MaterialCategory）

分类	示例
OilAndWax	油脂/蜡 — GTCC、角鲨烷
Emulsifier	乳化剂 — 鲸蜡硬脂醇聚醚-6
Surfactant	表面活性剂 — 氨基酸表活
Humectant	保湿剂 — 甘油、透明质酸钠
Preservative	防腐剂 — 苯氧乙醇
Fragrance	香精
Colorant	色素
ActiveIngredient	功效成分 — 烟酰胺、维C
Thickener	增稠剂 — 卡波姆
PHAdjuster	pH 调节剂 — 柠檬酸

4. 页面导航指南

🧴 产品管理

路由：/products/list

功能：

11种化妆品类别（护肤/彩妆/防晒/面膜等）
产品编码/名称/规格/批准文号
保质期与存储条件
配方集合与质检标准关联

适用角色：产品经理、研发工程师

📦 原料管理

路由：/products/materials

功能：

原料编码/名称/INCI/CAS号
4种原料类型 + 10种原料分类
安全限量、存储条件
按类型/分类筛选

适用角色：采购工程师、研发工程师

📋 配方管理

路由：/products/formulas

功能：

配方列表: 编号/名称/产品/版本/状态
新建/复制/审批配方
配方详情: 原料明细 + 生产工序
版本管理: 多版本并存，当前版本标记

适用角色：研发工程师、质量总监

🎨 配方设计器

路由：/products/formulas/design

功能：

产品维度配方管理
添加/编辑/排序 BOM 原料明细
关联 INCI 原料库自动填充信息
配比百分比 → 标准用量自动换算
投料相/温度要求/操作说明

适用角色：配方工程师

🔗 合规报告

路由：/products/formulas/compliance-report

功能：

选择产品 → 选择配方版本 → 生成报告
INCI 成分合规性检查
禁用/限用物质比对
配方合规摘要

适用角色：法规专员、QA

🧪 INCI 原料标准库

路由：/products/inci-library

功能：

80种化妆品行业常用原料
INCI 中英文名 / CAS 号 / 功能分类
法规状态 / 致敏风险 / 安全性标签
导入/导出/关联现有原料

适用角色：研发工程师、法规专员

⚙ 工艺模板

路由：/products/process-templates

功能：

可复用的标准工艺步骤
8种化妆品工艺（乳液/水剂/洁面/面膜等）
左侧列表 + 右侧详情双栏布局
切换配方引用快速应用

适用角色：工艺工程师

5. 常见操作指南

创建新产品

从产品管理页开始，建立产品档案。

1. 进入 /products/list → 点击 [新增产品]
2. 填写产品编码、名称、选择化妆品类别
3. 填写规格（如50ml）、批准文号、执行标准
4. 设置保质期（默认36个月）、存储条件
5. 保存后自动创建产品档案，可继续添加配方

新建配方（BOM）

在配方设计器中为产品建立原料清单和生产工艺。

1. 进入 /products/formulas/design → 选择产品
2. 点击 [新建配方] → 输入配方编号、名称、版本
3. 设置标准批量（如1000kg）→ 保存创建空配方
4. [添加原料] → 搜索/选择原料 → 输入配比%和用量kg
5. 选择所属相（A/B/C）→ 设置投料顺序 → 标记关键原料
6. [添加工序] → 选择工序类型 → 填写温度/搅拌/真空参数
7. 提交审批 → 审批通过后可用

配方版本管理

保留历史版本，当前版本标记 IsCurrent。

1. 在配方管理页面找到已批准的配方
2. 点击 [复制为新版本] → 输入新版本号
3. 修改原料配比或工艺参数
4. 提交审批 → 审批通过后自动替代旧版本（旧版→Discontinued）

INCI 原料库使用

标准原料库帮助快速建立原料档案。

1. 进入 /products/inci-library → 点击 [导入种子数据]
2. 搜索目标原料（中英文/INCI/CAS）
3. 点击 [关联现有原料] → 自动映射到 ProductProduct
4. 未匹配的可以手动创建新原料档案

6. 配方设计要点

相分离设计

配方明细按 A/B/C 相组织：

A相（油相）：油脂、蜡、油溶性乳化剂
B相（水相）：水、保湿剂、水溶性成分
C相（后添加）：香精、防腐剂、功效成分（降温后加入）

安全限量

关键检查项：

防腐剂用量 ≤ 《化妆品安全技术规范》限值
防晒剂用量 ≤ 允许添加量
pH 调节后成品 pH 3.0-10.0
香精致敏原需标注

消耗模式

BOM 行消耗类型：

Manual — 操作员手动记录实际用量
Backflush — 工单完工时按标准用量自动扣除（对标 Odoo 19）

产品配方管理

📑 目录