瀏覽代碼

feat(s5): 生产领料单占位页改真实只读列表(数据中台标准层 mdp_std_production_issue)

S5-PRODUCTION-MATERIAL-ISSUE-READONLY-LIST-1

- 源 aidopdev NbrMaster Type='SM'(只读)→ mdp_std_production_issue(头级 typed,不建 stg/明细/dwd)
- 新增 ProductionIssueService(/api/ProductionIssue/list 只读分页查询)+ ProductionIssueMdpSyncService(全量同步转换,不写源)
- AidopKanbanController 新增 s5-production-issue-mdp/refresh 手动刷新端点
- 菜单 Id=1329015020003 由占位重指 /aidop/s5/warehouse/productionIssueList
- 只读:无新增/编辑/发料/库存事务/状态流转;租户隔离沿用既有 tenant_id 机制

chore: bump version Web 2.4.260 / server 1.0.267
YY968XX 2 周之前
父節點
當前提交
9e7f6e3e9a

+ 1 - 1
Web/package.json

@@ -1,7 +1,7 @@
 {
   "name": "admin.net",
   "type": "module",
-  "version": "2.4.259",
+  "version": "2.4.260",
   "packageManager": "pnpm@10.32.1",
   "lastBuildTime": "2026.03.15",
   "description": "Admin.NET 站在巨人肩膀上的 .NET 通用权限开发框架",

+ 42 - 0
Web/src/views/aidop/s5/api/productionIssue.ts

@@ -0,0 +1,42 @@
+import service from '/@/utils/request';
+import { withAidopTenantParams } from '../../api/aidopTenant';
+
+export interface Paged<T> {
+	total: number;
+	page: number;
+	pageSize: number;
+	list: T[];
+}
+
+// ── S5 生产领料单(只读,数据中台标准层 mdp_std_production_issue)──
+export interface ProductionIssueRow {
+	id?: number;
+	/** 领料单号 nbr */
+	nbr?: string;
+	/** 领料日期 issue_date */
+	issueDate?: string;
+	/** 状态中文 status_desc */
+	statusDesc?: string;
+	/** SAP单号/工单号 work_ord */
+	workOrd?: string;
+	/** 部门 department + department_desc */
+	departmentDesc?: string;
+	/** 生产线 prod_line */
+	prodLine?: string;
+	/** 需求数量 qty_ord */
+	qtyOrd?: number;
+	/** 领料人 issue_user */
+	issueUser?: string;
+	/** 备注 remark */
+	remark?: string;
+	/** 创建用户 create_user */
+	createUser?: string;
+	/** 创建时间 source_create_time */
+	createTime?: string;
+}
+
+export function fetchProductionIssueList(params: any) {
+	return service
+		.get<Paged<ProductionIssueRow>>('/api/ProductionIssue/list', { params: withAidopTenantParams(params) })
+		.then((r) => r.data);
+}

+ 187 - 0
Web/src/views/aidop/s5/warehouse/productionIssueList.vue

@@ -0,0 +1,187 @@
+<template>
+	<AidopDemoShell :title="pageTitle" subtitle="FUNC-S5-005 · 只读列表">
+		<!--
+			S5 生产领料单 · 只读页(S5-PRODUCTION-MATERIAL-ISSUE-READONLY-LIST-1)。
+			数据源:DOP 数据中台标准层 mdp_std_production_issue(由 NbrMaster Type='SM' 同步标准化)。
+			只读:无新增/编辑/保存/发料确认/库存事务/状态流转/明细/导出。真实接口数据,无 mock。
+		-->
+		<el-form :inline="true" :model="query" class="mb12" @submit.prevent>
+			<el-form-item label="领料单号">
+				<el-input v-model="query.nbr" clearable style="width: 180px" />
+			</el-form-item>
+			<el-form-item label="SAP单号">
+				<el-input v-model="query.workOrd" clearable style="width: 180px" />
+			</el-form-item>
+			<el-form-item label="状态">
+				<el-input v-model="query.status" clearable style="width: 120px" />
+			</el-form-item>
+			<el-form-item label="生产线">
+				<el-input v-model="query.prodLine" clearable style="width: 140px" />
+			</el-form-item>
+			<el-form-item label="领料日期">
+				<el-date-picker
+					v-model="dateRange"
+					type="daterange"
+					value-format="YYYY-MM-DD"
+					range-separator="-"
+					start-placeholder="开始日期"
+					end-placeholder="结束日期"
+					unlink-panels
+					style="width: 260px"
+				/>
+			</el-form-item>
+			<el-form-item>
+				<el-button type="primary" @click="doSearch">查询</el-button>
+				<el-button @click="resetQuery">重置</el-button>
+			</el-form-item>
+		</el-form>
+
+		<el-table :data="rows" row-key="id" v-loading="loading" border stripe @sort-change="onSortChange">
+			<el-table-column type="index" label="#" width="60" align="center" />
+			<el-table-column prop="nbr" label="领料单号" min-width="170" sortable="custom" show-overflow-tooltip resizable />
+			<el-table-column prop="issueDate" label="领料日期" width="130" sortable="custom" resizable>
+				<template #default="{ row }">{{ fmtDate(row.issueDate) }}</template>
+			</el-table-column>
+			<el-table-column prop="statusDesc" label="状态" width="90" sortable="custom" resizable />
+			<el-table-column prop="workOrd" label="SAP单号" min-width="160" sortable="custom" show-overflow-tooltip resizable />
+			<el-table-column prop="departmentDesc" label="部门" min-width="140" show-overflow-tooltip resizable />
+			<el-table-column prop="prodLine" label="生产线" width="110" sortable="custom" resizable />
+			<el-table-column prop="qtyOrd" label="需求数量" width="120" align="right" resizable>
+				<template #default="{ row }">{{ fmtQty(row.qtyOrd) }}</template>
+			</el-table-column>
+			<el-table-column prop="issueUser" label="领料人" width="120" show-overflow-tooltip resizable />
+			<el-table-column prop="remark" label="备注" min-width="150" show-overflow-tooltip resizable />
+			<el-table-column prop="createUser" label="创建用户" width="120" resizable />
+			<el-table-column prop="createTime" label="创建时间" width="160" resizable>
+				<template #default="{ row }">{{ fmtDateTime(row.createTime) }}</template>
+			</el-table-column>
+			<template #empty>
+				<el-empty description="暂无数据" />
+			</template>
+		</el-table>
+
+		<div class="pager">
+			<el-pagination
+				v-model:current-page="query.page"
+				v-model:page-size="query.pageSize"
+				:total="total"
+				:page-sizes="[10, 20, 50]"
+				layout="total, sizes, prev, pager, next"
+				@current-change="loadList"
+				@size-change="loadList"
+			/>
+		</div>
+	</AidopDemoShell>
+</template>
+
+<script setup lang="ts" name="aidopS5WarehouseProductionIssue">
+import { computed, onActivated, onMounted, reactive, ref } from 'vue';
+import { useRoute } from 'vue-router';
+import { ElMessage } from 'element-plus';
+import AidopDemoShell from '/@/views/aidop/components/AidopDemoShell.vue';
+import { fetchProductionIssueList, type ProductionIssueRow } from '../api/productionIssue';
+
+const route = useRoute();
+const pageTitle = computed(() => (route.meta?.title as string) || '生产领料单');
+
+const query = reactive({
+	nbr: '',
+	workOrd: '',
+	status: '',
+	prodLine: '',
+	dateFrom: '',
+	dateTo: '',
+	page: 1,
+	pageSize: 10,
+	orderBy: '',
+	orderDir: '',
+});
+const dateRange = ref<[string, string] | null>(null);
+
+const loading = ref(false);
+const rows = ref<ProductionIssueRow[]>([]);
+const total = ref(0);
+
+function fmtDate(v?: string | null) {
+	if (!v) return '';
+	return String(v).slice(0, 10);
+}
+function fmtDateTime(v?: string | null) {
+	if (!v) return '';
+	const s = String(v);
+	return s.length > 19 ? s.slice(0, 19).replace('T', ' ') : s.replace('T', ' ');
+}
+function fmtQty(v?: number | null) {
+	if (v === null || v === undefined || v === ('' as any)) return '';
+	const n = Number(v);
+	if (Number.isNaN(n)) return '';
+	return n.toLocaleString('en-US', { maximumFractionDigits: 5 });
+}
+
+function onSortChange({ prop, order }: { prop: string; order: string | null }) {
+	query.orderBy = prop || '';
+	query.orderDir = order === 'ascending' ? 'asc' : order === 'descending' ? 'desc' : '';
+	loadList();
+}
+
+async function loadList() {
+	loading.value = true;
+	try {
+		query.dateFrom = dateRange.value?.[0] || '';
+		query.dateTo = dateRange.value?.[1] || '';
+		const data = await fetchProductionIssueList({
+			nbr: query.nbr,
+			workOrd: query.workOrd,
+			status: query.status,
+			prodLine: query.prodLine,
+			dateFrom: query.dateFrom,
+			dateTo: query.dateTo,
+			page: query.page,
+			pageSize: query.pageSize,
+			orderBy: query.orderBy,
+			orderDir: query.orderDir,
+		});
+		rows.value = data.list || [];
+		total.value = data.total || 0;
+	} catch (e: any) {
+		rows.value = [];
+		total.value = 0;
+		ElMessage.error(e?.message || '加载生产领料单列表失败');
+	} finally {
+		loading.value = false;
+	}
+}
+
+function doSearch() {
+	query.page = 1;
+	loadList();
+}
+
+function resetQuery() {
+	query.nbr = '';
+	query.workOrd = '';
+	query.status = '';
+	query.prodLine = '';
+	dateRange.value = null;
+	query.dateFrom = '';
+	query.dateTo = '';
+	query.page = 1;
+	query.orderBy = '';
+	query.orderDir = '';
+	loadList();
+}
+
+onMounted(() => loadList());
+onActivated(() => loadList());
+</script>
+
+<style scoped lang="scss">
+.mb12 {
+	margin-bottom: 12px;
+}
+.pager {
+	margin-top: 12px;
+	display: flex;
+	justify-content: flex-end;
+}
+</style>

+ 6 - 3
server/Admin.NET.Web.Entry/Admin.NET.Web.Entry.csproj

@@ -11,9 +11,9 @@
     <GenerateSatelliteAssembliesForCore>true</GenerateSatelliteAssembliesForCore>
     <Copyright>Admin.NET</Copyright>
     <Description>Admin.NET ͨ��Ȩ�޿���ƽ̨</Description>
-    <AssemblyVersion>1.0.266</AssemblyVersion>
-    <FileVersion>1.0.266</FileVersion>
-    <Version>1.0.266</Version>
+    <AssemblyVersion>1.0.267</AssemblyVersion>
+    <FileVersion>1.0.267</FileVersion>
+    <Version>1.0.267</Version>
   </PropertyGroup>
 
   <ItemGroup>
@@ -223,6 +223,9 @@
     <None Update="UpdateScripts\1.0.266.sql">
       <CopyToOutputDirectory>Always</CopyToOutputDirectory>
     </None>
+    <None Update="UpdateScripts\1.0.267.sql">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </None>
   </ItemGroup>
 
   <ItemGroup>

+ 64 - 0
server/Admin.NET.Web.Entry/UpdateScripts/1.0.267.sql

@@ -0,0 +1,64 @@
+-- ============================================================
+-- 1.0.267.sql
+-- S5-PRODUCTION-MATERIAL-ISSUE-READONLY-LIST-1
+--
+-- 业务目标:
+--   1) 新建 S5 生产领料单标准层头表(只读数据中台,DOP 内部):
+--      mdp_std_production_issue(头)  源 NbrMaster(Type='SM', IsActive=1)
+--      头级列表(一单一行),不建明细、不建 stg、不建 dwd;不读/不改 S3/S4;不写源表。
+--   2) 将「生产领料单」菜单(Id=1329015020003,仓储管理目录下)的 Component
+--      由 placeholder 重指到真实页面 /aidop/s5/warehouse/productionIssueList。
+--
+-- 安全保证:
+--   - DDL 仅 CREATE TABLE IF NOT EXISTS,幂等;不 DROP / TRUNCATE。
+--   - 菜单仅 UPDATE 该单条 Component / Remark / UpdateTime;不改 Path/Name/Pid/Title/Type/OrderNo;
+--     不 INSERT/DELETE;不动 SysTenantMenu / SysRoleMenu;不动其它菜单。
+--   - 不动源单据表(NbrMaster 等),不动 WorkOrderPickBillService 写路径,不碰 T8。
+-- ============================================================
+
+CREATE TABLE IF NOT EXISTS mdp_std_production_issue (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    tenant_id BIGINT NOT NULL DEFAULT 0,
+    factory_id BIGINT NULL DEFAULT 1,
+    source_system VARCHAR(50) NOT NULL DEFAULT 'AIDOP',
+    domain VARCHAR(80) NOT NULL,
+    rec_id INT NOT NULL,
+    nbr VARCHAR(24) NULL,
+    issue_date DATETIME NULL,
+    status VARCHAR(8) NULL,
+    status_desc VARCHAR(20) NULL,
+    work_ord VARCHAR(64) NULL,
+    department VARCHAR(8) NULL,
+    department_desc VARCHAR(255) NULL,
+    qty_ord DECIMAL(18,5) NULL DEFAULT 0,
+    prod_line VARCHAR(8) NULL,
+    applicant_name VARCHAR(12) NULL,
+    issue_user VARCHAR(255) NULL,
+    user1 TEXT NULL,
+    remark VARCHAR(200) NULL,
+    create_user VARCHAR(24) NULL,
+    source_create_time DATETIME NULL,
+    pretreatment_state VARCHAR(50) NULL,
+    trans_type VARCHAR(24) NULL,
+    trans_type_text VARCHAR(50) NULL,
+    eff_date DATETIME NULL,
+    address VARCHAR(120) NULL,
+    source_biz_key VARCHAR(200) NULL,
+    sync_batch_id VARCHAR(100) NOT NULL,
+    sync_time DATETIME NOT NULL,
+    create_time DATETIME DEFAULT CURRENT_TIMESTAMP,
+    update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_mdp_std_prod_issue (tenant_id, domain, rec_id),
+    KEY idx_mdp_std_prod_issue_nbr (tenant_id, nbr),
+    KEY idx_mdp_std_prod_issue_date (tenant_id, issue_date),
+    KEY idx_mdp_std_prod_issue_status (tenant_id, status),
+    KEY idx_mdp_std_prod_issue_workord (tenant_id, work_ord),
+    KEY idx_mdp_std_prod_issue_prodline (tenant_id, prod_line),
+    KEY idx_mdp_std_prod_issue_dept (tenant_id, department)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='S5生产领料单头标准层';
+
+UPDATE SysMenu
+SET Component  = '/aidop/s5/warehouse/productionIssueList',
+    Remark     = 'S5 生产领料单(只读列表,数据中台标准层 mdp_std_production_issue)',
+    UpdateTime = NOW()
+WHERE Id = 1329015020003;

+ 19 - 0
server/Plugins/Admin.NET.Plugin.AiDOP/Controllers/AidopKanbanController.cs

@@ -31,6 +31,7 @@ public partial class AidopKanbanController : ControllerBase
     private readonly OutsourceIssueMdpSyncService _outsourceIssueMdpSyncService;
     private readonly PurchaseReceiptMdpSyncService _purchaseReceiptMdpSyncService;
     private readonly ProductionReturnMdpSyncService _productionReturnMdpSyncService;
+    private readonly ProductionIssueMdpSyncService _productionIssueMdpSyncService;
     private readonly ProductionReceiptMdpSyncService _productionReceiptMdpSyncService;
     private readonly IpqcInspectionMdpSyncService _ipqcInspectionMdpSyncService;
     private readonly ReportWorkMdpSyncService _reportWorkMdpSyncService;
@@ -48,6 +49,7 @@ public partial class AidopKanbanController : ControllerBase
         OutsourceIssueMdpSyncService outsourceIssueMdpSyncService,
         PurchaseReceiptMdpSyncService purchaseReceiptMdpSyncService,
         ProductionReturnMdpSyncService productionReturnMdpSyncService,
+        ProductionIssueMdpSyncService productionIssueMdpSyncService,
         ProductionReceiptMdpSyncService productionReceiptMdpSyncService,
         IpqcInspectionMdpSyncService ipqcInspectionMdpSyncService,
         ReportWorkMdpSyncService reportWorkMdpSyncService)
