diff --git a/美国版/Food Labeling Management Platform/src/services/teamMemberService.ts b/美国版/Food Labeling Management Platform/src/services/teamMemberService.ts
index 1f4929b..71ee3b9 100644
--- a/美国版/Food Labeling Management Platform/src/services/teamMemberService.ts
+++ b/美国版/Food Labeling Management Platform/src/services/teamMemberService.ts
@@ -168,6 +168,8 @@ export async function getTeamMembers(
MaxResultCount: input.maxResultCount,
Keyword: input.keyword,
RoleId: input.roleId,
+ PartnerId: input.partnerId,
+ GroupId: input.groupId,
LocationId: input.locationId,
State: input.state,
Sorting: input.sorting,
diff --git a/美国版/Food Labeling Management Platform/src/types/teamMember.ts b/美国版/Food Labeling Management Platform/src/types/teamMember.ts
index 7f6731a..bf1e715 100644
--- a/美国版/Food Labeling Management Platform/src/types/teamMember.ts
+++ b/美国版/Food Labeling Management Platform/src/types/teamMember.ts
@@ -35,6 +35,8 @@ export type TeamMemberGetListInput = {
maxResultCount: number; // pageSize
keyword?: string;
roleId?: string;
+ partnerId?: string;
+ groupId?: string;
locationId?: string;
state?: boolean;
sorting?: string;
diff --git a/项目相关文档/6-11代码优化.md b/项目相关文档/6-11代码优化.md
index d33d378..683873c 100644
--- a/项目相关文档/6-11代码优化.md
+++ b/项目相关文档/6-11代码优化.md
@@ -1,10 +1,17 @@
# 6-11 代码优化
-本文档说明 **2026-06-11** 对美国版 App **`POST /api/app/us-app-labeling/preview`** 出参 **`labelId`** 的格式调整。
+本文档说明 **2026-06-11** 对美国版 App 标签预览/打印相关的两项**纯后端**改造(**不改 Web / App 前端**):
+
+1. **`POST /api/app/us-app-labeling/preview`** 出参 **`labelId`** 改为门店当日序号 `yyyyMMdd-n`
+2. 模板 **Company 自动生成元素**:预览/打印时按门店从 **`fl_partner`** 填充公司名及可选地址字段
+
+测试环境:`http://flus-test.3ffoodsafety.com`
---
-## 背景
+## 一、Preview 出参 `labelId` 格式
+
+### 背景
预览页「Label ID」原先返回 **`fl_label.Id`**(GUID,如 `3a2192be-7b8f-e3e8-db9c-3a5e627b9222`),与业务要求不符。
@@ -18,11 +25,7 @@
格式:`{yyyyMMdd}-{n}`(`n` 从 1 递增,按 `PrintedAt ?? CreationTime` 所在自然日、同一 `locationId` 统计)。
-测试环境:`http://flus-test.3ffoodsafety.com`
-
----
-
-## 接口说明
+### 接口说明
| 项目 | 内容 |
|------|------|
@@ -30,7 +33,7 @@
| 路径 | `/api/app/us-app-labeling/preview` |
| 鉴权 | Bearer Token |
-### 入参(Body:`UsAppLabelPreviewInputVo`)
+#### 入参(Body:`UsAppLabelPreviewInputVo`)
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
@@ -40,7 +43,7 @@
| `baseTime` | DateTime | 否 | 基准时间;影响模板内日期/时间控件,也用于确定「哪一天的序号」;未传则用服务端当前时间 |
| `printInputJson` | object | 否 | 打印时输入项 |
-### 出参(`UsAppLabelPreviewDto`)变更
+#### 出参(`UsAppLabelPreviewDto`)变更
| 字段 | 变更前 | 变更后 |
|------|--------|--------|
@@ -48,7 +51,7 @@
其余字段(`locationId`、`labelCode`、`template`、`labelLastEdited` 等)不变。
-### `labelId` 计算规则
+#### `labelId` 计算规则
1. 取 **`baseTime ?? 当前服务器时间`** 的日期部分 `yyyyMMdd`。
2. 统计该 **`locationId`** 在当日内已有打印任务数(`fl_label_print_task`,时间取 `PrintedAt ?? CreationTime`)。
@@ -57,9 +60,7 @@
> **注意**:`labelId` 不是 `fl_label.LabelCode`,也不是 `fl_label.Id`。标签主键如需内部关联,请使用打印任务创建后的 `taskId` 或 print-log 中的 `labelEntityId`。
----
-
-## 请求示例
+### 请求示例(labelId)
```bash
curl -X POST "http://flus-test.3ffoodsafety.com/api/app/us-app-labeling/preview" \
@@ -87,9 +88,7 @@ curl -X POST "http://flus-test.3ffoodsafety.com/api/app/us-app-labeling/preview"
若该门店在 `2026-05-13` 已有 2 条打印记录,预览返回 `20260513-3`;当日首条预览为 `20260513-1`。
----
-
-## 涉及代码
+### 涉及代码(labelId)
| 文件 | 说明 |
|------|------|
@@ -98,16 +97,14 @@ curl -X POST "http://flus-test.3ffoodsafety.com/api/app/us-app-labeling/preview"
| `Dtos/UsAppLabeling/UsAppLabelPreviewDto.cs` | `labelId` XML 注释 |
| `IServices/IUsAppLabelingAppService.cs` | 接口注释 |
----
-
-## 验证步骤
+### 验证步骤(labelId)
1. 选定门店,确认当日已有 N 条 `fl_label_print_task`(可用 print-log 列表核对)。
2. 调用 **preview**,`labelId` 应为 `{今日yyyyMMdd}-{N+1}`。
3. 执行 **print** 创建新任务后,print-log 中该任务 `labelId` 与预览时一致(同一时刻连续预览+打印)。
4. 修改 `baseTime` 为历史日期,序号应按该日任务数计算,而非「今天」。
-### SQL 抽查
+#### SQL 抽查
```sql
SELECT Id, LocationId, PrintedAt, CreationTime
@@ -122,7 +119,206 @@ ORDER BY IFNULL(PrintedAt, CreationTime), Id;
---
+## 二、Company 自动生成元素(预览/打印填充)
+
+### 背景
+
+模板编辑器中的 **Company** 控件属于「按门店自动取数」类型。用户点击打印时,后端应:
+
+- **始终**展示当前门店所属 **Company 名称**(`fl_partner.PartnerName`)
+- **仅当模板元素 config 中勾选** Address / City / State / Zip / Email 时,才追加对应行;未勾选或库中无值则不展示该字段
+
+勾选状态**不落独立表**,保存在 **`fl_label_template_element.ConfigJson`**(通过 `POST/PUT /api/app/label-template` 的 `elements[].config` 写入)。公司主数据来自 **`fl_partner`**。
+
+> 本次**不提供** Web 属性面板 UI;需通过 **label-template 保存接口** 或 SQL 维护 `config`。
+
+### 元素识别规则
+
+满足以下任一条件即视为 Company 自动生成元素(`PartnerCompanyDisplayHelper.IsCompanyAutoElement`):
+
+| 条件 | 说明 |
+|------|------|
+| `typeAdd = "auto_Company"` | 标准 Company 控件 |
+| `valueSourceType = "AUTO_DB"` 且 `typeAdd` 以 `auto_` 开头且含 `Company` | 兼容命名 |
+
+常见组合:`elementType = "TEXT_STATIC"`,`valueSourceType = "AUTO_DB"`,`typeAdd = "auto_Company"`。
+
+### 模板 config(勾选字段)
+
+写入 `elements[].config`(JSON),支持两种等价写法(可混用):
+
+**方式 A:数组 `companyIncludeFields`**
+
+| 数组值 | 含义 | 数据来源(`fl_partner`) |
+|--------|------|--------------------------|
+| `address` | 街道地址 | `Street` |
+| `city` | 城市 | `City` |
+| `state` | 州/省 | `StateCode` |
+| `zip` | 邮编 | `ZipCode` |
+| `email` | 邮箱 | `ContactEmail` |
+
+**方式 B:布尔开关**
+
+`includeAddress` / `includeCity` / `includeState` / `includeZip` / `includeEmail`(`true` 表示勾选)
+
+**示例(保存模板时)**
+
+```json
+{
+ "elementType": "TEXT_STATIC",
+ "valueSourceType": "AUTO_DB",
+ "typeAdd": "auto_Company",
+ "name": "Company",
+ "config": {
+ "companyIncludeFields": ["address", "city", "state", "zip", "email"]
+ }
+}
+```
+
+或:
+
+```json
+"config": {
+ "includeAddress": true,
+ "includeCity": true,
+ "includeState": true,
+ "includeZip": true,
+ "includeEmail": false
+}
+```
+
+### 展示文本格式
+
+后端将解析结果写入 **`template.elements[].config.text`**(多行,`\n` 分隔):
+
+| 行序 | 内容 | 规则 |
+|------|------|------|
+| 第 1 行 | 公司名 | **固定输出**(有 `PartnerName` 时) |
+| 第 2 行 | 街道 | 仅勾选 `address` 且 `Street` 非空 |
+| 第 3 行 | 城市, 州, 邮编 | 勾选 city/state/zip 中任一项时,按「City, StateCode, ZipCode」逗号拼接(空段跳过) |
+| 第 4 行 | 邮箱 | 仅勾选 `email` 且 `ContactEmail` 非空 |
+
+**渲染示例**
+
+```
+Acme Foods Inc
+123 Main Street
+New York, NY, 10001
+sales@acme.com
+```
+
+若仅勾选公司名(无任何 include),则 `text` 仅一行公司名。
+
+### 门店 → Company 解析
+
+1. 入参 **`locationId`**(`location.Id`,Guid 字符串)
+2. 查 `location` 表取 **`Partner`** 字段
+3. 在 **`fl_partner`** 中按 **`Id = Partner`** 或 **`PartnerName = Partner`** 匹配(未删除)
+4. 匹配失败时不抛错,`config.text` 保持原样(不填充)
+
+### 入参要求
+
+| 场景 | `locationId` |
+|------|----------------|
+| 模板**不含** Company 自动生成元素 | 可选(App preview 仍必填门店,与原有逻辑一致) |
+| 模板**含** Company 自动生成元素 | **`LabelPreviewResolveInputVo.locationId` 必填**;缺失返回 **400**:`预览/打印需要 locationId 以填充 Company 信息` |
+
+**App 调用链**:`UsAppLabelPreviewInputVo.locationId` → 内部 `LabelAppService.PreviewAsync(LabelPreviewResolveInputVo)` 时须**原样传入** `locationId`。
+
+受影响接口(均通过 `LabelAppService.PreviewAsync` 渲染模板):
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| POST | `/api/app/us-app-labeling/preview` | App 预览 |
+| POST | `/api/app/us-app-labeling/print` | App 打印(落库前解析模板) |
+| POST | `/api/app/label/preview`(或管理端等价预览) | Web 预览;含 Company 元素时 Body 须带 `locationId` |
+
+重打 **`reprint`** 使用历史任务 `RenderTemplateJson` 快照,**不再**重新解析 Company。
+
+### 出参变更
+
+无新增顶层字段;变更在 **`template.elements[]`** 内:
+
+| 字段 | 变更 |
+|------|------|
+| `elements[].config.text` | Company 元素由后端按上文规则写入多行文本 |
+
+### 数据库与脚本
+
+| 项 | 说明 |
+|----|------|
+| `fl_partner.PartnerName` | 公司名(必有) |
+| `fl_partner.Street` / `City` / `StateCode` / `ZipCode` / `ContactEmail` | 可选展示字段 |
+| `location.Partner` | 门店归属 Company 键(Id 或名称) |
+| DDL | `scripts/fl_partner_add_address_columns.sql`(缺地址列时执行) |
+
+模板适用范围(Company/Region/Location 三维 scope)见 **`项目相关文档/6-4代码优化.md`**,与本节「元素内 Company 自动填值」相互独立。
+
+### 请求示例(含 Company 的 preview)
+
+```bash
+curl -X POST "http://flus-test.3ffoodsafety.com/api/app/us-app-labeling/preview" \
+ -H "Authorization: Bearer {token}" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "locationId": "550e8400-e29b-41d4-a716-446655440000",
+ "labelCode": "LBL0001",
+ "productId": "PROD001"
+ }'
+```
+
+响应 `template.elements` 中 Company 元素片段示例:
+
+```json
+{
+ "elementType": "TEXT_STATIC",
+ "typeAdd": "auto_Company",
+ "valueSourceType": "AUTO_DB",
+ "config": {
+ "companyIncludeFields": ["address", "city", "state", "zip"],
+ "text": "Acme Foods Inc\n123 Main Street\nNew York, NY, 10001"
+ }
+}
+```
+
+### 涉及代码(Company)
+
+| 文件 | 说明 |
+|------|------|
+| `Helpers/PartnerCompanyDisplayHelper.cs` | 识别元素、解析 config、格式化文本、门店→Partner |
+| `Services/LabelAppService.cs` | `PreviewAsync` 填充 Company 的 `config.text` |
+| `Dtos/Label/LabelPreviewResolveInputVo.cs` | 新增 `locationId` |
+| `Services/UsAppLabelingAppService.cs` | preview/print 调用预览时传入 `locationId` |
+
+### 验证步骤(Company)
+
+1. 确认门店 `location.Partner` 能关联到有效 `fl_partner` 记录(地址列已执行 DDL)。
+2. 模板含 `auto_Company` 元素,`config` 勾选若干 include 字段;保存后查 `fl_label_template_element.ConfigJson`。
+3. 调用 **preview**,Body 带正确 `locationId`:`template.elements` 中 Company 的 `config.text` 行数与勾选一致。
+4. 去掉 `locationId` 或传空 → 返回 400(仅当模板含 Company 元素时)。
+5. 执行 **print**,检查 `fl_label_print_task.RenderTemplateJson` 内 Company `text` 与预览一致。
+
+#### SQL 抽查
+
+```sql
+-- 门店归属 Company
+SELECT l.Id, l.Partner, p.PartnerName, p.Street, p.City, p.StateCode, p.ZipCode, p.ContactEmail
+FROM location l
+LEFT JOIN fl_partner p ON (p.Id = l.Partner OR p.PartnerName = l.Partner) AND p.IsDeleted = 0
+WHERE l.Id = '{locationId}' AND l.IsDeleted = 0;
+
+-- 模板 Company 元素 config
+SELECT e.Id, e.TypeAdd, e.ValueSourceType, e.ConfigJson
+FROM fl_label_template_element e
+JOIN fl_label_template t ON t.Id = e.TemplateId
+WHERE t.TemplateCode = '{templateCode}' AND e.IsDeleted = 0
+ AND e.TypeAdd = 'auto_Company';
+```
+
+---
+
## 关联文档
- 同序号规则:`项目相关文档/6-2代码优化.md` → **App `get-print-log-list` 的 Label ID**
+- 模板三维 scope:`项目相关文档/6-4代码优化.md` → **`/api/app/label-template`**
- App 预览页读取字段:`labelId` / `LabelId`(`preview.vue`)
diff --git a/项目相关文档/6-16代码优化.md b/项目相关文档/6-16代码优化.md
new file mode 100644
index 0000000..8e3a5ae
--- /dev/null
+++ b/项目相关文档/6-16代码优化.md
@@ -0,0 +1,139 @@
+# 6-16 代码优化
+
+本文档说明 **2026-06-16** 对美国版 Web 管理端 **`GET /api/app/dashboard/overview`** 中 **Recent Labels** 区块 **Label ID** 展示规则的同步改造。
+
+测试环境:`http://flus-test.3ffoodsafety.com`
+
+---
+
+## 背景
+
+Dashboard「Recent Labels」列表原先 `recentLabels[].labelCode` 返回 **`fl_label.LabelCode`**(或标签业务编码),与业务要求的 **Label ID** 含义不一致。
+
+业务规则(与 App preview、Print Log、报表一致):
+
+**Label ID = 某门店在某个自然日内,每次打印任务按时间递增的序号**
+
+| 示例 | 含义 |
+|------|------|
+| `20260513-1` | 该门店 2026-05-13 当日第 1 次打印 |
+| `20260513-2` | 同日第 2 次 |
+| `20260514-1` | 次日重新从 1 计数 |
+
+格式:`{yyyyMMdd}-{n}`(`n` 从 1 递增;按 **`PrintedAt ?? CreationTime`** 所在自然日、同一 **`locationId`** 统计)。
+
+> **注意**:`labelCode` 字段名保持不变(前端 Recent Labels 已绑定该字段展示 Label ID),**语义**由「标签编码」改为「门店当日打印序号」。不是 `fl_label.Id`,也不是 `fl_label.LabelCode`。
+
+---
+
+## 接口说明
+
+| 项目 | 内容 |
+|------|------|
+| 方法 | `GET` |
+| 路径 | `/api/app/dashboard/overview` |
+| 鉴权 | Bearer Token(Web 管理端登录 Token) |
+| 入参 | 无 |
+
+### 出参变更(`DashboardOverviewOutputDto.recentLabels[]`)
+
+| 字段 | 变更前 | 变更后 |
+|------|--------|--------|
+| **`labelCode`** | `fl_label.LabelCode`(标签业务编码) | 该打印任务在所属门店、打印日内的序号 **`yyyyMMdd-n`** |
+
+`recentLabels` 其余字段(`taskId`、`displayName`、`printedByName`、`printedAt`、`status`、`labelTypeBadge`)不变。
+
+Overview 其它区块(指标卡片、周趋势、分类分布等)不受影响。
+
+### `labelCode`(Label ID)计算规则
+
+与 **`POST /api/app/us-app-labeling/preview`**、**`GET /api/app/reports/print-log-list`** 共用 Helper:**`ReportsPrintLogDailyLabelIdHelper.ResolveDailyLabelIdsAsync`**。
+
+1. 取打印任务 **`PrintedAt ?? CreationTime`** 的日期部分 `yyyyMMdd`。
+2. 在同一 **`locationId`**、同一自然日内,按 `PrintedAt ?? CreationTime` 升序、`Id` 升序对所有任务排序。
+3. 第 `i` 条任务的 Label ID = **`{yyyyMMdd}-{i}`**(`i` 从 1 开始)。
+4. Recent Labels 取权限范围内**最新 10 条**打印任务;每条任务的 `labelCode` 为其在**所属门店当日序列**中的序号(非全平台统一编号)。
+
+多门店场景:不同门店各自从 `-1` 计数;同一 Dashboard 列表可混合展示多个门店的记录,每条记录的 `labelCode` 仅对应该任务的 `locationId` + 打印日。
+
+---
+
+## 请求示例
+
+```bash
+curl -X GET "http://flus-test.3ffoodsafety.com/api/app/dashboard/overview" \
+ -H "Authorization: Bearer {token}"
+```
+
+### 响应片段(`recentLabels` 示例)
+
+```json
+{
+ "recentLabels": [
+ {
+ "taskId": "1234567890123456789",
+ "labelCode": "20260604-3",
+ "displayName": "Organic Milk 1L",
+ "printedByName": "Alice",
+ "printedAt": "2026-06-04T14:22:00",
+ "status": "active",
+ "labelTypeBadge": "2\"x2\""
+ },
+ {
+ "taskId": "1234567890123456788",
+ "labelCode": "20260604-2",
+ "displayName": "Whole Wheat Bread",
+ "printedByName": "Bob",
+ "printedAt": "2026-06-04T11:05:00",
+ "status": "expired",
+ "labelTypeBadge": "4\"x2\""
+ }
+ ],
+ "generatedAt": "2026-06-04T15:00:00"
+}
+```
+
+若某任务无法解析门店或打印时间,则 `labelCode` 为 **`无`**。
+
+---
+
+## 涉及代码
+
+| 文件 | 说明 |
+|------|------|
+| `Services/DashboardAppService.cs` | `GetOverviewAsync`:`recentLabels` 查询增加 `LocationId`,调用 `ResolveDailyLabelIdsAsync` 填充 `labelCode` |
+| `Dtos/Dashboard/DashboardRecentLabelItemDto.cs` | `LabelCode` XML 注释更新为当日序号语义 |
+| `IServices/IDashboardAppService.cs` | 接口 `remarks` 补充 `recentLabels[].labelCode` 规则说明 |
+| `Helpers/ReportsPrintLogDailyLabelIdHelper.cs` | 共用(与 6-11 preview / 6-2 print-log 一致) |
+
+---
+
+## 验证步骤
+
+1. 登录 Web 管理端,获取 Bearer Token。
+2. 选定门店,确认某自然日已有 N 条 `fl_label_print_task`(可用 print-log 或 SQL 核对)。
+3. 调用 **`GET /api/app/dashboard/overview`**,`recentLabels` 中对应任务的 **`labelCode`** 应与 print-log 列表中同一 `taskId` 的 Label ID 一致。
+4. 跨日打印:次日首条应为 `{新日期}-1`。
+5. 多门店:两门店同日各打印 1 次,两条记录的 `labelCode` 末尾序号均可为 `-1`(各自门店独立计数)。
+
+### SQL 抽查
+
+```sql
+SELECT Id, LocationId, PrintedAt, CreationTime,
+ IFNULL(PrintedAt, CreationTime) AS EffectiveTime
+FROM fl_label_print_task
+WHERE LocationId = '{locationId}'
+ AND IFNULL(PrintedAt, CreationTime) >= '{yyyy-MM-dd}'
+ AND IFNULL(PrintedAt, CreationTime) < DATE_ADD('{yyyy-MM-dd}', INTERVAL 1 DAY)
+ORDER BY EffectiveTime, Id;
+```
+
+按行号 `1..N` 对应 `labelCode` 的 `-n` 部分;日期部分为 `yyyyMMdd`。
+
+---
+
+## 关联文档
+
+- Label ID 通用规则与 preview:`项目相关文档/6-11代码优化.md`
+- App print-log Label ID:`项目相关文档/6-2代码优化.md`
+- Dashboard 数据范围(管理员 / 门店绑定):`DashboardScopeHelper` 及接口 `IDashboardAppService` 注释
diff --git a/项目相关文档/6-17代码优化.md b/项目相关文档/6-17代码优化.md
new file mode 100644
index 0000000..337ab5a
--- /dev/null
+++ b/项目相关文档/6-17代码优化.md
@@ -0,0 +1,336 @@
+# 6-17 代码优化
+
+本文档说明 **2026-06-17** 对美国版的两项后端改造:
+
+1. **`GET /api/app/label-template`** 列表 500 修复(scope 库结构兼容)
+2. **`POST /api/app/us-app-labeling/get-print-log-list`** 增加 **按自然日** 的打印时间筛选
+
+测试环境:`http://flus-test.3ffoodsafety.com`
+
+---
+
+## 一、label-template 列表修复
+
+Web 管理端 **Label Templates** 页加载失败,Network 中:
+
+`GET /api/app/label-template?SkipCount=1&MaxResultCount=10` 返回错误,页面提示 **Failed to load label templates**。
+
+### 根因
+
+6-4 改造引入 **Company / Region / Location** 三维适用范围后,代码会:
+
+1. 查询 `fl_label_template.AppliedPartnerType` / `AppliedRegionType`
+2. 关联 `fl_label_template_partner` / `fl_label_template_region`
+
+测试库若**尚未执行**迁移脚本 `fl_label_template_scope.sql`,上述列/表不存在,SqlSugar 生成 SQL 时报 **Unknown column / Table doesn't exist**,接口 500。
+
+> `SkipCount=1` 表示**第 1 页**(页码从 1 起),不是报错原因。
+
+---
+
+### 修复说明
+
+#### 1. 库结构兼容(未迁移仍可列表)
+
+| 改动 | 说明 |
+|------|------|
+| `LabelTemplateScopeSchemaHelper` | 启动后首次请求检测 partner/region 关联表是否存在 |
+| `FlLabelTemplateDbEntity` | `AppliedPartnerType` / `AppliedRegionType` 标记 `IsIgnore`,避免 SELECT 不存在列 |
+| `LabelTemplateScopeHelper` | 未迁移时列表/详情 **仅 Location 维度** 过滤与展示;Company/Region 显示 `All Companies` / `All Regions` |
+| 已迁移库 | 行为与 6-4 一致,按关联表判断 ALL/SPECIFIED |
+
+#### 2. 列表筛选补全
+
+`LabelTemplateGetListInputVo` 增加 **`partnerId`**(Company),与 `groupId`、`locationId` 按「门店优先」解析(`ResolveFilteredLocationIdsForListAsync`)。
+
+#### 3. Items 列
+
+`LabelTemplateListItemsHelper` 补全 `ElementKey` 查询字段,控件名称排序稳定。
+
+---
+
+### 接口说明(label-template)
+
+| 项目 | 内容 |
+|------|------|
+| 方法 | `GET` |
+| 路径 | `/api/app/label-template` |
+| 鉴权 | Bearer Token |
+
+### 入参(Query)
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `SkipCount` | int | 否 | **页码,从 1 起**;第一页传 `1`(与全平台列表约定一致) |
+| `MaxResultCount` | int | 否 | 每页条数,默认 10 |
+| `Keyword` | string | 否 | 模板名称 / 编码模糊搜索 |
+| `PartnerId` | string | 否 | 按 Company(`fl_partner.Id`)筛选 |
+| `GroupId` | string | 否 | 按 Region(`fl_group.Id`)筛选 |
+| `LocationId` | string | 否 | 按门店(`location.Id`)筛选;**优先于** Partner/Region |
+| `LabelType` | string | 否 | 如 `PRICE` / `NUTRITION` |
+| `State` | bool | 否 | 启用状态 |
+| `Sorting` | string | 否 | 排序字段 |
+
+筛选解析顺序:**LocationId → GroupId → PartnerId**;均未传则不按门店范围收窄(仍受登录账号数据权限约束)。
+
+### 出参(`PagedResultWithPageDto
`)
+
+| 字段 | 说明 |
+|------|------|
+| `pageIndex` | 当前页码 |
+| `pageSize` | 每页条数 |
+| `totalCount` | 总条数 |
+| `totalPages` | 总页数 |
+| `items[]` | 模板列表 |
+
+**`items[]` 主要字段**
+
+| 字段 | 说明 |
+|------|------|
+| `id` / `templateCode` | 模板编码(前端主键) |
+| `templateName` | 模板名称 |
+| `company` / `region` / `location` | 三维适用范围展示文案 |
+| `partnerIds` / `regionIds` / `locationIds` | 对应 Id 数组(ALL 时为空) |
+| `items` / `itemNames` | 模板内控件名称(逗号拼接 / 数组) |
+| `contentsCount` | 控件数量 |
+| `sizeText` | 如 `4x2inch` |
+| `lastEdited` | 最近编辑时间 |
+
+---
+
+### 请求示例(label-template)
+
+```bash
+curl -G "http://flus-test.3ffoodsafety.com/api/app/label-template" \
+ -H "Authorization: Bearer {token}" \
+ --data-urlencode "SkipCount=1" \
+ --data-urlencode "MaxResultCount=10"
+```
+
+带筛选:
+
+```bash
+curl -G "http://flus-test.3ffoodsafety.com/api/app/label-template" \
+ -H "Authorization: Bearer {token}" \
+ --data-urlencode "SkipCount=1" \
+ --data-urlencode "MaxResultCount=10" \
+ --data-urlencode "PartnerId=1234567890123456789" \
+ --data-urlencode "Keyword=Price"
+```
+
+### 响应片段(示例)
+
+```json
+{
+ "pageIndex": 1,
+ "pageSize": 10,
+ "totalCount": 2,
+ "totalPages": 1,
+ "items": [
+ {
+ "id": "TPL-PRICE-01",
+ "templateCode": "TPL-PRICE-01",
+ "templateName": "Standard Price Label",
+ "company": "All Companies",
+ "region": "All Regions",
+ "location": "All Locations",
+ "items": "Label Name, Price, Barcode",
+ "itemNames": ["Label Name", "Price", "Barcode"],
+ "contentsCount": 3,
+ "sizeText": "2x2inch",
+ "lastEdited": "2026-06-04T10:00:00"
+ }
+ ]
+}
+```
+
+---
+
+## 数据库迁移(启用完整三维 scope)
+
+未执行前:列表可正常返回,但 **无法** 保存 Company/Region 多选明细。
+
+**脚本(可重复执行)**:
+
+`美国版/Food Labeling Management Code/Yi.Abp.Net8/module/food-labeling-us/scripts/fl_label_template_scope.sql`
+
+| 对象 | 说明 |
+|------|------|
+| `fl_label_template.AppliedPartnerType` | Company:ALL / SPECIFIED |
+| `fl_label_template.AppliedRegionType` | Region:ALL / SPECIFIED |
+| `fl_label_template_partner` | Company 多选明细 |
+| `fl_label_template_region` | Region 多选明细 |
+
+执行后重启应用,新建/编辑模板即可写入 Company/Region 范围。
+
+### SQL 检查是否已迁移
+
+```sql
+SELECT COLUMN_NAME
+FROM information_schema.COLUMNS
+WHERE TABLE_SCHEMA = DATABASE()
+ AND TABLE_NAME = 'fl_label_template'
+ AND COLUMN_NAME IN ('AppliedPartnerType', 'AppliedRegionType');
+
+SELECT TABLE_NAME
+FROM information_schema.TABLES
+WHERE TABLE_SCHEMA = DATABASE()
+ AND TABLE_NAME IN ('fl_label_template_partner', 'fl_label_template_region');
+```
+
+---
+
+### 涉及代码(label-template)
+
+| 文件 | 说明 |
+|------|------|
+| `Helpers/LabelTemplateScopeSchemaHelper.cs` | 检测 scope 表是否已迁移 |
+| `Helpers/LabelTemplateScopeHelper.cs` | 兼容未迁移库的过滤/展示/保存 |
+| `Helpers/LabelTemplateListItemsHelper.cs` | Items 列 ElementKey |
+| `Services/DbModels/FlLabelTemplateDbEntity.cs` | Partner/Region 列 IsIgnore |
+| `Services/LabelTemplateAppService.cs` | 列表筛选支持 `partnerId` |
+| `Dtos/LabelTemplate/LabelTemplateGetListInputVo.cs` | 新增 `PartnerId` |
+| `IServices/ILabelTemplateAppService.cs` | 接口注释 |
+
+### 验证步骤(label-template)
+
+1. **未迁移库**:仅执行后端部署,调用 `GET /api/app/label-template?SkipCount=1&MaxResultCount=10` 应 **200**,Web 列表可加载。
+2. **已迁移库**:列表 `company`/`region` 展示与 6-4 一致;指定 Company 保存后再查列表 Id 数组正确。
+3. 分页:第 1 页 `SkipCount=1`,第 2 页 `SkipCount=2`,`totalCount` 与 UI 分页一致。
+4. 筛选:传 `LocationId` 后仅返回该门店可见模板 + 全范围模板。
+
+---
+
+## 二、App Print Log 按日筛选(get-print-log-list)
+
+### 背景
+
+App **Print Log** 页增加 **Date** 选择器(及 **Today** 快捷按钮),需按所选自然日只展示该门店当日的打印记录;无记录时提示如 `No print records for 06/16/2026`。
+
+改造前接口仅按门店 + 权限分页,**无日期条件**,无法与 UI 日期筛选对齐。
+
+### 接口说明
+
+| 项目 | 内容 |
+|------|------|
+| 方法 | `POST` |
+| 路径 | `/api/app/us-app-labeling/get-print-log-list` |
+| 鉴权 | App Bearer Token |
+
+### 入参(Body:`PrintLogGetListInputVo`)
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `locationId` | string | 是 | 当前门店 Id(`location.Id`) |
+| **`printDate`** | DateTime | 否 | **打印日期(自然日)**;按 `PrintedAt ?? CreationTime` 落在该日的任务筛选 |
+| `skipCount` | int | 否 | 页码,从 **1** 起 |
+| `maxResultCount` | int | 否 | 每页条数 |
+
+#### `printDate` 规则
+
+1. **未传** → 默认 **服务器当天**(与 App 默认选中 Today 一致)。
+2. **传入任意时刻** → 仅取 **日期部分**(`Date`),区间为 `[当天 00:00:00, 次日 00:00:00)`。
+3. 有效时间字段:`fl_label_print_task.PrintedAt` 优先,为空则用 `CreationTime`(与 Label ID 序号、`6-2` / `6-11` 一致)。
+4. 权限不变:管理员 / Partner 看门店全部;其它角色仅本人(`CreatedBy`)。
+
+### 出参
+
+仍为 `PagedResultWithPageDto`;`items[]` 字段不变。`totalCount` 为**该日**符合条件的总数。
+
+| 字段 | 说明 |
+|------|------|
+| `labelId` | 门店当日打印序号 `yyyyMMdd-n`(与 preview / 报表一致) |
+| `printedAt` | 打印时间 |
+| 其它 | 与改造前一致 |
+
+### 请求示例
+
+**查询当天(显式传 printDate)**
+
+```bash
+curl -X POST "http://flus-test.3ffoodsafety.com/api/app/us-app-labeling/get-print-log-list" \
+ -H "Authorization: Bearer {token}" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "locationId": "550e8400-e29b-41d4-a716-446655440000",
+ "printDate": "2026-06-16T00:00:00",
+ "skipCount": 1,
+ "maxResultCount": 20
+ }'
+```
+
+**Today 按钮(不传 printDate,后端默认当天)**
+
+```json
+{
+ "locationId": "550e8400-e29b-41d4-a716-446655440000",
+ "skipCount": 1,
+ "maxResultCount": 20
+}
+```
+
+### 响应片段(示例)
+
+```json
+{
+ "pageIndex": 1,
+ "pageSize": 20,
+ "totalCount": 2,
+ "totalPages": 1,
+ "items": [
+ {
+ "taskId": "1234567890123456789",
+ "labelId": "20260616-1",
+ "productName": "Organic Milk",
+ "printedAt": "2026-06-16T09:15:00",
+ "operatorName": "Alice",
+ "locationName": "Ordos Airport"
+ },
+ {
+ "taskId": "1234567890123456788",
+ "labelId": "20260616-2",
+ "printedAt": "2026-06-16T14:30:00"
+ }
+ ]
+}
+```
+
+若 `totalCount = 0`,App 可展示 `No print records for MM/DD/YYYY`。
+
+### 涉及代码(get-print-log-list)
+
+| 文件 | 说明 |
+|------|------|
+| `Dtos/UsAppLabeling/PrintLogGetListInputVo.cs` | 新增 `PrintDate` |
+| `Services/UsAppLabelingAppService.cs` | `GetPrintLogListAsync` 增加日期 Where |
+| `Helpers/ReportsPrintLogDailyLabelIdHelper.cs` | 新增 `ResolvePrintLogFilterDayRange` |
+| `IServices/IUsAppLabelingAppService.cs` | 接口注释 |
+
+### 验证步骤(get-print-log-list)
+
+1. 门店在 `2026-06-16` 有 N 条打印任务,传 `printDate=2026-06-16` → `totalCount=N`,且每条 `printedAt` 落在该日。
+2. 传 `printDate=2026-06-15` 且无记录 → `totalCount=0`,`items=[]`。
+3. 不传 `printDate` → 等价于查询**服务器当天**。
+4. 同一 `printDate` 下 `labelId` 序号与 `6-2` 规则一致(`-1`、`-2` … 按当日时间升序)。
+
+#### SQL 抽查
+
+```sql
+SELECT Id, LocationId, PrintedAt, CreationTime
+FROM fl_label_print_task
+WHERE LocationId = '{locationId}'
+ AND IFNULL(PrintedAt, CreationTime) >= '2026-06-16'
+ AND IFNULL(PrintedAt, CreationTime) < '2026-06-17'
+ORDER BY IFNULL(PrintedAt, CreationTime), Id;
+```
+
+行数应与接口 `totalCount`(该日、该门店、权限范围内)一致。
+
+---
+
+## 关联文档
+
+- 三维 scope 业务规则:`项目相关文档/6-4代码优化.md`
+- App Print Log Label ID:`项目相关文档/6-2代码优化.md`
+- Preview 当日序号:`项目相关文档/6-11代码优化.md`
+- 分页约定(SkipCount = 页码):`Helpers/PagedQueryConvention.cs`
diff --git a/项目相关文档/6-18代码优化.md b/项目相关文档/6-18代码优化.md
new file mode 100644
index 0000000..9f5fe00
--- /dev/null
+++ b/项目相关文档/6-18代码优化.md
@@ -0,0 +1,650 @@
+# 6-18 代码优化
+
+本文档说明 **2026-06-18** 对 **`GET /api/app/label-template`** 列表接口的第二轮修复。
+
+6-17 已完成 scope 库结构兼容(未迁移 `fl_label_template_partner` / `fl_label_template_region` 时仍可查询),但测试环境 Web **Label Templates** 页仍返回 **500**,Network 中:
+
+`GET /api/app/label-template?SkipCount=1&MaxResultCount=10`
+
+测试环境:`http://flus-test.3ffoodsafety.com`
+
+---
+
+## 一、现象
+
+- 页面提示:**Failed to load label templates. Request failed.**
+- 接口 HTTP **500**,响应体 `errors` 为空,无具体异常文案。
+- 同页 `partner` / `group` / `location` 下拉接口可正常加载。
+
+> `SkipCount=1` 表示**第 1 页**(页码从 1 起),不是报错原因。详见 `Helpers/PagedQueryConvention.cs`。
+
+---
+
+## 二、根因
+
+服务端日志已明确报错:
+
+```text
+Unknown column 'AppliedPartnerType' in 'field list'
+```
+
+对应 SQL:
+
+```sql
+SELECT ... `AppliedLocationType`,`AppliedPartnerType`,`AppliedRegionType`, ...
+FROM `fl_label_template`
+WHERE NOT ( `IsDeleted`=1 )
+ORDER BY IFNULL(`LastModificationTime`,`CreationTime`) DESC
+LIMIT 0,10
+```
+
+### 2.1 主因:ORM 实体仍映射不存在列
+
+6-17 曾在 `FlLabelTemplateDbEntity` 上对 `AppliedPartnerType` / `AppliedRegionType` 标记 `[SugarColumn(IsIgnore = true)]`,但当前 SqlSugar 运行时**仍会**把这两列拼进 `SELECT`(与 `fl_label.AppliedRegionType` 的 `IsIgnore` 行为不一致),导致未执行 `fl_label_template_scope.sql` 的库直接 500。
+
+**MCP 查库(测试库)**:
+
+- `fl_label_template` **无** `AppliedPartnerType` / `AppliedRegionType` 列
+- **无** `fl_label_template_partner` / `fl_label_template_region` 表
+- **有** `AppliedLocationType` 与 `fl_label_template_location`
+
+### 2.2 次因:列表 SQL 其它隐患(一并修复)
+
+| # | 问题 | 后果 |
+|---|------|------|
+| 1 | 默认排序曾用 `LastModificationTime ?? CreationTime` | SqlSugar 翻译失败 → 500 |
+| 2 | `Sorting` 直接 `OrderBy(input.Sorting)` 拼 SQL | 非法字段 / 注入风险 |
+| 3 | 空 `templateIds` 仍 `Contains` 查询 | 可能生成 `IN ()` |
+| 4 | 无效 partner/group 筛选未安全降级 | 未捕获异常 |
+
+---
+
+## 三、修复说明
+
+### 1. 从 ORM 实体移除不存在列 + 强制列投影(核心)
+
+| 改动 | 说明 |
+|------|------|
+| `FlLabelTemplateDbEntity` | **删除** `AppliedPartnerType` / `AppliedRegionType` 属性 |
+| **`LabelTemplateQueryHelper.ProjectListColumns`** | 列表/详情/重复校验等只读查询 **显式 Select** 真实列,SQL 不再出现 scope 列 |
+| `LabelTemplateScopeSchemaHelper` | 探测列/表;已迁移时用 raw SQL 写入 scope 列 |
+| `LabelTemplateAppService` | `GetListAsync` 在排序后调用 `ProjectListColumns` |
+
+> **重要**:若 Yi-SQL 日志仍出现 `AppliedPartnerType`,说明进程加载的是**旧 DLL**(`FoodLabeling.Application` 未重新编译或未重启)。请先 `dotnet build` 通过后再**完全停止并重启** `Yi.Abp.Web`。
+
+### 2. 安全排序
+
+新增 `ApplyLabelTemplateListSorting`:
+
+- 默认:`ORDER BY IFNULL(LastModificationTime, CreationTime) DESC, TemplateCode ASC`
+- `Sorting` 白名单字段 + asc/desc
+
+### 3. 列表查询健壮性
+
+| 改动 | 说明 |
+|------|------|
+| `input ??= new()`、`pageSize` 默认 10 | 入参/分页兜底 |
+| `templateIds.Count > 0` 再查 elements/items | 避免空 `IN ()` |
+| `ResolveFilteredLocationIdsForListAsync` | 无效 partner/group 返回空列表 |
+| `DeleteAsync` | 仅当 scope 关联表存在时才删除 partner/region 行 |
+
+### 4. 与 6-17 的关系
+
+6-17 用 `IsIgnore` 试图跳过列映射,**实测无效**;6-18 改为**实体不含列 + raw SQL 按需写入**,与 `fl_label.AppliedRegionType` 处理方式一致。
+
+---
+
+## 四、接口说明
+
+| 项目 | 内容 |
+|------|------|
+| 方法 | `GET` |
+| 路径 | `/api/app/label-template` |
+| 鉴权 | Bearer Token(`Authorization: {data.token}`,`data.token` 已含 `Bearer ` 前缀) |
+
+### 入参(Query)
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `SkipCount` | int | 否 | **页码,从 1 起**;第一页传 `1` |
+| `MaxResultCount` | int | 否 | 每页条数;`<=0` 时后端按 **10** 处理 |
+| `Keyword` | string | 否 | 模板名称 / 编码模糊搜索 |
+| `PartnerId` | string | 否 | 按 Company(`fl_partner.Id`)筛选 |
+| `GroupId` | string | 否 | 按 Region(`fl_group.Id`)筛选 |
+| `LocationId` | string | 否 | 按门店(`location.Id`)筛选;**优先于** Partner/Region |
+| `LabelType` | string | 否 | 如 `PRICE` / `NUTRITION` |
+| `State` | bool | 否 | 启用状态 |
+| `Sorting` | string | 否 | 白名单:`TemplateName asc/desc`、`TemplateCode asc/desc`、`CreationTime asc/desc`、`LastModificationTime asc/desc`;其它值忽略并走默认排序 |
+
+筛选解析顺序:**LocationId → GroupId → PartnerId**;均未传则不按门店范围收窄(仍返回全部未删除模板,除非前端传了无效 Id 则返回空列表)。
+
+### 出参(`PagedResultWithPageDto`)
+
+| 字段 | 说明 |
+|------|------|
+| `pageIndex` | 当前页码 |
+| `pageSize` | 每页条数 |
+| `totalCount` | 总条数 |
+| `totalPages` | 总页数 |
+| `items[]` | 模板列表 |
+
+**`items[]` 主要字段**
+
+| 字段 | 说明 |
+|------|------|
+| `id` / `templateCode` | 模板编码(前端主键) |
+| `templateName` | 模板名称 |
+| `company` / `region` / `location` | 适用范围展示;未迁移 scope 库时 Company/Region 为 `All Companies` / `All Regions` |
+| `partnerIds` / `regionIds` / `locationIds` | 对应 Id 数组 |
+| `items` / `itemNames` | 模板内控件名称 |
+| `contentsCount` | 控件数量 |
+| `sizeText` | 如 `2x2inch` |
+| `lastEdited` | 最近编辑时间(`LastModificationTime ?? CreationTime`) |
+
+---
+
+## 五、请求示例
+
+### 登录获取 Token
+
+```bash
+curl -X POST "http://flus-test.3ffoodsafety.com/api/oauth/Login" \
+ -H "Content-Type: application/x-www-form-urlencoded" \
+ -d "userName=admin&password=123456"
+```
+
+### 列表(第一页,默认排序)
+
+```bash
+curl -G "http://flus-test.3ffoodsafety.com/api/app/label-template" \
+ -H "Authorization: Bearer {token}" \
+ --data-urlencode "SkipCount=1" \
+ --data-urlencode "MaxResultCount=10"
+```
+
+### 带 Company 筛选
+
+```bash
+curl -G "http://flus-test.3ffoodsafety.com/api/app/label-template" \
+ -H "Authorization: Bearer {token}" \
+ --data-urlencode "SkipCount=1" \
+ --data-urlencode "MaxResultCount=10" \
+ --data-urlencode "PartnerId={fl_partner.Id}"
+```
+
+### 指定排序
+
+```bash
+curl -G "http://flus-test.3ffoodsafety.com/api/app/label-template" \
+ -H "Authorization: Bearer {token}" \
+ --data-urlencode "SkipCount=1" \
+ --data-urlencode "MaxResultCount=10" \
+ --data-urlencode "Sorting=TemplateName asc"
+```
+
+### 响应片段(示例)
+
+```json
+{
+ "pageIndex": 1,
+ "pageSize": 10,
+ "totalCount": 3,
+ "totalPages": 1,
+ "items": [
+ {
+ "id": "tpl_n0b5h9_mpyssitm",
+ "templateCode": "tpl_n0b5h9_mpyssitm",
+ "templateName": "Retail Label w/Price Copy",
+ "company": "All Companies",
+ "region": "All Regions",
+ "location": "Ordos Airport, Store B",
+ "items": "Label Name, Price, Barcode",
+ "contentsCount": 5,
+ "sizeText": "2x2inch",
+ "lastEdited": "2026-06-04T08:30:00"
+ }
+ ]
+}
+```
+
+---
+
+## 六、验证步骤
+
+0. **重新编译并重启**(必做):
+ ```bash
+ cd "美国版/Food Labeling Management Code/Yi.Abp.Net8/src/Yi.Abp.Web"
+ dotnet build
+ ```
+ 停止正在运行的 Web 进程后重新启动;确认 Yi-SQL 中 **不再出现** `AppliedPartnerType`。
+
+1. **部署**包含 6-17 + 6-18 的后端并重启。
+2. 调用 `GET /api/app/label-template?SkipCount=1&MaxResultCount=10` → 应 **200**,`totalCount >= 0`。
+3. Web **Label Templates** 列表可加载,不再出现红色 **Failed to load label templates**。
+4. 传无效 `PartnerId` / `GroupId` → **200** 且 `items=[]`(非 500)。
+5. 不传 `Sorting` → 按最近编辑时间降序;传 `Sorting=TemplateName asc` → 按名称升序。
+6. 分页:第 2 页 `SkipCount=2`,`totalCount` 与 UI 一致。
+
+### SQL 抽查(修复后 ORM 应生成的列)
+
+```sql
+SELECT Id, TemplateCode, TemplateName, AppliedLocationType,
+ IFNULL(LastModificationTime, CreationTime) AS LastEdited
+FROM fl_label_template
+WHERE IsDeleted = 0
+ORDER BY IFNULL(LastModificationTime, CreationTime) DESC, TemplateCode ASC
+LIMIT 10;
+```
+
+**不应再出现** `AppliedPartnerType` / `AppliedRegionType`。
+
+### 检查 scope 是否已迁移
+
+```sql
+SELECT COUNT(*) AS scope_table_cnt
+FROM information_schema.TABLES
+WHERE TABLE_SCHEMA = DATABASE()
+ AND TABLE_NAME IN ('fl_label_template_partner', 'fl_label_template_region');
+```
+
+`scope_table_cnt = 0` 时行为与 6-17 一致:仅 Location 维度落库与展示。
+
+---
+
+## 七、涉及代码
+
+| 文件 | 说明 |
+|------|------|
+| `Helpers/LabelTemplateQueryHelper.cs` | **新增** `ProjectListColumns` 强制 SQL 列白名单 |
+| `Services/DbModels/FlLabelTemplateDbEntity.cs` | **移除** Partner/Region 列属性 |
+| `Helpers/LabelTemplateScopeSchemaHelper.cs` | 列/表探测 + `SetAppliedScopeTypesAsync` raw SQL |
+| `Services/LabelTemplateAppService.cs` | 安全排序、Create/Update 写 scope 列、列表健壮性 |
+| `Helpers/LabelTemplateScopeHelper.cs` | 未迁移库 scope 过滤/展示(6-17) |
+| `Helpers/LocationScopeBindingHelper.cs` | `ResolveFilteredLocationIdsForListAsync` |
+| `Helpers/LabelTemplateListItemsHelper.cs` | Items 列 |
+| `Dtos/LabelTemplate/LabelTemplateGetListInputVo.cs` | `PartnerId` 筛选 |
+
+---
+
+## 八、数据库迁移(可选)
+
+需完整 Company / Region 三维 scope 时,执行:
+
+`美国版/Food Labeling Management Code/Yi.Abp.Net8/module/food-labeling-us/scripts/fl_label_template_scope.sql`
+
+未执行前:**列表可正常返回**(6-17 + 6-18),但无法持久化 Company/Region 多选明细。
+
+---
+
+## 九、App 标签预览 `POST /api/app/us-app-labeling/preview`
+
+### 现象
+
+App 标签预览页调用 preview 失败(500 或 400),常与 **label-template 列表** 同源:加载模板头时 ORM 仍 SELECT 不存在的 `AppliedPartnerType` / `AppliedRegionType`。
+
+另有两项逻辑缺陷(与 `6-11` 文档不一致):
+
+| # | 问题 | 后果 |
+|---|------|------|
+| 1 | `LabelAppService.PreviewAsync` 全表查询 `FlLabelTemplateDbEntity` | 未迁移 scope 列时 **Unknown column** → 500 |
+| 2 | `UsAppLabelingAppService.PreviewAsync` 未向 `_labelAppService.PreviewAsync` 传 **`locationId`** | 模板含 Company 自动生成元素时报 **「预览/打印需要 locationId 以填充 Company 信息」** |
+| 3 | 出参 **`labelId`** 仍返回 `fl_label.Id`(GUID) | 与 Print Log 当日序号 `yyyyMMdd-n` 不一致 |
+
+### 修复说明
+
+| 改动 | 说明 |
+|------|------|
+| `LabelAppService.PreviewAsync` | 模板头查询改用 `LabelTemplateQueryHelper.ProjectListColumns` |
+| `UsAppLabelingAppService.PreviewAsync` | 传入 `LocationId`;`labelId` 改用 `ReportsPrintLogDailyLabelIdHelper.ResolveNextDailyLabelIdAsync` |
+| `UsAppLabelingAppService.PrintAsync` | 解析模板时同步传入 `LocationId`(打印与预览 Company 填充一致) |
+| `DashboardAppService` | 模板统计 Count 同样走 `ProjectListColumns` |
+
+### 接口说明
+
+| 项目 | 内容 |
+|------|------|
+| 方法 | `POST` |
+| 路径 | `/api/app/us-app-labeling/preview` |
+| 鉴权 | App Bearer Token |
+
+#### 入参(Body:`UsAppLabelPreviewInputVo`)
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `locationId` | string | 是 | 当前门店 Id(`location.Id`) |
+| `labelCode` | string | 是 | 标签编码(`fl_label.LabelCode`) |
+| `productId` | string | 否 | 预览产品 Id;不传则取标签绑定第一个产品 |
+| `baseTime` | DateTime | 否 | 日期/时间控件基准;也用于计算当日 `labelId` 序号;未传为服务器当前时间 |
+| `printInputJson` | object | 否 | `PRINT_INPUT` 元素用户输入 |
+
+#### 出参(`UsAppLabelPreviewDto`)
+
+| 字段 | 说明 |
+|------|------|
+| **`labelId`** | 门店当日**下一个**打印序号 `yyyyMMdd-n`(预览不落库) |
+| `locationId` / `labelCode` | 回传入参 |
+| `template` | 已解析 AUTO_DB / PRINT_INPUT 的模板结构(含 Company 自动填充) |
+| `labelLastEdited` | 标签最近编辑时间 |
+| 其它 | `typeName`、`productName`、`templateProductDefaultValues` 等 |
+
+#### `labelId` 规则
+
+与 `6-11`、`get-print-log-list` 一致:`{baseTime 日期 yyyyMMdd}-{当日已有打印任务数 + 1}`。
+
+#### Company 自动元素
+
+模板含 Company 自动生成控件时,后端根据 **`locationId`** 查 `fl_partner` 填充 `config.text`(详见 `6-11` 第二节)。
+
+### 请求示例
+
+```bash
+curl -X POST "http://flus-test.3ffoodsafety.com/api/app/us-app-labeling/preview" \
+ -H "Authorization: Bearer {token}" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "locationId": "550e8400-e29b-41d4-a716-446655440000",
+ "labelCode": "LBL0001",
+ "productId": "PROD001",
+ "baseTime": "2026-06-18T09:00:00"
+ }'
+```
+
+### 响应片段(示例)
+
+```json
+{
+ "labelId": "20260618-3",
+ "locationId": "550e8400-e29b-41d4-a716-446655440000",
+ "labelCode": "LBL0001",
+ "labelLastEdited": "2026-06-01T08:30:09",
+ "template": {
+ "id": "tpl_xxx",
+ "width": 2,
+ "height": 2,
+ "unit": "inch",
+ "elements": []
+ }
+}
+```
+
+### 验证步骤
+
+1. 停服 → `dotnet build` → 重启(同 label-template 一节)。
+2. App 进入标签预览页,Network 中 preview 应 **200**。
+3. 响应 `labelId` 为 `yyyyMMdd-n`,非 GUID。
+4. 模板含 Company 元素时,`template.elements` 中对应 `config.text` 为门店所属公司名。
+5. 当日已有 N 条打印任务时,preview 返回 `-{N+1}`。
+
+### 涉及代码(preview)
+
+| 文件 | 说明 |
+|------|------|
+| `Services/UsAppLabelingAppService.cs` | `PreviewAsync` / `PrintAsync` 传 `LocationId`、当日 `labelId` |
+| `Services/LabelAppService.cs` | `PreviewAsync` 模板头 `ProjectListColumns` |
+| `Helpers/LabelTemplateQueryHelper.cs` | 列投影 |
+| `Helpers/ReportsPrintLogDailyLabelIdHelper.cs` | `ResolveNextDailyLabelIdAsync` |
+| `Helpers/PartnerCompanyDisplayHelper.cs` | Company 自动填充 |
+
+---
+
+## 十、App 打印日志 `POST /api/app/us-app-labeling/get-print-log-list`
+
+### 现象
+
+Postman 传 `printDate: "2026-06-16"` 返回 `totalCount: 0`,误以为接口异常。
+
+### 根因(查库核对)
+
+门店 `3a218397-8dda-a378-e024-ef89bcef8d24` 在测试库中:
+
+| 自然日(`DATE(IFNULL(PrintedAt, CreationTime))`) | 记录数 |
+|---------------------------------------------------|--------|
+| `2026-06-01` | **7** |
+| `2026-05-31` | **3** |
+| `2026-06-16` | **0** |
+
+**接口按入参日期筛选时,该日无数据则返回空列表,行为正确。** 文档/示例误用 `2026-06-16`,应改用 **`2026-06-01`** 验证。
+
+另:`PrintedAt` 入库多为 `null`,筛选实际走 **`CreationTime`**。
+
+### 本轮修复
+
+| 改动 | 说明 |
+|------|------|
+| 日期条件 | 改用 MySQL `DATE(IFNULL(t.PrintedAt, t.CreationTime)) = 'yyyy-MM-dd'`,避免 DateTime 区间比较时区偏差 |
+| `printDateDay` | 新增字符串入参(`yyyy-MM-dd`),优先于 `printDate`,避免 JSON 仅日期 UTC 歧义 |
+| 未传日期 | **`printDate` 与 `printDateDay` 均未传时不按日过滤**(返回该门店全部打印记录,兼容 App 未传参) |
+| `labelId` | 列表出参改为当日序号 `yyyyMMdd-n`;`labelEntityId` 为 `fl_label.Id` |
+
+### 请求示例(有数据的日期)
+
+```bash
+curl -X POST "http://192.168.1.4:19001/api/app/us-app-labeling/get-print-log-list" \
+ -H "Authorization: Bearer {token}" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "locationId": "3a218397-8dda-a378-e024-ef89bcef8d24",
+ "skipCount": 1,
+ "maxResultCount": 20,
+ "printDateDay": "2026-06-01"
+ }'
+```
+
+或使用 `"printDate": "2026-06-01"`(等价)。
+
+### 权限说明
+
+非 admin / 非 Partner 角色时,仅返回 **`CreatedBy = 当前用户`** 的记录;若 Token 用户不是打印人,即使日期正确也会空列表。
+
+### 部署
+
+修改在 `FoodLabeling.Application`,需 **停服 → dotnet build → 重启** 后 Postman 才生效。
+
+### 涉及代码
+
+| 文件 | 说明 |
+|------|------|
+| `Helpers/ReportsPrintLogDailyLabelIdHelper.cs` | `ResolvePrintLogFilterCalendarDay`、`ApplyPrintTaskCalendarDayFilter` |
+| `Dtos/UsAppLabeling/PrintLogGetListInputVo.cs` | `PrintDateDay` |
+| `Services/UsAppLabelingAppService.cs` | `GetPrintLogListAsync` |
+
+---
+
+## 十一、角色编辑 `PUT /api/app/rbac-role/{id}` — accessPermissions
+
+### 现象
+
+编辑角色传 `"accessPermissions": "[\"manage_labels\"]"` 后权限未生效或菜单绑定被清空。
+
+### 根因
+
+前端/Web 约定 `accessPermissions` 为 **JSON 数组字符串**(见 `rbacRoleService.ts` 的 `JSON.stringify(codes)`),后端 `ParseAccessPermissionCodes` 原先仅按逗号拆分,整段 `["manage_labels"]` 被当成一个非法 token,`NormalizeAccessPermissionCodes` 过滤后为空 → **RoleMenu 被清空**。
+
+### 修复
+
+`RbacAccessPermissionHelper.ParseAccessPermissionCodes`:若字符串以 `[` 开头,先 `JsonSerializer.Deserialize>`,再回退逗号分隔。
+
+### 合法 accessPermissions 值
+
+| 编码 | 说明 |
+|------|------|
+| `manage_labels` | 标签相关菜单(/labeling、/labels 等) |
+| `manage_people` | 账号管理 |
+| `edit_settings` | 菜单/多选项设置 |
+| `view_reports` | 报表 |
+| `manage_products` / `approve_batches` | 当前无独立菜单,不阻断其它权限 |
+
+### 请求示例
+
+```json
+{
+ "roleName": "Staff",
+ "roleCode": "Staff",
+ "remark": null,
+ "dataScope": 0,
+ "state": true,
+ "orderNum": 0,
+ "accessPermissions": "[\"manage_labels\"]"
+}
+```
+
+亦可传 `"accessPermissionCodes": ["manage_labels"]`(与 `accessPermissions` 合并去重)。
+
+### 涉及代码
+
+| 文件 | 说明 |
+|------|------|
+| `Helpers/RbacAccessPermissionHelper.cs` | JSON 数组解析 |
+| `Helpers/RoleAccessPermissionMenuMapping.cs` | UI 权限码 → Menu.Router |
+| `Services/RbacRoleAppService.cs` | `UpdateAsync` / `ApplyRoleMenuBindingsAsync` |
+
+---
+
+## 十二、Team Member — Company Admin 范围绑定
+
+### 规则
+
+角色为 **Company Admin**(库内常为 **Partner Admin**,或 RoleCode 含 `partner`)时:
+
+| 字段 | 是否必填 | 说明 |
+|------|----------|------|
+| `partnerId` / `partnerIds` | **是** | 指定适用 Company |
+| `regionIds` | **否** | 未传时后端自动绑定该公司下**全部 Region**(出参展示) |
+| `locationIds` / `assignedLocations` | **否** | 未传时后端自动绑定该公司下**全部门店** 并写入 `userlocation` |
+
+其它角色仍须 Company / Region / 门店至少一项能解析出门店。
+
+### 请求示例(Create / Update)
+
+```json
+{
+ "fullName": "Jane Doe",
+ "userName": "jane.doe",
+ "password": "123456",
+ "email": "jane@example.com",
+ "roleId": "{Partner Admin 角色 Guid}",
+ "partnerId": "{fl_partner.Id}",
+ "state": true
+}
+```
+
+无需传 `regionIds`、`locationIds`。
+
+### 列表出参
+
+`GET /api/app/team-member` 对 Company Admin 成员:
+
+- `roleName` 统一为 **Company Admin**(库内 Partner Admin 也会转换)
+- `regionIds` 展示该公司下**全部 Region**
+- `assignedLocations` 展示该公司下**全部门店**(无需前端再选手动 Region/Locations)
+
+### 编辑弹窗(Web)
+
+选 **Company Admin** 时隐藏 Region / Locations 字段,仅保留 **Company**;保存时只传 `partnerId`,后端自动展开绑定。
+
+### 涉及代码
+
+| 文件 | 说明 |
+|------|------|
+| `Helpers/TeamMemberRoleHelper.cs` | Company Admin 角色识别 |
+| `Helpers/LocationScopeBindingHelper.cs` | `ResolveGroupIdsFromPartnerIdsAsync` |
+| `Services/TeamMemberAppService.cs` | 保存/列表/详情 scope 逻辑 |
+| `PeopleView.tsx` | 前端 Company Admin 放宽 Region/Locations 必填 |
+
+---
+
+## 十三、Team Member 批量导入 / PDF 导出 — Region 列
+
+### 模板列(下载 `download-team-member-import-template`)
+
+| 列 | 必填 | 说明 |
+|----|------|------|
+| Name / Email / Role Name | 是 | 与单条创建一致 |
+| **Region** | **否** | 可留空;填 `fl_group.Id` 或 Region 名称(GroupName),多个用 `;` 分隔 |
+| **Assigned Location Ids** | **否*** | 与 Region **至少填一项**;见下 |
+
+\* Company Admin 在 Web 端可只选 Company;Excel 批量导入仍须 Region 或门店至少一项(或后续扩展 Company 列)。
+
+### Assigned Location Ids 填什么?
+
+**优先填 `location.LocationCode`(门店编码)**,例如 `LOC001`、`33333`。
+
+也支持:
+
+- **`location.Id`(Guid 字符串)**
+- **`编码 - 门店名`** 格式(取 ` -` 前一段作为编码或 Guid)
+
+模板示例 `LOC001;LOC002` 即为 **LocationCode**,不是 Guid。
+
+### 涉及代码
+
+| 文件 | 说明 |
+|------|------|
+| `Helpers/TeamMemberBatchExcelHelper.cs` | Region 列解析、`BuildImportTemplateWorkbook` |
+| `Services/TeamMemberAppService.cs` | 导入解析 Region/Location、PDF 增 Region 列 |
+
+---
+
+## 十四、Team Member 列表只返回 1 条(应 3 条)
+
+### 现象
+
+`GET /api/app/team-member?SkipCount=1&MaxResultCount=10` 在 Subway China 下应返回 **123 / Sandi / Tom** 共 3 人,实际 `totalCount=1`。
+
+### 根因
+
+1. **Guid 字符串大小写不一致**:`userlocation.UserId` / `LocationId` 与 `User.Id.ToString()` 比较时用字符串 `Contains`,大小写不同会漏关联,导致成员 scope 命中失败、`assignedLocations` 为空。
+2. **前端未传 `PartnerId`**:筛选 Company 时只靠客户端二次过滤,且 `locationIds` 为空时被误过滤。
+3. **列表出参缺 `locationIds`**:前端无法正确做门店 scope 匹配。
+
+### 修复
+
+| 改动 | 说明 |
+|------|------|
+| `TeamMemberListScopeHelper` | 统一 `NormalizeScopeKey` / `UserKey`,用 **Guid** 比较 |
+| `BuildFilteredUserQueryAsync` | 按 Guid 解析 scope 与 userlocation |
+| `MapUsersToOutputAsync` | assignedMap 用规范化 userKey;出参增加 **`locationIds`** |
+| 前端 `getTeamMembers` | 传 **`PartnerId` / `GroupId`** |
+| `memberMatchesLocationScope` | 支持 **partnerIds** 匹配 + locationId 小写归一 |
+
+### 验证(测试库 Subway China)
+
+| 用户 | 应出现在 Subway 范围列表 |
+|------|--------------------------|
+| 123 / Sandi / Tom | 是 |
+| Nancy Lang(GongCha) | 否 |
+| admin | 仅平台管理员无筛选时可见 |
+
+---
+
+## 十五、Region(Group)列表 Company Admin 只返回 1 条
+
+### 现象
+
+`GET /api/app/group?SkipCount=1&MaxResultCount=10&Sorting=CreationTime+desc` 以 **Company Admin(Subway China / 用户 123)** 登录时,`totalCount=1`,仅 **Subway Beijing**;测试库 Subway China 下应有 **Beijing / Chendu / Shanghai** 共 3 条。
+
+### 根因
+
+`PartnerScopeHelper.ResolveGroupScopeAsync` 对非管理员按 **userlocation 绑定的门店** 推导 Region:只匹配 `location.Partner + location.GroupName` 对应的 `fl_group`。用户 123 仅绑定了 Beijing 门店,因此 scope 只有 **Subway Beijing** 一条,未展开到公司下全部 Region。
+
+### 修复
+
+| 文件 | 说明 |
+|------|------|
+| `Helpers/LocationScopeBindingHelper.cs` | 新增 `ResolveBoundLocationIdsForUserAsync`、`ResolveDisplayRegionIdsForUserAsync`(与 Team Member 详情 `regionIds` 同规则) |
+| `Helpers/PartnerScopeHelper.cs` | `ResolveGroupScopeAsync` 改为调用上述方法;`ApplyGroupScope` 用 Guid 比较;`ResolvePartnerScopeAsync` 统一 Guid 读 `userlocation` |
+
+### 验证
+
+- 用户 **123**(Company Admin)→ `totalCount=3`,`items` 与编辑接口 `regionIds` 三条一致
+- 平台 **admin** → 全部 4 条
+- **SkipCount=1** 表示第一页(页码从 1 起),不是 offset
+
+---
+
+## 关联文档
+
+- App Preview labelId / Company:`项目相关文档/6-11代码优化.md`
+- 第一轮 scope 兼容:`项目相关文档/6-17代码优化.md`(第一节、第二节 get-print-log-list)
+- 三维 scope 业务规则:`项目相关文档/6-4代码优化.md`
+- 分页约定:`Helpers/PagedQueryConvention.cs`
diff --git a/项目相关文档/Account-Management-批量导入模板/Team-Member-批量导入模板.csv b/项目相关文档/Account-Management-批量导入模板/Team-Member-批量导入模板.csv
index 32ae262..86ba811 100644
--- a/项目相关文档/Account-Management-批量导入模板/Team-Member-批量导入模板.csv
+++ b/项目相关文档/Account-Management-批量导入模板/Team-Member-批量导入模板.csv
@@ -1,3 +1,3 @@
-Name,User Name (Login),Password,Email,Phone,Role Id,Role Name (仅说明勿删),Assigned Location Ids,Status
-John Doe,john.doe,ChangeMe123!,john@123.com,789654444,"(必填)从系统角色列表复制 Role Id","Staff","门店Guid1;门店Guid2",TRUE
+Name,User Name,Password,Email,Phone,Role Id,Role Name,Region,Assigned Location Ids,Status
+John Doe,john.doe,ChangeMe123!,john@example.com,789654444,,Staff,,LOC001;LOC002,TRUE
,,,,,,,,,
diff --git a/项目相关文档/批量导入导出接口说明.md b/项目相关文档/批量导入导出接口说明.md
index 83e9853..453c539 100644
--- a/项目相关文档/批量导入导出接口说明.md
+++ b/项目相关文档/批量导入导出接口说明.md
@@ -178,7 +178,7 @@
| 数据范围 | **全量**:符合筛选条件的全部成员;**不使用** `SkipCount` / `MaxResultCount` |
| 排序 | 有 `Sorting` 则按其排序,否则按创建时间降序 |
| 响应 | `Content-Type: application/pdf`,文件名示例 `team-members_yyyy-MM-dd_HH-mm-ss.pdf` |
-| PDF 列 | Name、Email、Phone、Role、Assigned Locations(多门店以分号拼接)、Status(Active/Inactive) |
+| PDF 列 | Name、Email、Phone、Role、**Region**、Assigned Locations(多门店以分号拼接)、Status(Active/Inactive) |
**说明**:PDF 中「Assigned Locations」展示该成员**全部**已分配门店(不受列表按门店筛选时「仅显示命中门店」的收缩影响),便于导出后审阅完整权限。
@@ -195,10 +195,14 @@
**表头识别(摘要)**
-- **必填列**:`Name`(或 FullName)、`Email`;**Role**;**Assigned Locations**(至少一条)。
-- **可选列**:`UserName` / `Login`(不填则登录账号用 Email)、`Password`(不填则用配置 **`TeamMemberImportDefaultPassword`**)、`Phone`、`Status`。
-- **Assigned Locations**:多个门店可用 **`;`**、`|`、换行、中文 **`,`** 分隔;支持 `33333 - Central Park Store`(取 **` -`** 前为门店编码或 Guid)。
-- **Role**:与系统 **`Role.RoleName`** 一致(忽略大小写与中间空格);未匹配则该行失败。
+- **必填列**:`Name`(或 FullName)、`Email`;**Role Name**(或 **Role Id** Guid);**Region** 与 **Assigned Location Ids** **至少填一项**(均可留空仅适用于 Web 已支持的 Company Admin + Company 场景)。
+- **可选列**:`User Name` / `Login`(不填则登录账号用 Email)、`Password`(不填则用配置 **`TeamMemberImportDefaultPassword`**)、`Phone`、`Status`、**`Region`**(可留空)。
+- **Region**:多个可用 **`;`**、`|`, 换行分隔;支持 **`fl_group.Id`(Guid)** 或 **Region 名称(GroupName)**;仅填 Region 时会绑定该区域下全部门店。
+- **Assigned Location Ids**:多个可用 **`;`**、`|`, 换行、中文 **`,`** 分隔;支持 **`location.LocationCode`(门店编码,推荐)** 或 **`location.Id`(Guid)**;亦支持 `LOC001 - Store Name`(取 **` -`** 前为编码或 Guid)。
+- **Role**:与系统 **`Role.RoleName`** 一致(忽略大小写与中间空格);或填 **Role Id**(Guid)。
+- 下载模板由服务端 **动态生成**(含 **Region** 列),不再依赖服务器目录中的静态 xlsx。
+
+**PDF 导出列**:Name、Email、Phone、Role、**Region**、Assigned Locations、Status。
内部对每行调用与单条创建相同的业务逻辑;**单行失败不影响其它行**。