# Food Labeling Management Platform

食品标签管理平台 —— 面向餐饮/零售行业的标签设计、打印与管理系统。支持泰额版与美国版两套产品线。

## 项目结构

```
Food-Labeling-Management-Platform/
├── 泰额版/                    # 泰额版（功能更全）
│   └── Food Labeling Management Platform/
├── 美国版/                    # 美国版
│   ├── Food Labeling Management Platform/   # 桌面端管理后台 (React)
│   ├── Food Labeling Management App React/  # 员工端移动 Web (React)
│   └── Food Labeling Management App UniApp/ # 员工端跨平台 (uni-app)
├── .cursor/
│   └── skills/
│       └── ui-ux-pro-max/     # UI/UX Pro Max 设计技能
└── README.md
```

## 功能模块

| 模块 | 泰额版 | 美国版 | 说明 |
|------|:------:|:------:|------|
| Dashboard | ✓ | ✓ | 仪表盘与数据概览 |
| Labeling | ✓ | ✓ | 标签管理（分类、类型、模板、多选项） |
| Label Template Editor | ✓ | ✓ | 所见即所得标签模板编辑器 |
| Training | ✓ | ✓ | 培训管理 |
| Alerts | ✓ | ✓ | 告警管理 |
| Menu Manager | ✓ | ✓ | 菜单/产品管理 |
| Account Management | ✓ | ✓ | 账户/人员管理 |
| Reports | ✓ | ✓ | 报表 |
| Location Manager | ✓ | ✓ | 门店/位置管理 |
| Devices | ✓ | ✓ | 设备管理 |
| Invoices | - | ✓ | 发票管理 |
| QR Codes | ✓ | - | 二维码管理 |
| Tasks / Sensors / Food Waste / E-Label / API | ✓ | - | 泰额版专属模块 |

## 技术栈

- **框架**: React 18 + TypeScript
- **构建**: Vite 6
- **UI**: Radix UI + Tailwind CSS + Lucide Icons
- **图表**: Recharts
- **后端/数据**: Supabase (Hono)
- **标签相关**: JSBarcode、qrcode.react、react-day-picker、react-hook-form

## 快速开始

### 泰额版

```bash
cd "泰额版/Food Labeling Management Platform"
npm install
npm run dev
```

### 美国版 - 桌面端 (Platform)

```bash
cd "美国版/Food Labeling Management Platform"
npm install
npm run dev
```

### 美国版 - 员工端移动 Web (React App)

```bash
cd "美国版/Food Labeling Management App React"
npm install
npm run dev
```

### 美国版 - 员工端跨平台 (uni-app)

```bash
cd "美国版/Food Labeling Management App UniApp"
npm install
npm run dev:h5      # H5
npm run dev:mp-weixin  # 微信小程序
```

### 构建

```bash
npm run build
```

## 设计来源

- Figma 设计稿: [Food-Labeling-Management-Platform](https://www.figma.com/design/PaL1ichhZXRYnFJQCNXHyo/Food-Labeling-Management-Platform)

## 文档

| 文档 | 路径 | 说明 |
|------|------|------|
| 标签模板编辑器规格 | `*/LabelTemplateEditor_Full.md` | 标签编辑器完整开发规格（数据模型、布局、元素类型等1） |

## 开发工具

- **UI/UX Pro Max**: 项目已集成 [UI/UX Pro Max](https://ui.cod.ndjp.net/) 技能，用于 AI 辅助 UI 设计与实现
- **Cursor Skills**: `.cursor/skills/ui-ux-pro-max/` 内含设计数据库（57+ 风格、95+ 配色、56+ 字体、98+ UX 准则）

## 版本

- 当前版本: 0.1.0