9e371380
 “wangming”
把打印机的联通了
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
|
# 项目上下文（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/` 等目录
后续修改时应避免误覆盖这些现有变更。
|
10fd1324
 李曜臣
5-17接口优化
|
69
70
71
72
73
74
75
76
77
78
79
80
|
## 7. 美国版业务字段命名（固定映射）
开发与文档中统一使用下列对应关系，**不要**在 `location` 表再新增名为 `Region` 的列：
| 界面 / 接口英文 | 中文 | 主数据表 | 门店表 `location` 字段 |
|-----------------|------|----------|------------------------|
| Company / Partner | 公司 | `fl_partner` | `Partner`（公司名称字符串） |
| **Region / Group** | **区域 / 组织** | **`fl_group`**（`GroupName`） | **`GroupName`** |
| Location | 门店 | `location` | `LocationCode` / `LocationName` |
**硬性规则**：**Region 对应 `location.GroupName`**（与 `fl_group.GroupName` 通过 `Partner` + 名称匹配）。列表/API 出参字段名可用 `region`，落库与查询一律用 `GroupName`。
|