@@ -64,6 +66,7 @@ public partial class AidopKanbanController : ControllerBase
         _outsourceIssueMdpSyncService = outsourceIssueMdpSyncService;
         _purchaseReceiptMdpSyncService = purchaseReceiptMdpSyncService;
         _productionReturnMdpSyncService = productionReturnMdpSyncService;
+        _productionIssueMdpSyncService = productionIssueMdpSyncService;
         _productionReceiptMdpSyncService = productionReceiptMdpSyncService;
         _ipqcInspectionMdpSyncService = ipqcInspectionMdpSyncService;
         _reportWorkMdpSyncService = reportWorkMdpSyncService;
@@ -648,6 +651,22 @@ LIMIT 60
         });
     }
 
+    /// <summary>
+    /// S5 生产领料单 数据中台只读链路手动刷新(DOP 内部头级:NbrMaster Type='SM' → mdp_std_production_issue)。
+    /// 独立于 s5-mdp/refresh 的 KPI 管线;只读源、只写 mdp_std 表;不建 stg/detail/dwd;不碰 WorkOrderPickBillService 写路径、S3/S4、T8;SM 为 0 行时成功、处理数 0。
+    /// </summary>
+    [HttpPost("s5-production-issue-mdp/refresh")]
+    public async Task<IActionResult> RefreshS5ProductionIssueMdp(CancellationToken cancellationToken)
+    {
+        var result = await _productionIssueMdpSyncService.RunFullAsync(cancellationToken, "MANUAL");
+        return Ok(new
+        {
+            ok = true,
+            batchId = result.BatchId,
+            headRows = result.HeadRows
+        });
+    }
+
     /// <summary>
     /// S5 生产入库单 数据中台只读链路手动刷新(DOP 内部扁平:NbrMaster/NbrDetail Type='WOI' → mdp_std_production_receipt)。
     /// 独立于 s5-mdp/refresh 的 KPI 管线;只读源、只写 mdp_std 表;不建 stg/dwd;不碰 S2 写路径、S7、S3/S4、T8;WOI 为 0 行时成功、处理数 0。

