# 项目上下文（Codex 侧）

> 来源：基于仓库现状与 `.cursor/` 配置整理。
> 约束：只读取 `.cursor`，不修改 `.cursor`。

## 1. 项目整体结构

- `泰额版/Food Labeling Management Platform/`
  - React 18 + TypeScript + Vite 6
  - 模块更完整，包含 Dashboard、Labels、Training、Alerts、Products、People、Reports、Locations、Devices、Invoices、QR Codes，以及 Tasks / Sensors / Food Waste / E-Label / API 等入口
- `美国版/Food Labeling Management Platform/`
  - React 18 + TypeScript + Vite 6
  - 模块较泰额版少，主要包含 Dashboard、Labels、Training、Alerts、Products、People、Reports、Locations
- `美国版/Food Labeling Management App UniApp/`
  - uni-app + Vue 3 + TypeScript
  - 页面包含登录、门店选择、标签打印、蓝牙打印、打印日志、语言、支持等
- `美国版/Food Labeling Management Code/Yi.Abp.Net8/`
  - .NET 8 / Yi.Abp / SqlSugar 后端工程
  - 分层包含 `Application`、`Application.Contracts`、`Domain`、`Domain.Shared`、`SqlSugarCore`、`Web`
- `打印机SDK/uniapp/`
  - 打印相关 uni-app SDK 与原生插件资源
- `项目相关文档/`
  - 标签模板相关 Excel 文档

## 2. 当前仓库技术判断

### 前端现状
- Web 管理端实际是 **React + TypeScript + Vite**，不是传统 Vue 2 管理后台。
- 移动端实际是 **uni-app + Vue 3**。
- 因此 `.cursor/rules/project_rules.mdc` 中关于 `Vue 2.6 + Element UI + Webpack` 的描述，更像是历史/迁移前规则，不能覆盖当前真实代码结构。

### 后端现状
- `.cursor` 中关于 ASP.NET Core、SqlSugar、分层架构、XML 注释、SQL 验证等规则，与 `美国版/Food Labeling Management Code` 的目录结构基本一致，可继续参考。

## 3. 从 `.cursor` 迁移过来的可用资料

- 角色参考：`.codex/agents/*.md`
- 技能参考：`.codex/skills/*/SKILL.md`
- 原始来源仍然在 `.cursor/`，若需核对，以 `.cursor/` 为准，但**不要修改 `.cursor`**。

## 4. 使用建议

1. 处理后端 API、数据库、SqlSugar：优先参考 `.codex/agents/backend-developer.md`
2. 处理 Web UI：参考 `.codex/agents/frontend-developer.md`，但实现时要以 React 代码风格为准
3. 做接口测试：参考 `.codex/skills/api-interface-testing/SKILL.md`
4. 写或核对统计 SQL：参考 `.codex/skills/mcp-mysql-and-sql-validation/SKILL.md`
5. 遇到人员/门店归属历史表：参考 `.codex/skills/deprecated-tables-context/SKILL.md`

## 5. 重要冲突处理原则

当 `.cursor` 规则与当前仓库事实冲突时，按以下优先级处理：

1. **当前代码与目录事实优先**
2. 用户明确要求优先
3. `.cursor` 中与当前模块仍然匹配的规则再落地执行

例如：
- 做 React 页面时，不应强行按 Vue 2 / Element UI 规则编写
- 做 .NET + SqlSugar 后端时，可以继续沿用 `.cursor` 里的后端约束

## 6. 工作区注意事项

当前仓库已经存在未提交改动，主要在：
- `.cursor/mcp.json`
- `美国版/Food Labeling Management App UniApp/` 下多个文件
- `打印机SDK/`、`nativeplugins/`、`scripts/`、`unpackage/` 等目录

后续修改时应避免误覆盖这些现有变更。