项目上下文（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/ 等目录

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