+ 82 - 0
server/Plugins/Admin.NET.Plugin.AiDOP/MaterialWarehouse/Dto/ProductionIssueDto.cs

@@ -0,0 +1,82 @@
+namespace Admin.NET.Plugin.AiDOP.MaterialWarehouse.Dto;
+
+/// <summary>
+/// 生产领料单列表 查询入参(只读)。读 mdp_std_production_issue。
+/// </summary>
+public class ProductionIssueListInput
+{
+    /// <summary>页码(从 1 开始)</summary>
+    public int Page { get; set; } = 1;
+
+    /// <summary>每页条数</summary>
+    public int PageSize { get; set; } = 10;
+
+    /// <summary>领料单号(nbr,模糊匹配)</summary>
+    public string? Nbr { get; set; }
+
+    /// <summary>SAP单号/工单号(work_ord,模糊匹配)</summary>
+    public string? WorkOrd { get; set; }
+
+    /// <summary>状态(status,精确匹配原值)</summary>
+    public string? Status { get; set; }
+
+    /// <summary>生产线(prod_line,模糊匹配)</summary>
+    public string? ProdLine { get; set; }
+
+    /// <summary>领料日期起(issue_date,含当日,yyyy-MM-dd)</summary>
+    public string? DateFrom { get; set; }
+
+    /// <summary>领料日期止(issue_date,含当日,yyyy-MM-dd)</summary>
+    public string? DateTo { get; set; }
+
+    /// <summary>排序字段(前端列 prop:nbr / issueDate / status / workOrd / prodLine / createTime)</summary>
+    public string? OrderBy { get; set; }
+
+    /// <summary>排序方向(asc / desc)</summary>
+    public string? OrderDir { get; set; }
+
+    /// <summary>租户 ID(前端 withAidopTenantParams 注入;为空则不按租户过滤)</summary>
+    public long? TenantId { get; set; }
+}
+
+/// <summary>
+/// 生产领料单列表 行(只读)。字段对齐前端列 prop(camelCase)。
+/// </summary>
+public class ProductionIssueListRow
+{
+    /// <summary>主键 id(mdp_std_production_issue.id)</summary>
+    public long Id { get; set; }
+
+    /// <summary>领料单号(nbr)</summary>
+    public string? Nbr { get; set; }
+
+    /// <summary>领料日期(issue_date)</summary>
+    public DateTime? IssueDate { get; set; }
+
+    /// <summary>状态中文(status_desc)</summary>
+    public string? StatusDesc { get; set; }
+
+    /// <summary>SAP单号/工单号(work_ord)</summary>
+    public string? WorkOrd { get; set; }
+
+    /// <summary>部门(department + department_desc)</summary>
+    public string? DepartmentDesc { get; set; }
+
+    /// <summary>生产线(prod_line)</summary>
+    public string? ProdLine { get; set; }
+
+    /// <summary>需求数量(qty_ord)</summary>
+    public decimal? QtyOrd { get; set; }
+
+    /// <summary>领料人(issue_user)</summary>
+    public string? IssueUser { get; set; }
+
+    /// <summary>备注(remark)</summary>
+    public string? Remark { get; set; }
+
+    /// <summary>创建用户(create_user)</summary>
+    public string? CreateUser { get; set; }
+
+    /// <summary>创建时间(source_create_time)</summary>
+    public DateTime? CreateTime { get; set; }
+}

+ 212 - 0
server/Plugins/Admin.NET.Plugin.AiDOP/MaterialWarehouse/ProductionIssueMdpSyncService.cs

@@ -0,0 +1,212 @@
+namespace Admin.NET.Plugin.AiDOP.MaterialWarehouse;
+
+/// <summary>
+/// S5 生产领料单 数据中台只读同步转换服务(DOP 内部,头级单表,独立于 S5MdpSyncTransformService 的 KPI 管线)。
+///
+/// 源:aidopdev NbrMaster(m),业务类型 Type='SM';维表 DepartmentMaster(d) LEFT JOIN(Domain+Department)。
+/// 链路:NbrMaster(SM) 只读 → mdp_std_production_issue(typed)。
+///     不经 stg、不建明细、不建 dwd(只读列表);SM=领料单业务类型有 WorkOrderPickBillService 代码实证(工单下达 Type=SM)。
+///
+/// 约束:
+///   - 只读源表,仅写 mdp_std_production_issue;绝不 INSERT/UPDATE/DELETE NbrMaster;不碰 WorkOrderPickBillService 写路径。
+///   - 头过滤 m.Type='SM' AND m.IsActive=1(领料无 IsReturn 语义)。
+///   - status_desc 用旧系统领料 SQL 口径:PretreatmentState 非空取其值,Status='C'→'已下架','A'→'备料中',否则空。
+///   - 领料人 issue_user 取 m.User1(列表 SQL 口径),原样落库。
+///   - trans_type 展示:TransType='Z61'→'补料',否则'正常';trans_type_text:TransType='PrevProcess'→'需要前处理',否则空(旧系统口径)。
+///   - 不做 danjia/jiage/库存事务/状态流转;SM 为 0 行时转换成功完成、处理数为 0,不报错。
+/// </summary>
+public class ProductionIssueMdpSyncService : ITransient
+{
+    private const string JobCode = "S5_PRODUCTION_ISSUE_MDP_SYNC";
+
+    private readonly ISqlSugarClient _db;
+
+    public ProductionIssueMdpSyncService(ISqlSugarClient db)
+    {
+        _db = db;
+    }
+
+    /// <summary>全量同步转换:源(SM 头) → 标准层(头)。</summary>
+    public async Task<ProductionIssueMdpSyncResult> RunFullAsync(CancellationToken cancellationToken = default, string triggerType = "AUTO")
+    {
+        cancellationToken.ThrowIfCancellationRequested();
+        await EnsureTablesAsync();
+
+        var now = DateTime.Now;
+        var batchId = $"S5_PROD_ISSUE_FULL_{now:yyyyMMddHHmmss}";
+        var runLogId = await InsertRunLogAsync(batchId, now, triggerType);
+        var result = new ProductionIssueMdpSyncResult { BatchId = batchId, RunLogId = runLogId };
+
+        try
+        {
+            result.HeadRows = await TransformHeadStandardAsync(batchId, now);
+            await MarkRunSuccessAsync(runLogId, now, result);
+            return result;
+        }
+        catch (Exception ex)
+        {
+            await MarkRunFailedAsync(runLogId, now, ex.Message);
+            throw;
+        }
+    }
+
+    /// <summary>防御式建表(与 UpdateScripts DDL 同构,幂等)。</summary>
+    private async Task EnsureTablesAsync()
+    {
+        await _db.Ado.ExecuteCommandAsync(
+            """
+            CREATE TABLE IF NOT EXISTS mdp_std_production_issue (
+                id BIGINT AUTO_INCREMENT PRIMARY KEY,
+                tenant_id BIGINT NOT NULL DEFAULT 0,
+                factory_id BIGINT NULL DEFAULT 1,
+                source_system VARCHAR(50) NOT NULL DEFAULT 'AIDOP',
+                domain VARCHAR(80) NOT NULL,
+                rec_id INT NOT NULL,
+                nbr VARCHAR(24) NULL,
+                issue_date DATETIME NULL,
+                status VARCHAR(8) NULL,
+                status_desc VARCHAR(20) NULL,
+                work_ord VARCHAR(64) NULL,
+                department VARCHAR(8) NULL,
+                department_desc VARCHAR(255) NULL,
+                qty_ord DECIMAL(18,5) NULL DEFAULT 0,
+                prod_line VARCHAR(8) NULL,
+                applicant_name VARCHAR(12) NULL,
+                issue_user VARCHAR(255) NULL,
+                user1 TEXT NULL,
+                remark VARCHAR(200) NULL,
+                create_user VARCHAR(24) NULL,
+                source_create_time DATETIME NULL,
+                pretreatment_state VARCHAR(50) NULL,
+                trans_type VARCHAR(24) NULL,
+                trans_type_text VARCHAR(50) NULL,
+                eff_date DATETIME NULL,
+                address VARCHAR(120) NULL,
+                source_biz_key VARCHAR(200) NULL,
+                sync_batch_id VARCHAR(100) NOT NULL,
+                sync_time DATETIME NOT NULL,
+                create_time DATETIME DEFAULT CURRENT_TIMESTAMP,
+                update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+                UNIQUE KEY uk_mdp_std_prod_issue (tenant_id, domain, rec_id),
+                KEY idx_mdp_std_prod_issue_nbr (tenant_id, nbr),
+                KEY idx_mdp_std_prod_issue_date (tenant_id, issue_date),
+                KEY idx_mdp_std_prod_issue_status (tenant_id, status),
+                KEY idx_mdp_std_prod_issue_workord (tenant_id, work_ord),
+                KEY idx_mdp_std_prod_issue_prodline (tenant_id, prod_line),
+                KEY idx_mdp_std_prod_issue_dept (tenant_id, department)
+            ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='S5生产领料单头标准层'
+            """);
+    }
+
+    /// <summary>
+    /// 标准化头:NbrMaster(SM) + DepartmentMaster -> mdp_std_production_issue。返回处理头行数。
+    /// SQL 由旧系统领料头 SQL 翻译(SQL Server -&gt; MySQL):IsNull-&gt;IFNULL、upper() 保留、
+    /// rtrim(a+' '+b)-&gt;TRIM(CONCAT(...))、with(nolock) 去除、convert(varchar,EffDate,23)-&gt; DATE(EffDate)。
+    /// </summary>
+    private async Task<int> TransformHeadStandardAsync(string batchId, DateTime now)
+    {
+        var rows = await _db.Ado.GetIntAsync(
+            "SELECT COUNT(1) FROM NbrMaster m WHERE m.Type='SM' AND m.IsActive=1");
+        await _db.Ado.ExecuteCommandAsync(
+            """
+            INSERT INTO mdp_std_production_issue
+            (tenant_id, factory_id, source_system, domain, rec_id, nbr, issue_date, status, status_desc,
+             work_ord, department, department_desc, qty_ord, prod_line, applicant_name, issue_user,
+             user1, remark, create_user, source_create_time, pretreatment_state, trans_type, trans_type_text,
+             eff_date, address, source_biz_key, sync_batch_id, sync_time)
+            SELECT
+                IFNULL(m.tenant_id, 0), 1, 'AIDOP', m.Domain, m.RecID, m.Nbr, m.Date,
+                UPPER(IFNULL(m.Status, '')),
+                CASE
+                    WHEN IFNULL(m.PretreatmentState,'')<>'' THEN m.PretreatmentState
+                    WHEN UPPER(IFNULL(m.Status,''))='C' THEN '已下架'
+                    WHEN UPPER(IFNULL(m.Status,''))='A' THEN '备料中'
+                    ELSE ''
+                END,
+                m.WorkOrd, m.Department, TRIM(CONCAT(m.Department, ' ', IFNULL(d.Descr, ''))),
+                m.QtyOrd, m.ProdLine, m.Name, CAST(m.User1 AS CHAR),
+                CAST(m.User1 AS CHAR), m.Remark, m.CreateUser, m.CreateTime,
+                IFNULL(m.PretreatmentState, ''),
+                CASE WHEN m.TransType='Z61' THEN '补料' ELSE '正常' END,
+                CASE WHEN m.TransType='PrevProcess' THEN '需要前处理' ELSE '' END,
+                m.EffDate, m.Address,
+                CONCAT(m.Domain, ':', m.RecID), @BatchId, @Now
+            FROM NbrMaster m
+            LEFT JOIN DepartmentMaster d ON d.Domain = m.Domain AND d.Department = m.Department
+            WHERE m.Type='SM' AND m.IsActive=1
+            ON DUPLICATE KEY UPDATE
+                factory_id=VALUES(factory_id), nbr=VALUES(nbr), issue_date=VALUES(issue_date),
+                status=VALUES(status), status_desc=VALUES(status_desc), work_ord=VALUES(work_ord),
+                department=VALUES(department), department_desc=VALUES(department_desc), qty_ord=VALUES(qty_ord),
+                prod_line=VALUES(prod_line), applicant_name=VALUES(applicant_name), issue_user=VALUES(issue_user),
+                user1=VALUES(user1), remark=VALUES(remark), create_user=VALUES(create_user),
+                source_create_time=VALUES(source_create_time), pretreatment_state=VALUES(pretreatment_state),
+                trans_type=VALUES(trans_type), trans_type_text=VALUES(trans_type_text),
+                eff_date=VALUES(eff_date), address=VALUES(address),
+                sync_batch_id=VALUES(sync_batch_id), sync_time=VALUES(sync_time), update_time=CURRENT_TIMESTAMP
+            """,
+            new SugarParameter("@BatchId", batchId),
+            new SugarParameter("@Now", now));
+        return rows;
+    }
+
+    private async Task<long> InsertRunLogAsync(string batchId, DateTime startedAt, string triggerType)
+    {
+        await _db.Ado.ExecuteCommandAsync(
+            """
+            INSERT INTO mdp_transform_run_log
+            (tenant_id, job_code, job_name, trigger_type, batch_id, status, start_time)
+            VALUES (0, @JobCode, 'S5生产领料单MDP同步与标准化转换', @TriggerType, @BatchId, 'RUNNING', @StartTime)
+            """,
+            new SugarParameter("@JobCode", JobCode),
+            new SugarParameter("@TriggerType", NormalizeTriggerType(triggerType)),
+            new SugarParameter("@BatchId", batchId),
+            new SugarParameter("@StartTime", startedAt));
+        return await _db.Ado.GetLongAsync(
+            "SELECT id FROM mdp_transform_run_log WHERE batch_id=@BatchId ORDER BY id DESC LIMIT 1",
+            new List<SugarParameter> { new("@BatchId", batchId) });
+    }
+
+    private async Task MarkRunSuccessAsync(long runLogId, DateTime startedAt, ProductionIssueMdpSyncResult result)
+    {
+        var finishedAt = DateTime.Now;
+        await _db.Ado.ExecuteCommandAsync(
+            """
+            UPDATE mdp_transform_run_log
+            SET status='SUCCESS', end_time=@EndTime, duration_ms=@DurationMs,
+                stage_rows=0, standard_rows=@StandardRows, dwd_rows=0, update_time=CURRENT_TIMESTAMP
+            WHERE id=@Id
+            """,
+            new SugarParameter("@EndTime", finishedAt),
+            new SugarParameter("@DurationMs", (int)(finishedAt - startedAt).TotalMilliseconds),
+            new SugarParameter("@StandardRows", result.HeadRows),
+            new SugarParameter("@Id", runLogId));
+    }
+
+    private async Task MarkRunFailedAsync(long runLogId, DateTime startedAt, string message)
+    {
+        var finishedAt = DateTime.Now;
+        await _db.Ado.ExecuteCommandAsync(
+            """
+            UPDATE mdp_transform_run_log
+            SET status='FAILED', end_time=@EndTime, duration_ms=@DurationMs,
+                error_message=@ErrorMessage, update_time=CURRENT_TIMESTAMP
+            WHERE id=@Id
+            """,
+            new SugarParameter("@EndTime", finishedAt),
+            new SugarParameter("@DurationMs", (int)(finishedAt - startedAt).TotalMilliseconds),
+            new SugarParameter("@ErrorMessage", message.Length > 2000 ? message[..2000] : message),
+            new SugarParameter("@Id", runLogId));
+    }
+
+    private static string NormalizeTriggerType(string? triggerType)
+        => string.IsNullOrWhiteSpace(triggerType) ? "AUTO" : triggerType.Trim().ToUpperInvariant();
+}
+
+/// <summary>生产领料单 MDP 同步转换结果。</summary>
+public sealed class ProductionIssueMdpSyncResult
+{
+    public long RunLogId { get; set; }
+    public string BatchId { get; set; } = string.Empty;
+    public int HeadRows { get; set; }
+}

+ 125 - 0
server/Plugins/Admin.NET.Plugin.AiDOP/MaterialWarehouse/ProductionIssueService.cs

@@ -0,0 +1,125 @@
+using Admin.NET.Plugin.AiDOP.MaterialWarehouse.Dto;
+
+namespace Admin.NET.Plugin.AiDOP.MaterialWarehouse;
+
+/// <summary>
+/// S5 生产领料单 只读 list 服务。
+///
+/// 数据源:DOP 数据中台标准层 mdp_std_production_issue(头级)。
+/// 由 ProductionIssueMdpSyncService 从 aidopdev.NbrMaster Type='SM' 同步标准化而来。
+///
+/// 本服务仅 SELECT:无新增/编辑/删除/发料确认/库存事务/状态流转/明细。
+/// 领料单为头级列表(一单一行),不 JOIN 明细,无重复。
+/// </summary>
+[ApiDescriptionSettings(Order = 305, Description = "生产领料单")]
+[Route("api/ProductionIssue")]
+[AllowAnonymous]
+[NonUnify]
+public class ProductionIssueService : IDynamicApiController, ITransient
+{
+    private readonly ISqlSugarClient _db;
+
+    public ProductionIssueService(ISqlSugarClient db)
+    {
+        _db = db;
+    }
+
+    /// <summary>
+    /// 生产领料单列表(只读分页查询)。
+    /// </summary>
+    [DisplayName("生产领料单列表")]
+    [HttpGet("list")]
+    public async Task<object> GetList([FromQuery] ProductionIssueListInput input)
+    {
+        var page = input.Page <= 0 ? 1 : input.Page;
+        var pageSize = input.PageSize <= 0 ? 10 : input.PageSize;
+        var offset = (page - 1) * pageSize;
+
+        var where = new List<string> { "1=1" };
+        var pars = new List<SugarParameter>();
+
+        if (input.TenantId is > 0)
+        {
+            where.Add("m.tenant_id = @TenantId");
+            pars.Add(new SugarParameter("@TenantId", input.TenantId));
+        }
+        if (!string.IsNullOrWhiteSpace(input.Nbr))
+        {
+            where.Add("m.nbr LIKE @Nbr");
+            pars.Add(new SugarParameter("@Nbr", $"%{input.Nbr.Trim()}%"));
+        }
+        if (!string.IsNullOrWhiteSpace(input.WorkOrd))
+        {
+            where.Add("m.work_ord LIKE @WorkOrd");
+            pars.Add(new SugarParameter("@WorkOrd", $"%{input.WorkOrd.Trim()}%"));
+        }
+        if (!string.IsNullOrWhiteSpace(input.Status))
+        {
+            where.Add("m.status = @Status");
+            pars.Add(new SugarParameter("@Status", input.Status.Trim()));
+        }
+        if (!string.IsNullOrWhiteSpace(input.ProdLine))
+        {
+            where.Add("m.prod_line LIKE @ProdLine");
+            pars.Add(new SugarParameter("@ProdLine", $"%{input.ProdLine.Trim()}%"));
+        }
+        if (!string.IsNullOrWhiteSpace(input.DateFrom))
+        {
+            where.Add("m.issue_date >= @DateFrom");
+            pars.Add(new SugarParameter("@DateFrom", $"{input.DateFrom.Trim()} 00:00:00"));
+        }
+        if (!string.IsNullOrWhiteSpace(input.DateTo))
+        {
+            where.Add("m.issue_date <= @DateTo");
+            pars.Add(new SugarParameter("@DateTo", $"{input.DateTo.Trim()} 23:59:59"));
+        }
+
+        var whereSql = string.Join(" AND ", where);
+
+        var total = await _db.Ado.GetIntAsync(
+            $"SELECT COUNT(1) FROM mdp_std_production_issue m WHERE {whereSql}", pars);
+
+        var list = await _db.Ado.SqlQueryAsync<ProductionIssueListRow>(
+            $"""
+            SELECT
+                m.id                 AS Id,
+                m.nbr                AS Nbr,
+                m.issue_date         AS IssueDate,
+                m.status_desc        AS StatusDesc,
+                m.work_ord           AS WorkOrd,
+                m.department_desc    AS DepartmentDesc,
+                m.prod_line          AS ProdLine,
+                m.qty_ord            AS QtyOrd,
+                m.issue_user         AS IssueUser,
+                m.remark             AS Remark,
+                m.create_user        AS CreateUser,
+                m.source_create_time AS CreateTime
+            FROM mdp_std_production_issue m
+            WHERE {whereSql}
+            ORDER BY {BuildOrderBy(input.OrderBy, input.OrderDir)}
+            LIMIT {pageSize} OFFSET {offset}
+            """,
+            pars);
+
+        return new { total, page, pageSize, list };
+    }
+
+    /// <summary>
+    /// 排序白名单:仅允许按已展示列排序,杜绝 SQL 注入;非法字段回落默认。
+    /// </summary>
+    private static string BuildOrderBy(string? orderBy, string? orderDir)
+    {
+        var column = orderBy switch
+        {
+            "nbr" => "m.nbr",
+            "issueDate" => "m.issue_date",
+            "status" => "m.status",
+            "workOrd" => "m.work_ord",
+            "prodLine" => "m.prod_line",
+            "createTime" => "m.source_create_time",
+            _ => "m.issue_date",
+        };
+        var direction = string.Equals(orderDir, "asc", StringComparison.OrdinalIgnoreCase) ? "ASC" : "DESC";
+        return $"{column} {direction}, m.id DESC";
+    }
+}

+ 1 - 1
server/Plugins/Admin.NET.Plugin.AiDOP/SeedData/SysMenuSeedData.cs

@@ -542,7 +542,7 @@ public class SysMenuSeedData : ISqlSugarEntitySeedData<SysMenu>
         const long warehouseBase = 1329015020000L;
         yield return new SysMenu { Id = warehouseBase + 1, Pid = warehouseDirId, Title = "委外发料单", Path = "/aidop/s5/warehouse/outsource-issue", Name = "aidopS5WarehouseOutsourceIssue", Component = "/aidop/s5/warehouse/outsourceIssueList", Icon = "ele-Document", Type = MenuTypeEnum.Menu, CreateTime = ct, OrderNo = 10, Remark = "S5 委外发料单(只读骨架,真实数据源待补证)" };
         yield return new SysMenu { Id = warehouseBase + 2, Pid = warehouseDirId, Title = "采购收货单", Path = "/aidop/s5/warehouse/purchase-receipt", Name = "aidopS5WarehousePurchaseReceipt", Component = "/aidop/s5/warehouse/purchaseReceiptList", Icon = "ele-Document", Type = MenuTypeEnum.Menu, CreateTime = ct, OrderNo = 20, Remark = "S5 采购收货单(只读列表,数据中台标准层 mdp_std_purchase_receipt)" };
-        yield return new SysMenu { Id = warehouseBase + 3, Pid = warehouseDirId, Title = "生产领料单", Path = "/aidop/s5/warehouse/production-issue", Name = "aidopS5WarehouseProductionIssue", Component = placeholderComponent, Icon = "ele-Document", Type = MenuTypeEnum.Menu, CreateTime = ct, OrderNo = 30, Remark = "S5 生产领料单(真实页面待交付)" };
+        yield return new SysMenu { Id = warehouseBase + 3, Pid = warehouseDirId, Title = "生产领料单", Path = "/aidop/s5/warehouse/production-issue", Name = "aidopS5WarehouseProductionIssue", Component = "/aidop/s5/warehouse/productionIssueList", Icon = "ele-Document", Type = MenuTypeEnum.Menu, CreateTime = ct, OrderNo = 30, Remark = "S5 生产领料单(只读列表,数据中台标准层 mdp_std_production_issue)" };
         yield return new SysMenu { Id = warehouseBase + 4, Pid = warehouseDirId, Title = "生产退料单", Path = "/aidop/s5/warehouse/production-return", Name = "aidopS5WarehouseProductionReturn", Component = "/aidop/s5/warehouse/productionReturnList", Icon = "ele-Document", Type = MenuTypeEnum.Menu, CreateTime = ct, OrderNo = 40, Remark = "S5 生产退料单(只读 head-detail,数据中台标准层 mdp_std_production_return)" };
         yield return new SysMenu { Id = warehouseBase + 5, Pid = warehouseDirId, Title = "生产入库单", Path = "/aidop/s5/warehouse/production-receipt", Name = "aidopS5WarehouseProductionReceipt", Component = "/aidop/s5/warehouse/productionReceiptList", Icon = "ele-Document", Type = MenuTypeEnum.Menu, CreateTime = ct, OrderNo = 50, Remark = "S5 生产入库单(只读扁平,数据中台标准层 mdp_std_production_receipt)" };