chore: release client-v1.0.83

docs: 出入库单打印排版方案（6 种黑白样式 HTML + PDF）
参考真实发票/送货单产出 6 种黑白排版供选型，已登记 docs 索引。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-26 18:11:40 +08:00 · 2026-06-26 18:10:19 +08:00 · 2026-06-26 18:10:12 +08:00 · 2026-06-26 17:03:23 +08:00 · 2026-06-26 01:52:04 +08:00 · 2026-06-24 18:40:23 +08:00
42 changed files with 2621 additions and 503 deletions
@@ -180,7 +180,7 @@ jobs:
          GITEA_REPOSITORY: ${{ gitea.repository }}
        run: sh scripts/ci/release-client.sh "${{ gitea.ref_name }}"

-      - name: Deploy
+      - name: Deploy → EC2
        env:
          FORGEJO_TOKEN: ${{ secrets.FORGEJO_TOKEN }}
          FORGEJO_URL: ${{ secrets.FORGEJO_URL }}
@@ -190,6 +190,19 @@ jobs:
          EC2_USER: ${{ secrets.EC2_USER }}
        run: sh scripts/ci/deploy-client.sh "${{ gitea.ref_name }}"

+      # 迁移期影子目标：同步 Flutter web + version.yaml + 安装包到阿里机。失败不挡 EC2。
+      - name: Deploy → Ali (migration shadow)
+        if: always()
+        continue-on-error: true
+        env:
+          FORGEJO_TOKEN: ${{ secrets.FORGEJO_TOKEN }}
+          FORGEJO_URL: ${{ secrets.FORGEJO_URL }}
+          GITEA_REPOSITORY: ${{ gitea.repository }}
+          DEPLOY_SSH_KEY: ${{ secrets.ALI_SSH_KEY }}
+          DEPLOY_HOST: ${{ secrets.ALI_HOST }}
+          DEPLOY_USER: ${{ secrets.ALI_USER }}
+        run: sh scripts/ci/deploy-client.sh "${{ gitea.ref_name }}"
+
      - name: Notify
        if: always()
        env:
@@ -36,16 +36,32 @@ jobs:
          GITEA_REPOSITORY: ${{ gitea.repository }}
        run: sh scripts/ci/release-server.sh "${{ gitea.ref_name }}"

-      - name: Deploy
+      - name: Deploy → EC2
        env:
          FORGEJO_TOKEN: ${{ secrets.FORGEJO_TOKEN }}
          FORGEJO_URL: ${{ secrets.FORGEJO_URL }}
          GITEA_REPOSITORY: ${{ gitea.repository }}
+          DEPLOY_TARGET: ec2
          EC2_SSH_KEY: ${{ secrets.EC2_SSH_KEY }}
          EC2_HOST: ${{ secrets.EC2_HOST }}
          EC2_USER: ${{ secrets.EC2_USER }}
        run: sh scripts/ci/deploy-server.sh "${{ gitea.ref_name }}"

+      # 迁移期影子目标：部署到阿里机（只换二进制 + reload 独立 nginx，jiu 保持 stopped）。
+      # if: always() → EC2 失败也照样尝试；continue-on-error → 阿里失败不让流水线变红。
+      - name: Deploy → Ali (migration shadow)
+        if: always()
+        continue-on-error: true
+        env:
+          FORGEJO_TOKEN: ${{ secrets.FORGEJO_TOKEN }}
+          FORGEJO_URL: ${{ secrets.FORGEJO_URL }}
+          GITEA_REPOSITORY: ${{ gitea.repository }}
+          DEPLOY_TARGET: ali
+          DEPLOY_SSH_KEY: ${{ secrets.ALI_SSH_KEY }}
+          DEPLOY_HOST: ${{ secrets.ALI_HOST }}
+          DEPLOY_USER: ${{ secrets.ALI_USER }}
+        run: sh scripts/ci/deploy-server.sh "${{ gitea.ref_name }}"
+
      - name: Notify
        if: always()
        env:
@@ -32,7 +32,7 @@ jobs:
          GITEA_REPOSITORY: ${{ gitea.repository }}
        run: sh scripts/ci/release-site.sh "${{ gitea.ref_name }}"

-      - name: Deploy
+      - name: Deploy → EC2
        env:
          FORGEJO_TOKEN: ${{ secrets.FORGEJO_TOKEN }}
          FORGEJO_URL: ${{ secrets.FORGEJO_URL }}
@@ -42,6 +42,19 @@ jobs:
          EC2_USER: ${{ secrets.EC2_USER }}
        run: sh scripts/ci/deploy-site.sh "${{ gitea.ref_name }}"

+      # 迁移期影子目标：同步官网到阿里机。失败不挡 EC2。
+      - name: Deploy → Ali (migration shadow)
+        if: always()
+        continue-on-error: true
+        env:
+          FORGEJO_TOKEN: ${{ secrets.FORGEJO_TOKEN }}
+          FORGEJO_URL: ${{ secrets.FORGEJO_URL }}
+          GITEA_REPOSITORY: ${{ gitea.repository }}
+          DEPLOY_SSH_KEY: ${{ secrets.ALI_SSH_KEY }}
+          DEPLOY_HOST: ${{ secrets.ALI_HOST }}
+          DEPLOY_USER: ${{ secrets.ALI_USER }}
+        run: sh scripts/ci/deploy-site.sh "${{ gitea.ref_name }}"
+
      - name: Notify
        if: always()
        env:
@@ -5,6 +5,58 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

+## [1.0.83] - 2026-06-26
+
+### 改进
+- 出库单 / 入库单打印版式全面优化：公司抬头、批次号与生产日期、数字等宽对齐、单据总计独立高亮条，整体更紧凑规整，打印更清晰。
+
+### 修复
+- 修正出库单打印的「单价 / 金额」：现按售价显示（金额 = 售价 × 数量），不再误用成本价；历史单据自动兼容。
+
+## [1.0.82] - 2026-06-26
+
+### 新功能
+- 出库单 / 入库单打印新增「打印预览」：点击打印先弹出整页预览（所见即所得），确认无误后再调用系统打印，解决部分 Windows 电脑打印对话框无法预览的问题。
+
+## [1.0.81] - 2026-06-24
+
+### 改进
+- 出库 / 入库单详情全屏弹窗只覆盖内容区，不再遮挡左侧菜单栏、顶栏与状态栏。
+- 出库 / 入库单详情标题栏改为浅色配色（浅蓝底 + 深色文字），观感更清爽。
+
+## [1.0.80] - 2026-06-24
+
+### 新功能
+- 出库单详情新增「售价」与「利润」列，利润 = 售价 − 成本，一眼看清每笔出库的盈亏。
+
+### 改进
+- 出库 / 入库单详情改为全屏展示，内容更大更清晰，左上角返回箭头关闭。
+- 出库单详情自动带出商品的生产日期与批次号（明细未单独填写时回退商品资料），去掉冗余的「数量」列。
+
+## [1.0.79] - 2026-06-24
+
+### 改进
+- 入库单 / 出库单搜索框升级：搜索后关键词以标签形式显示在搜索框内，带一键清除（✕）按钮，输入框自动清空便于继续输入；当前仅支持单个搜索词。
+
+## [1.0.78] - 2026-06-24
+
+### 改进
+- 维护性发布：发布与部署流程修复，应用功能无变更。
+
+## [1.0.77] - 2026-06-24
+
+### 新功能
+- 入库 / 出库列表的搜索框支持按「酒名（商品名）」搜索（支持汉字、全拼、首字母），输入时带防抖限流，输入更顺畅。
+
+### 改进
+- 入库录入单价允许留空或填 0（待定价）：不再强制单价大于 0，便于先入库、后用「确认进价」补填真实进价。
+
+## [1.0.76] - 2026-06-23
+
+### 新功能
+- 商品详情页：双击商品图片即可全屏查看，支持双指缩放、左右翻页
+- 入库单详情新增「确认进价」：先以 0 价（待定）入库的调货单据，价格确定后可补填真实进价，系统自动回填库存成本、已出库成本与对供应商的应付，售价/应收不受影响；库存与入库明细中未定价的商品显示「待定价」
+
 ## [1.0.75] - 2026-06-22

 ### 新功能
@@ -5,6 +5,26 @@
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

+## [1.0.81] - 2026-06-24
+
+### 修复
+- 入库单 / 出库单按商品名搜索：历史导入的单据现在也能按商品名搜到（此前明细统一挂占位商品，搜索被占位名顶替，只能搜到新建单据）。
+
+## [1.0.80] - 2026-06-24
+
+### 改进
+- 运维（不影响线上功能）：修复迁移期 CI 影子部署链路——部署私钥写入时补齐结尾换行，解决阿里机 ed25519 部署密钥被判「invalid format」导致 Deploy → Ali 步骤每次失败的问题。
+
+## [1.0.79] - 2026-06-24
+
+### 改进
+- 入库单 / 出库单列表的关键词搜索支持按「酒名（商品名）」模糊反查：除单号、往来单位外，输入商品名（含拼音/首字母）即可筛出含该商品的单据。
+
+## [1.0.78] - 2026-06-23
+
+### 新功能
+- 入库单新增「确认进价」接口：以 0 价（暂估）入库并已审核/出库的调货单据，价格确定后可补填真实进价。系统在一个事务内前向补偿——回填库存批次成本与已出库明细的成本快照、按差额补一条对供应商的应付流水、重算入库单合计，售价与应收不受影响；仅管理员可操作，支持多次按差额修正。
+
 ## [1.0.77] - 2026-06-22

 ### 新功能
@@ -0,0 +1,191 @@
+package handler
+
+import (
+	"fmt"
+	"net/http"
+	"testing"
+	"time"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	"github.com/wangjia/jiu/backend/internal/model"
+	"github.com/wangjia/jiu/backend/testutil"
+)
+
+// 调货核心场景：0 价入库 → 审核 → 部分出库 → 确认进价（前向补偿）。
+func TestConfirmCost_BackfillsCostAndAdjustsPayable(t *testing.T) {
+	db := testutil.SetupTestDB()
+	shop := testutil.CreateTestShop(db, "CC_MAIN")
+	admin := testutil.CreateTestUser(db, shop.ID, "admin", "pass", "admin")
+	wh := testutil.CreateTestWarehouse(db, shop.ID, "仓")
+	prod := testutil.CreateTestProduct(db, shop.ID, "茅台")
+	adminToken := getAuthToken(admin.ID, shop.ID, "admin")
+	r := setupProtectedRouter(db)
+
+	// 0 价入库 10 → 审核
+	w := makeRequest(r, "POST", "/api/v1/stock-in/orders", adminToken, map[string]interface{}{
+		"warehouse_id": wh.ID, "order_date": time.Now().Format(time.RFC3339),
+		"items": []map[string]interface{}{{"product_id": prod.ID, "quantity": 10.0, "unit_price": 0.0}},
+	})
+	require.Equal(t, http.StatusCreated, w.Code)
+	inID := extractID(w)
+	makeRequest(r, "PUT", fmt.Sprintf("/api/v1/stock-in/orders/%d/submit", inID), adminToken, nil)
+	makeRequest(r, "PUT", fmt.Sprintf("/api/v1/stock-in/orders/%d/approve", inID), adminToken, nil)
+
+	var inItem model.StockInItem
+	require.NoError(t, db.Where("order_id = ?", inID).First(&inItem).Error)
+	pid := inItem.ProductID // 序列号模型：入库为该行新建独立 product
+
+	// 库存批次成本待定（UnitPrice 为 NULL）
+	var inv model.Inventory
+	require.NoError(t, db.Where("shop_id = ? AND stock_in_item_id = ?", shop.ID, inItem.ID).First(&inv).Error)
+	assert.Nil(t, inv.UnitPrice, "0 价入库时库存成本应为待定(NULL)")
+
+	// 出库 4（售价 80，成本暂为 0）→ 审核
+	w = makeRequest(r, "POST", "/api/v1/stock-out/orders", adminToken, map[string]interface{}{
+		"warehouse_id": wh.ID, "order_date": time.Now().Format(time.RFC3339),
+		"items": []map[string]interface{}{{"product_id": pid, "quantity": 4.0, "unit_price": 0.0, "sale_price": 80.0}},
+	})
+	outID := extractID(w)
+	makeRequest(r, "PUT", fmt.Sprintf("/api/v1/stock-out/orders/%d/submit", outID), adminToken, nil)
+	makeRequest(r, "PUT", fmt.Sprintf("/api/v1/stock-out/orders/%d/approve", outID), adminToken, nil)
+
+	// 确认进价 50
+	w = makeRequest(r, "POST", fmt.Sprintf("/api/v1/stock-in/orders/%d/confirm-cost", inID), adminToken,
+		map[string]interface{}{"items": []map[string]interface{}{{"item_id": inItem.ID, "unit_price": 50.0}}})
+	require.Equal(t, http.StatusOK, w.Code)
+
+	// 1. 入库明细成本回填
+	db.First(&inItem, inItem.ID)
+	assert.Equal(t, 50.0, inItem.UnitPrice)
+	assert.Equal(t, 500.0, inItem.TotalPrice)
+
+	// 2. 剩余库存批次成本回填（6 件）
+	db.First(&inv, inv.ID)
+	require.NotNil(t, inv.UnitPrice)
+	assert.Equal(t, 50.0, *inv.UnitPrice)
+
+	// 3. 已出库行成本快照回填，售价/应收不变
+	var outItem model.StockOutItem
+	require.NoError(t, db.Where("order_id = ?", outID).First(&outItem).Error)
+	assert.Equal(t, 50.0, outItem.UnitPrice, "已出库成本应回填")
+	assert.Equal(t, 200.0, outItem.TotalPrice, "成本小计 = 50×4")
+	assert.Equal(t, 80.0, outItem.SalePrice, "售价不应被改动")
+
+	var outOrder model.StockOutOrder
+	db.First(&outOrder, outID)
+	assert.Equal(t, 320.0, outOrder.TotalAmount, "应收按售价 4×80，确认进价不影响")
+
+	// 4. 入库单总额按差额重算：0 → 500
+	var inOrder model.StockInOrder
+	db.First(&inOrder, inID)
+	assert.Equal(t, 500.0, inOrder.TotalAmount)
+
+	// 5. 应付差额调整流水：+500（balance 是应收应付混合滚动总账：0 入 + 320 应收 + 500 = 820）
+	var adj model.FinanceRecord
+	require.NoError(t, db.Where("shop_id = ? AND type = 'payable' AND ref_type = 'stock_in_cost_adjust'", shop.ID).
+		First(&adj).Error)
+	assert.Equal(t, 500.0, adj.Amount)
+	assert.Equal(t, 820.0, adj.Balance)
+
+	// 6. product 参考进价同步（pid 是入库新建的独立 product）
+	var p2 model.Product
+	require.NoError(t, db.First(&p2, pid).Error)
+	assert.Equal(t, 50.0, p2.PurchasePrice)
+}
+
+// 非管理员无权确认进价。
+func TestConfirmCost_Forbidden(t *testing.T) {
+	db := testutil.SetupTestDB()
+	shop := testutil.CreateTestShop(db, "CC_FORBID")
+	admin := testutil.CreateTestUser(db, shop.ID, "admin", "pass", "admin")
+	op := testutil.CreateTestUser(db, shop.ID, "op", "pass", "operator")
+	wh := testutil.CreateTestWarehouse(db, shop.ID, "仓")
+	prod := testutil.CreateTestProduct(db, shop.ID, "五粮液")
+	adminToken := getAuthToken(admin.ID, shop.ID, "admin")
+	opToken := getAuthToken(op.ID, shop.ID, "operator")
+	r := setupProtectedRouter(db)
+
+	w := makeRequest(r, "POST", "/api/v1/stock-in/orders", adminToken, map[string]interface{}{
+		"warehouse_id": wh.ID, "order_date": time.Now().Format(time.RFC3339),
+		"items": []map[string]interface{}{{"product_id": prod.ID, "quantity": 5.0, "unit_price": 0.0}},
+	})
+	inID := extractID(w)
+	makeRequest(r, "PUT", fmt.Sprintf("/api/v1/stock-in/orders/%d/submit", inID), adminToken, nil)
+	makeRequest(r, "PUT", fmt.Sprintf("/api/v1/stock-in/orders/%d/approve", inID), adminToken, nil)
+	var inItem model.StockInItem
+	db.Where("order_id = ?", inID).First(&inItem)
+
+	w = makeRequest(r, "POST", fmt.Sprintf("/api/v1/stock-in/orders/%d/confirm-cost", inID), opToken,
+		map[string]interface{}{"items": []map[string]interface{}{{"item_id": inItem.ID, "unit_price": 30.0}}})
+	assert.Equal(t, http.StatusForbidden, w.Code)
+}
+
+// 仅 approved 单可确认；草稿/待审核拒绝。
+func TestConfirmCost_RejectsNonApproved(t *testing.T) {
+	db := testutil.SetupTestDB()
+	shop := testutil.CreateTestShop(db, "CC_DRAFT")
+	admin := testutil.CreateTestUser(db, shop.ID, "admin", "pass", "admin")
+	wh := testutil.CreateTestWarehouse(db, shop.ID, "仓")
+	prod := testutil.CreateTestProduct(db, shop.ID, "汾酒")
+	adminToken := getAuthToken(admin.ID, shop.ID, "admin")
+	r := setupProtectedRouter(db)
+
+	w := makeRequest(r, "POST", "/api/v1/stock-in/orders", adminToken, map[string]interface{}{
+		"warehouse_id": wh.ID, "order_date": time.Now().Format(time.RFC3339),
+		"items": []map[string]interface{}{{"product_id": prod.ID, "quantity": 5.0, "unit_price": 0.0}},
+	})
+	inID := extractID(w)
+	var inItem model.StockInItem
+	db.Where("order_id = ?", inID).First(&inItem)
+
+	// 仍是 draft → 400
+	w = makeRequest(r, "POST", fmt.Sprintf("/api/v1/stock-in/orders/%d/confirm-cost", inID), adminToken,
+		map[string]interface{}{"items": []map[string]interface{}{{"item_id": inItem.ID, "unit_price": 30.0}}})
+	assert.Equal(t, http.StatusBadRequest, w.Code)
+}
+
+// 重复确认：按新旧差额增量补偿，不重复全量。
+func TestConfirmCost_RepeatableByDiff(t *testing.T) {
+	db := testutil.SetupTestDB()
+	shop := testutil.CreateTestShop(db, "CC_REPEAT")
+	admin := testutil.CreateTestUser(db, shop.ID, "admin", "pass", "admin")
+	wh := testutil.CreateTestWarehouse(db, shop.ID, "仓")
+	prod := testutil.CreateTestProduct(db, shop.ID, "剑南春")
+	adminToken := getAuthToken(admin.ID, shop.ID, "admin")
+	r := setupProtectedRouter(db)
+
+	w := makeRequest(r, "POST", "/api/v1/stock-in/orders", adminToken, map[string]interface{}{
+		"warehouse_id": wh.ID, "order_date": time.Now().Format(time.RFC3339),
+		"items": []map[string]interface{}{{"product_id": prod.ID, "quantity": 10.0, "unit_price": 0.0}},
+	})
+	inID := extractID(w)
+	makeRequest(r, "PUT", fmt.Sprintf("/api/v1/stock-in/orders/%d/submit", inID), adminToken, nil)
+	makeRequest(r, "PUT", fmt.Sprintf("/api/v1/stock-in/orders/%d/approve", inID), adminToken, nil)
+	var inItem model.StockInItem
+	db.Where("order_id = ?", inID).First(&inItem)
+
+	// 第一次确认 50（diff 500）
+	makeRequest(r, "POST", fmt.Sprintf("/api/v1/stock-in/orders/%d/confirm-cost", inID), adminToken,
+		map[string]interface{}{"items": []map[string]interface{}{{"item_id": inItem.ID, "unit_price": 50.0}}})
+	// 第二次修正为 60（diff 100）
+	w = makeRequest(r, "POST", fmt.Sprintf("/api/v1/stock-in/orders/%d/confirm-cost", inID), adminToken,
+		map[string]interface{}{"items": []map[string]interface{}{{"item_id": inItem.ID, "unit_price": 60.0}}})
+	require.Equal(t, http.StatusOK, w.Code)
+
+	db.First(&inItem, inItem.ID)
+	assert.Equal(t, 60.0, inItem.UnitPrice)
+
+	var inOrder model.StockInOrder
+	db.First(&inOrder, inID)
+	assert.Equal(t, 600.0, inOrder.TotalAmount, "总额 = 60×10")
+
+	// 两条调整流水：+500 与 +100，余额滚动到 600
+	var adjs []model.FinanceRecord
+	db.Where("shop_id = ? AND ref_type = 'stock_in_cost_adjust'", shop.ID).Order("id ASC").Find(&adjs)
+	require.Len(t, adjs, 2)
+	assert.Equal(t, 500.0, adjs[0].Amount)
+	assert.Equal(t, 100.0, adjs[1].Amount)
+	assert.Equal(t, 600.0, adjs[1].Balance)
+}
@@ -52,9 +52,19 @@ func (h *StockInHandler) List(c *gin.Context) {
 	}
 	if kw := strings.TrimSpace(c.Query("keyword")); kw != "" {
 		like := "%" + kw + "%"
+		// keyword 同时命中：单号 / 往来单位 / 酒名（含全拼+首字母，反查含该酒明细的单据）。
+		// 酒名「product 主数据名 OR 明细快照名」任一命中——不能用 COALESCE 二选一：历史导入单的
+		// 明细 product_id 统一指向占位商品「历史导入占位」（p.name 非空），COALESCE 会被占位名劫持，
+		// 永远取不到真实快照 product_name，导致导入单按真实酒名搜不到。拼音只在 products 上（快照无拼音列）。
 		query = query.Where(
-			"order_no LIKE ? OR partner_id IN (SELECT id FROM partners WHERE shop_id = ? AND name LIKE ?)",
-			like, shopID, like,
+			"order_no LIKE ?"+
+				" OR partner_id IN (SELECT id FROM partners WHERE shop_id = ? AND name LIKE ?)"+
+				" OR id IN (SELECT it.order_id FROM stock_in_items it"+
+				"   LEFT JOIN products p ON p.id = it.product_id AND p.shop_id = it.shop_id"+
+				"   WHERE it.shop_id = ? AND it.deleted_at IS NULL"+
+				"     AND (p.name LIKE ? OR it.product_name LIKE ?"+
+				"          OR p.name_pinyin LIKE ? OR p.name_initials LIKE ?))",
+			like, shopID, like, shopID, like, like, like, like,
 		)
 	}

@@ -315,3 +325,41 @@ func (h *StockInHandler) Return(c *gin.Context) {
 	}
 	c.JSON(http.StatusOK, gin.H{"message": "returned"})
 }
+
+// ConfirmCost POST /api/v1/stock-in/orders/:id/confirm-cost
+// 确认进价：调货等以 0 价（暂估）入库并已审核后，价格确定时补填真实进价。
+// 前向补偿（更新库存成本、回填已出库成本快照、补应付差额），不反审核。
+// 仅 approved 单、管理员/超管（service 内判权）。
+func (h *StockInHandler) ConfirmCost(c *gin.Context) {
+	shopID := middleware.GetShopID(c)
+	userID := middleware.GetUserID(c)
+	role := middleware.GetRole(c)
+	id, _ := strconv.ParseUint(c.Param("id"), 10, 64)
+
+	var req struct {
+		Items []service.CostConfirmItem `json:"items"`
+	}
+	if err := c.ShouldBindJSON(&req); err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+		return
+	}
+	if len(req.Items) == 0 {
+		c.JSON(http.StatusBadRequest, gin.H{"error": "未提供要确认的明细"})
+		return
+	}
+	for _, it := range req.Items {
+		if it.UnitPrice <= 0 {
+			c.JSON(http.StatusBadRequest, gin.H{"error": "进价必须大于 0"})
+			return
+		}
+	}
+	if err := h.stockSvc.ConfirmStockInCost(shopID, id, userID, role, req.Items); err != nil {
+		if errors.Is(err, service.ErrForbidden) {
+			c.JSON(http.StatusForbidden, gin.H{"error": "无权确认进价"})
+			return
+		}
+		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+		return
+	}
+	c.JSON(http.StatusOK, gin.H{"message": "cost confirmed"})
+}
@@ -263,7 +263,7 @@ func TestStockInHandler_TotalAmount(t *testing.T) {
 		"warehouse_id": warehouse.ID,
 		"order_date":   time.Now().Format(time.RFC3339),
 		"items": []map[string]interface{}{
-			{"product_id": product1.ID, "quantity": 10.0, "unit_price": 5.0},  // 50
+			{"product_id": product1.ID, "quantity": 10.0, "unit_price": 5.0}, // 50
 			{"product_id": product2.ID, "quantity": 3.0, "unit_price": 20.0}, // 60
 		},
 	})
@@ -451,6 +451,149 @@ func TestStockInHandler_List_FilterByKeyword(t *testing.T) {
 	assert.Equal(t, float64(2), parseResponse(w)["total"].(float64))
 }

+func TestStockInHandler_List_FilterByProductName(t *testing.T) {
+	db := testutil.SetupTestDB()
+	shop := testutil.CreateTestShop(db, "SI012")
+	user := testutil.CreateTestUser(db, shop.ID, "admin", "pass", "admin")
+	warehouse := testutil.CreateTestWarehouse(db, shop.ID, "Warehouse")
+	token := getAuthToken(user.ID, shop.ID, "admin")
+	r := setupProtectedRouter(db)
+
+	// 单据1：明细酒名「飞天茅台」（入库按 product_name 新建独立 product）
+	w := makeRequest(r, "POST", "/api/v1/stock-in/orders", token, map[string]interface{}{
+		"warehouse_id": warehouse.ID,
+		"order_date":   time.Now().Format(time.RFC3339),
+		"items":        []map[string]interface{}{{"product_name": "飞天茅台", "quantity": 5.0}},
+	})
+	require.Equal(t, http.StatusCreated, w.Code)
+
+	// 单据2：明细酒名「拉菲红酒」
+	w = makeRequest(r, "POST", "/api/v1/stock-in/orders", token, map[string]interface{}{
+		"warehouse_id": warehouse.ID,
+		"order_date":   time.Now().Format(time.RFC3339),
+		"items":        []map[string]interface{}{{"product_name": "拉菲红酒", "quantity": 3.0}},
+	})
+	require.Equal(t, http.StatusCreated, w.Code)
+
+	// 按酒名模糊反查 → 各命中 1 单
+	w = makeRequest(r, "GET", "/api/v1/stock-in/orders?keyword=茅台", token, nil)
+	assert.Equal(t, float64(1), parseResponse(w)["total"].(float64))
+
+	w = makeRequest(r, "GET", "/api/v1/stock-in/orders?keyword=红酒", token, nil)
+	assert.Equal(t, float64(1), parseResponse(w)["total"].(float64))
+
+	// 无关键词 → 两单都在
+	w = makeRequest(r, "GET", "/api/v1/stock-in/orders", token, nil)
+	assert.Equal(t, float64(2), parseResponse(w)["total"].(float64))
+}
+
+// 回归：历史导入单的明细 product_id 统一指向占位商品「历史导入占位」（p.name 非空），
+// 真实酒名只在快照列 product_name。修复前搜索用 COALESCE(NULLIF(p.name,”), product_name)
+// 被占位名劫持，导入单按真实酒名搜不到；修复后「p.name OR product_name」任一命中。
+func TestStockInHandler_List_FilterByImportedSnapshotName(t *testing.T) {
+	db := testutil.SetupTestDB()
+	shop := testutil.CreateTestShop(db, "SI012B")
+	user := testutil.CreateTestUser(db, shop.ID, "admin", "pass", "admin")
+	warehouse := testutil.CreateTestWarehouse(db, shop.ID, "Warehouse")
+	token := getAuthToken(user.ID, shop.ID, "admin")
+	r := setupProtectedRouter(db)
+
+	// 占位商品：名「历史导入占位」，编码 HIST-PLACEHOLDER（模拟 import-history）
+	placeholder := &model.Product{
+		TenantBase: model.TenantBase{ShopID: shop.ID},
+		Name:       "历史导入占位",
+		Code:       "HIST-PLACEHOLDER",
+	}
+	require.NoError(t, db.Create(placeholder).Error)
+
+	// 导入单：明细 product_id 指向占位商品，真实酒名「飞天茅台」仅在快照 product_name
+	order := &model.StockInOrder{
+		TenantBase:  model.TenantBase{ShopID: shop.ID},
+		OrderNo:     "RK-IMPORT-001",
+		WarehouseID: warehouse.ID,
+		OperatorID:  user.ID,
+		Status:      "approved",
+		OrderDate:   model.Date{Time: time.Now()},
+	}
+	require.NoError(t, db.Create(order).Error)
+	require.NoError(t, db.Create(&model.StockInItem{
+		OrderID:     order.ID,
+		ShopID:      shop.ID,
+		ProductID:   placeholder.ID,
+		ProductCode: "ZXZ000010",
+		ProductName: "飞天茅台",
+		Quantity:    5.0,
+	}).Error)
+
+	// 按真实酒名搜 → 命中导入单（修复前为 0）
+	w := makeRequest(r, "GET", "/api/v1/stock-in/orders?keyword=茅台", token, nil)
+	assert.Equal(t, float64(1), parseResponse(w)["total"].(float64))
+}
+
+func TestStockInHandler_List_FilterByProductPinyin(t *testing.T) {
+	db := testutil.SetupTestDB()
+	shop := testutil.CreateTestShop(db, "SI013")
+	user := testutil.CreateTestUser(db, shop.ID, "admin", "pass", "admin")
+	warehouse := testutil.CreateTestWarehouse(db, shop.ID, "Warehouse")
+	token := getAuthToken(user.ID, shop.ID, "admin")
+	r := setupProtectedRouter(db)
+
+	// 入库按 product_name 新建独立 product，会自动写入拼音列（name_pinyin/name_initials）
+	w := makeRequest(r, "POST", "/api/v1/stock-in/orders", token, map[string]interface{}{
+		"warehouse_id": warehouse.ID,
+		"order_date":   time.Now().Format(time.RFC3339),
+		"items":        []map[string]interface{}{{"product_name": "飞天茅台", "quantity": 5.0}},
+	})
+	require.Equal(t, http.StatusCreated, w.Code)
+
+	// 全拼命中（feitianmaotai）
+	w = makeRequest(r, "GET", "/api/v1/stock-in/orders?keyword=feitian", token, nil)
+	assert.Equal(t, float64(1), parseResponse(w)["total"].(float64))
+
+	// 首字母命中（ftmt）
+	w = makeRequest(r, "GET", "/api/v1/stock-in/orders?keyword=ftmt", token, nil)
+	assert.Equal(t, float64(1), parseResponse(w)["total"].(float64))
+
+	// 不相关拼音不命中
+	w = makeRequest(r, "GET", "/api/v1/stock-in/orders?keyword=wuliangye", token, nil)
+	assert.Equal(t, float64(0), parseResponse(w)["total"].(float64))
+}
+
+func TestStockInHandler_List_FilterByProductName_TenantIsolation(t *testing.T) {
+	db := testutil.SetupTestDB()
+	r := setupProtectedRouter(db)
+
+	// 店A、店B 各建一张含「茅台」明细的入库单
+	shopA := testutil.CreateTestShop(db, "SI014A")
+	userA := testutil.CreateTestUser(db, shopA.ID, "adminA", "pass", "admin")
+	whA := testutil.CreateTestWarehouse(db, shopA.ID, "WA")
+	tokenA := getAuthToken(userA.ID, shopA.ID, "admin")
+
+	shopB := testutil.CreateTestShop(db, "SI014B")
+	userB := testutil.CreateTestUser(db, shopB.ID, "adminB", "pass", "admin")
+	whB := testutil.CreateTestWarehouse(db, shopB.ID, "WB")
+	tokenB := getAuthToken(userB.ID, shopB.ID, "admin")
+
+	for _, tc := range []struct {
+		token string
+		wh    uint64
+	}{{tokenA, whA.ID}, {tokenB, whB.ID}} {
+		w := makeRequest(r, "POST", "/api/v1/stock-in/orders", tc.token, map[string]interface{}{
+			"warehouse_id": tc.wh,
+			"order_date":   time.Now().Format(time.RFC3339),
+			"items":        []map[string]interface{}{{"product_name": "飞天茅台", "quantity": 1.0}},
+		})
+		require.Equal(t, http.StatusCreated, w.Code)
+	}
+
+	// 店A 搜茅台只看到自己的 1 单，绝不串到店B
+	w := makeRequest(r, "GET", "/api/v1/stock-in/orders?keyword=茅台", tokenA, nil)
+	assert.Equal(t, float64(1), parseResponse(w)["total"].(float64))
+
+	w = makeRequest(r, "GET", "/api/v1/stock-in/orders?keyword=茅台", tokenB, nil)
+	assert.Equal(t, float64(1), parseResponse(w)["total"].(float64))
+}
+
 func TestStockInHandler_List_FilterByStatus(t *testing.T) {
 	db := testutil.SetupTestDB()
 	shop := testutil.CreateTestShop(db, "SI010")
@@ -45,9 +45,19 @@ func (h *StockOutHandler) List(c *gin.Context) {
 	}
 	if kw := strings.TrimSpace(c.Query("keyword")); kw != "" {
 		like := "%" + kw + "%"
+		// keyword 同时命中：单号 / 往来单位 / 酒名（含全拼+首字母，反查含该酒明细的单据）。
+		// 酒名「product 主数据名 OR 明细快照名」任一命中——不能用 COALESCE 二选一：历史导入单的
+		// 明细 product_id 统一指向占位商品「历史导入占位」（p.name 非空），COALESCE 会被占位名劫持，
+		// 永远取不到真实快照 product_name，导致导入单按真实酒名搜不到。拼音只在 products 上（快照无拼音列）。
 		query = query.Where(
-			"order_no LIKE ? OR partner_id IN (SELECT id FROM partners WHERE shop_id = ? AND name LIKE ?)",
-			like, shopID, like,
+			"order_no LIKE ?"+
+				" OR partner_id IN (SELECT id FROM partners WHERE shop_id = ? AND name LIKE ?)"+
+				" OR id IN (SELECT it.order_id FROM stock_out_items it"+
+				"   LEFT JOIN products p ON p.id = it.product_id AND p.shop_id = it.shop_id"+
+				"   WHERE it.shop_id = ? AND it.deleted_at IS NULL"+
+				"     AND (p.name LIKE ? OR it.product_name LIKE ?"+
+				"          OR p.name_pinyin LIKE ? OR p.name_initials LIKE ?))",
+			like, shopID, like, shopID, like, like, like, like,
 		)
 	}
 	// 按商品编码反查单据：精确匹配，走 idx_so_items_shop_code(shop_id, product_code) 索引
@@ -212,6 +212,82 @@ func TestStockOutHandler_List_FilterByKeyword(t *testing.T) {
 	assert.Equal(t, float64(2), parseResponse(w)["total"].(float64))
 }

+func TestStockOutHandler_List_FilterByProductName(t *testing.T) {
+	db := testutil.SetupTestDB()
+	shop := testutil.CreateTestShop(db, "SO012")
+	user := testutil.CreateTestUser(db, shop.ID, "admin", "pass", "admin")
+	warehouse := testutil.CreateTestWarehouse(db, shop.ID, "Warehouse")
+	maotai := testutil.CreateTestProduct(db, shop.ID, "飞天茅台")
+	lafei := testutil.CreateTestProduct(db, shop.ID, "拉菲红酒")
+	token := getAuthToken(user.ID, shop.ID, "admin")
+	r := setupProtectedRouter(db)
+
+	w := makeRequest(r, "POST", "/api/v1/stock-out/orders", token, map[string]interface{}{
+		"warehouse_id": warehouse.ID,
+		"order_date":   time.Now().Format(time.RFC3339),
+		"items":        []map[string]interface{}{{"product_id": maotai.ID, "quantity": 1.0}},
+	})
+	require.Equal(t, http.StatusCreated, w.Code)
+
+	w = makeRequest(r, "POST", "/api/v1/stock-out/orders", token, map[string]interface{}{
+		"warehouse_id": warehouse.ID,
+		"order_date":   time.Now().Format(time.RFC3339),
+		"items":        []map[string]interface{}{{"product_id": lafei.ID, "quantity": 1.0}},
+	})
+	require.Equal(t, http.StatusCreated, w.Code)
+
+	// 按酒名模糊反查 → 各命中 1 单
+	w = makeRequest(r, "GET", "/api/v1/stock-out/orders?keyword=茅台", token, nil)
+	assert.Equal(t, float64(1), parseResponse(w)["total"].(float64))
+
+	w = makeRequest(r, "GET", "/api/v1/stock-out/orders?keyword=红酒", token, nil)
+	assert.Equal(t, float64(1), parseResponse(w)["total"].(float64))
+
+	// 无关键词 → 两单都在
+	w = makeRequest(r, "GET", "/api/v1/stock-out/orders", token, nil)
+	assert.Equal(t, float64(2), parseResponse(w)["total"].(float64))
+}
+
+// 回归：历史导入出库单的明细 product_id 指向占位商品「历史导入占位」，真实酒名只在快照列。
+// 修复前 COALESCE 被占位名劫持搜不到，修复后「p.name OR product_name」任一命中。
+func TestStockOutHandler_List_FilterByImportedSnapshotName(t *testing.T) {
+	db := testutil.SetupTestDB()
+	shop := testutil.CreateTestShop(db, "SO012B")
+	user := testutil.CreateTestUser(db, shop.ID, "admin", "pass", "admin")
+	warehouse := testutil.CreateTestWarehouse(db, shop.ID, "Warehouse")
+	token := getAuthToken(user.ID, shop.ID, "admin")
+	r := setupProtectedRouter(db)
+
+	placeholder := &model.Product{
+		TenantBase: model.TenantBase{ShopID: shop.ID},
+		Name:       "历史导入占位",
+		Code:       "HIST-PLACEHOLDER",
+	}
+	require.NoError(t, db.Create(placeholder).Error)
+
+	order := &model.StockOutOrder{
+		TenantBase:  model.TenantBase{ShopID: shop.ID},
+		OrderNo:     "CK-IMPORT-001",
+		WarehouseID: warehouse.ID,
+		OperatorID:  user.ID,
+		Status:      "approved",
+		OrderDate:   model.Date{Time: time.Now()},
+	}
+	require.NoError(t, db.Create(order).Error)
+	require.NoError(t, db.Create(&model.StockOutItem{
+		OrderID:     order.ID,
+		ShopID:      shop.ID,
+		ProductID:   placeholder.ID,
+		ProductCode: "ZXZ000010",
+		ProductName: "飞天茅台",
+		Quantity:    5.0,
+	}).Error)
+
+	// 按真实酒名搜 → 命中导入单（修复前为 0）
+	w := makeRequest(r, "GET", "/api/v1/stock-out/orders?keyword=茅台", token, nil)
+	assert.Equal(t, float64(1), parseResponse(w)["total"].(float64))
+}
+
 func TestStockOutHandler_Reject(t *testing.T) {
 	db := testutil.SetupTestDB()
 	shop := testutil.CreateTestShop(db, "SO004")
@@ -66,6 +66,7 @@ func setupProtectedRouter(db *gorm.DB) *gin.Engine {
 	stockIn.PUT("/orders/:id/reject", stockInH.Reject)
 	stockIn.PUT("/orders/:id/withdraw", stockInH.Withdraw)
 	stockIn.POST("/orders/:id/return", stockInH.Return)
+	stockIn.POST("/orders/:id/confirm-cost", stockInH.ConfirmCost)

 	// 出库路由
 	stockOut := api.Group("/stock-out")
@@ -157,6 +157,8 @@ func Setup(r *gin.Engine, db *gorm.DB) {
 			stockIn.PUT("/orders/:id/withdraw", stockInH.Withdraw)
 			// 退单（已审核单退货，库存删除+冲应付）：仅管理员/超管（service 内判权）
 			stockIn.POST("/orders/:id/return", stockInH.Return)
+			// 确认进价（暂估0价→真实价，前向补偿）：仅管理员/超管（service 内判权）
+			stockIn.POST("/orders/:id/confirm-cost", stockInH.ConfirmCost)
 		}

 		// 出库
@@ -157,6 +157,111 @@ func (s *StockService) ApproveStockIn(shopID, orderID, reviewerID uint64) error
 	})
 }

+// CostConfirmItem 是「确认进价」的单行入参：把某入库明细的进价补成真实值。
+type CostConfirmItem struct {
+	ItemID    uint64  `json:"item_id"`
+	UnitPrice float64 `json:"unit_price"`
+}
+
+// ConfirmStockInCost 「确认进价」：调货等场景以 0 价（暂估）入库并已审核/已出库后，
+// 价格确定时补填真实进价。不反审核、不撤销任何已发生的动作，而是在一个事务内
+// 前向写补偿：
+//  1. 入库明细 UnitPrice / TotalPrice 改为真实值
+//  2. 该明细对应的剩余库存批次 Inventory.UnitPrice 由 NULL→真实值
+//  3. 该 product 已出库行 StockOutItem.UnitPrice/TotalPrice（成本快照）回填真实值
+//     （product↔入库明细 1:1，按 product_id 精确命中；不动 SalePrice/应收）
+//  4. 入库单 TotalAmount 按差额重算
+//  5. 对供应商应付按差额补一条调整流水（滚动余额）
+//
+// 仅 approved 单可确认（draft 直接编辑即可）；权限：管理员/超管。
+// 以「旧价→新价」差额计算补偿，支持多次修正（再次确认按新旧差额补）。
+func (s *StockService) ConfirmStockInCost(shopID, orderID, userID uint64, role string, items []CostConfirmItem) error {
+	if role != "admin" && role != "superadmin" {
+		return ErrForbidden
+	}
+	return s.db.Transaction(func(tx *gorm.DB) error {
+		var order model.StockInOrder
+		if err := tx.Preload("Items").Where("id = ? AND shop_id = ?", orderID, shopID).
+			First(&order).Error; err != nil {
+			return err
+		}
+		if order.Status != "approved" {
+			return errors.New("只有已审核单据可确认进价")
+		}
+
+		want := make(map[uint64]float64, len(items))
+		for _, it := range items {
+			want[it.ItemID] = it.UnitPrice
+		}
+
+		now := time.Now()
+		var totalDiff float64
+
+		for i := range order.Items {
+			it := &order.Items[i]
+			newPrice, ok := want[it.ID]
+			if !ok || newPrice == it.UnitPrice {
+				continue
+			}
+			oldPrice := it.UnitPrice
+			diff := (newPrice - oldPrice) * it.Quantity
+			totalDiff += diff
+
+			// 1. 入库明细
+			if err := tx.Model(it).Updates(map[string]interface{}{
+				"unit_price":  newPrice,
+				"total_price": newPrice * it.Quantity,
+			}).Error; err != nil {
+				return err
+			}
+
+			// 2. 该明细的剩余库存批次（已全部出库则无行，跳过）
+			if err := tx.Model(&model.Inventory{}).
+				Where("shop_id = ? AND stock_in_item_id = ? AND deleted_at IS NULL", shopID, it.ID).
+				Update("unit_price", newPrice).Error; err != nil {
+				return err
+			}
+
+			// 3. 已出库行成本快照回填（按 product_id 精确命中；product_id=0 的历史导入单不传播）
+			if it.ProductID != 0 {
+				if err := tx.Model(&model.StockOutItem{}).
+					Where("shop_id = ? AND product_id = ?", shopID, it.ProductID).
+					Updates(map[string]interface{}{
+						"unit_price":  newPrice,
+						"total_price": gorm.Expr("? * quantity", newPrice),
+					}).Error; err != nil {
+					return err
+				}
+			}
+
+			// 同步 product 参考进价
+			if it.ProductID != 0 {
+				tx.Model(&model.Product{}).Where("id = ? AND shop_id = ?", it.ProductID, shopID).
+					Update("purchase_price", newPrice)
+			}
+		}
+
+		if totalDiff == 0 {
+			return nil
+		}
+
+		// 4. 入库单总额按差额重算
+		if err := tx.Model(&order).
+			Update("total_amount", gorm.Expr("total_amount + ?", totalDiff)).Error; err != nil {
+			return err
+		}
+
+		// 5. 应付差额调整流水（滚动余额）
+		bal := partnerLastBalance(tx, shopID, order.PartnerID) + totalDiff
+		oid := order.ID
+		return tx.Create(&model.FinanceRecord{
+			ShopID: shopID, PartnerID: order.PartnerID, Type: "payable",
+			Amount: totalDiff, Balance: bal, Status: "open",
+			RefType: "stock_in_cost_adjust", RefID: &oid, OperatorID: userID, RecordDate: now,
+		}).Error
+	})
+}
+
 // ApproveStockOut 审核出库单，FIFO 扣减批次库存
 func (s *StockService) ApproveStockOut(shopID, orderID, reviewerID uint64) error {
 	return s.db.Transaction(func(tx *gorm.DB) error {
@@ -0,0 +1,20 @@
+/// 单据打印的「门店抬头 + 制单人」元信息。
+///
+/// - 门店信息（公司名称/地址/电话）来自 `shopInfoProvider`，作为单据顶部抬头。
+/// - [makerName] = 制单人 = **当前登录、点击打印的人**（非单据经办人/审核人）。
+///   入库单的「采购员」「出库单的「销售员」才是单据经办人（operator）。
+class OrderPrintMeta {
+  final String shopName;
+  final String shopAddress;
+  final String shopPhone;
+
+  /// 制单人 = 当前登录用户（打印此单的人）。
+  final String makerName;
+
+  const OrderPrintMeta({
+    this.shopName = '',
+    this.shopAddress = '',
+    this.shopPhone = '',
+    this.makerName = '',
+  });
+}
@@ -5,6 +5,8 @@ import '../../models/stock_out.dart';
 import '../errors/error_reporter.dart';
 import 'label_data.dart';
 export 'label_data.dart';
+import 'order_print_meta.dart';
+export 'order_print_meta.dart';
 import 'print_util_stub.dart'
    if (dart.library.js_interop) 'print_util_web.dart';

@@ -47,11 +49,20 @@ Future<List<String>> listLabelPrinters() => listLabelPrintersImpl();
 /// 自动检测默认热敏打印机（名字含 deli/dl-888）；找不到或 Web 返回 null。
 Future<String?> detectDefaultPrinter() => detectDefaultPrinterImpl();

-Future<void> printStockInOrder(StockInOrder order) =>
-    printStockInOrderImpl(order);
+Future<void> printStockInOrder(StockInOrder order, OrderPrintMeta meta) =>
+    printStockInOrderImpl(order, meta);

-Future<void> printStockOutOrder(StockOutOrder order) =>
-    printStockOutOrderImpl(order);
+Future<void> printStockOutOrder(StockOutOrder order, OrderPrintMeta meta) =>
+    printStockOutOrderImpl(order, meta);
+
+/// 生成入库单 PDF 字节（桌面端真实排版，供打印预览光栅化用）；Web 端不支持。
+Future<Uint8List> buildStockInOrderPdf(StockInOrder order, OrderPrintMeta meta) =>
+    buildStockInOrderPdfImpl(order, meta);
+
+/// 生成出库单 PDF 字节（桌面端真实排版，供打印预览光栅化用）；Web 端不支持。
+Future<Uint8List> buildStockOutOrderPdf(
+        StockOutOrder order, OrderPrintMeta meta) =>
+    buildStockOutOrderPdfImpl(order, meta);

 /// 统一打印入口：catch 任意异常，上报并弹 SnackBar 给用户。
 /// 用法：await safePrint(context, () => printStockInOrder(order));
@@ -25,6 +25,7 @@ import 'package:printing/printing.dart';
 import '../../models/stock_in.dart';
 import '../../models/stock_out.dart';
 import 'label_data.dart';
+import 'order_print_meta.dart';

 Future<pw.Font> _loadFont() async {
  final data = await rootBundle.load('assets/fonts/NotoSansSC-Regular.ttf');
@@ -644,184 +645,275 @@ Future<List<String>> listLabelPrintersImpl() async {
 /// 自动检测默认热敏打印机（名字含 deli/dl-888）；找不到返回 null。
 Future<String?> detectDefaultPrinterImpl() => _findThermalPrinter();

+/// 截取日期前 10 位（yyyy-MM-dd），空值返回空串。
+String _d10(String? s) {
+  if (s == null || s.isEmpty) return '';
+  return s.length > 10 ? s.substring(0, 10) : s;
+}
+
+/// 数量格式化：整数不带小数，否则保留 3 位。
+String _qtyStr(double q) =>
+    q % 1 == 0 ? q.toStringAsFixed(0) : q.toStringAsFixed(3);
+
+/// 单据明细列（入库/出库统一）：商品编号→备注。
+const _orderHeaders = [
+  '商品编号', '商品名称', '系列', '规格', '批次号',
+  '生产日期', '数量', '单价', '金额', '备注',
+];
+const _orderColFlex = <double>[1.5, 2.0, 1.1, 1.3, 1.6, 1.3, 0.7, 1.1, 1.2, 0.9];
+
+/// 温馨提示文案（入库/出库统一）。
+const _kTipsText =
+    '温馨提示：签收时，请务必核对好酒品数量、年份和日期、批次及物流码，'
+    '如有问题及时反馈，酒品无质量问题一经售出概不退换，谢谢合作。';
+
+/// 各明细列对齐：系列/规格/批次号/生产日期居中，数量/单价/金额右对齐，其余左对齐。
+pw.TextAlign _colAlign(int i) {
+  switch (i) {
+    case 2:
+    case 3:
+    case 4:
+    case 5:
+      return pw.TextAlign.center;
+    case 6:
+    case 7:
+    case 8:
+      return pw.TextAlign.right;
+    default:
+      return pw.TextAlign.left;
+  }
+}
+
+/// 构建入库单/出库单 A4 版式（参照「锐浪报表」单据：公司抬头 + 两行三列表头
+/// + 明细表 + 单据总计 + 温馨提示 + 签字行）。入库/出库仅称谓不同。
 pw.Widget _buildOrderDoc({
  required pw.Font font,
  required pw.Font bold,
-  required String title,
+  required String shopName,        // 公司名称（顶部抬头）
+  required String title,           // 入 库 单 / 出 库 单
  required String orderNo,
-  required String? orderDate,
-  required String? partnerLabel,
+  required String noPrefix,        // 'NO：' / 'NO.'
+  required String partnerLabel,    // 单位名称 / 客户名称
  required String? partnerName,
+  required String dateLabel,       // 入库日期 / 出库日期
+  required String? orderDate,
+  required String addressLabel,    // 单位地址 / 送货地址
  required String? warehouseName,
+  required String signerLabel,     // 出货人（签字）/ 收货人（签字）
+  required String operatorRoleLabel, // 采购员 / 销售员（= 经办人）
  required String? operatorName,
-  required String? reviewerName,
+  required String? makerName,      // 制单人 = 打印人
  required String? remark,
-  required List<String> headers,
+  required bool showTips,
  required List<List<String>> rows,
  required double totalQty,
  required double totalAmt,
-  String? tipsText,
 }) {
-  final headerStyle = pw.TextStyle(font: bold, fontSize: 10, fontWeight: pw.FontWeight.bold);
-  final cellStyle = pw.TextStyle(font: font, fontSize: 9.5);
-  final metaStyle = pw.TextStyle(font: font, fontSize: 10);
-  final boldStyle = pw.TextStyle(font: bold, fontSize: 10, fontWeight: pw.FontWeight.bold);
+  // 样式三「紧凑报表」：左侧竖线点缀 + 抬头左对齐内联 + 灰底信息条 + 密集明细表
+  // + 数字等宽（内置 Courier，ASCII 数字适用）+ 灰底总计条。
+  final mono = pw.Font.courier();
+  final monoBold = pw.Font.courierBold();
+  final cellStyle = pw.TextStyle(font: font, fontSize: 8.5);
+  final numStyle = pw.TextStyle(font: mono, fontSize: 8.5);
+  final headStyle =
+      pw.TextStyle(font: bold, fontSize: 8.5, fontWeight: pw.FontWeight.bold);
+  final metaStyle = pw.TextStyle(font: font, fontSize: 9);
+  final metaBold =
+      pw.TextStyle(font: bold, fontSize: 9, fontWeight: pw.FontWeight.bold);

-  final colWidths = headers.map((h) {
-    if (h == '商品名称') return const pw.FlexColumnWidth(2.2);
-    if (h == '系列' || h == '规格') return const pw.FlexColumnWidth(1.2);
-    if (h == '商品编号') return const pw.FlexColumnWidth(1.2);
-    return const pw.FlexColumnWidth(0.9);
-  }).toList();
+  pw.Widget metaText(String label, String value, pw.TextAlign align) =>
+      pw.Text('$label：$value', style: metaStyle, textAlign: align);

-  return pw.Column(
-    crossAxisAlignment: pw.CrossAxisAlignment.start,
-    children: [
-      pw.Center(
-        child: pw.Text(title,
-            style: pw.TextStyle(font: bold, fontSize: 20, fontWeight: pw.FontWeight.bold)),
-      ),
-      pw.SizedBox(height: 8),
-      pw.Container(
-        decoration: const pw.BoxDecoration(
-          border: pw.Border(bottom: pw.BorderSide(color: PdfColors.grey600)),
-        ),
-        padding: const pw.EdgeInsets.only(bottom: 5),
-        child: pw.Row(
-          mainAxisAlignment: pw.MainAxisAlignment.spaceBetween,
+  return pw.Container(
+    // 左侧竖线点缀
+    decoration: const pw.BoxDecoration(
+      border: pw.Border(left: pw.BorderSide(color: PdfColors.black, width: 3)),
+    ),
+    padding: const pw.EdgeInsets.only(left: 14),
+    child: pw.Column(
+      crossAxisAlignment: pw.CrossAxisAlignment.stretch,
+      children: [
+        // ── 抬头：公司名 + 单据类型，左对齐内联 ──────────────────────────
+        pw.Row(
+          crossAxisAlignment: pw.CrossAxisAlignment.end,
          children: [
-            pw.Text('$partnerLabel：${partnerName ?? ''}', style: metaStyle),
-            pw.Text('日期：${orderDate ?? ''}', style: metaStyle),
-            pw.Text('NO: $orderNo', style: boldStyle),
+            pw.Text(shopName,
+                style: pw.TextStyle(
+                    font: bold, fontSize: 16, fontWeight: pw.FontWeight.bold)),
+            pw.SizedBox(width: 12),
+            pw.Padding(
+              padding: const pw.EdgeInsets.only(bottom: 1.5),
+              child: pw.Text(title,
+                  style: pw.TextStyle(
+                      font: font,
+                      fontSize: 11,
+                      letterSpacing: 3,
+                      color: PdfColors.grey700)),
+            ),
          ],
        ),
-      ),
-      pw.SizedBox(height: 4),
-      pw.Row(
-        children: [
-          pw.Text('仓库：${warehouseName ?? ''}', style: metaStyle),
-          pw.SizedBox(width: 24),
-          pw.Text('经办人：${operatorName ?? ''}', style: metaStyle),
-        ],
-      ),
-      pw.SizedBox(height: 8),
-      pw.Table(
-        border: pw.TableBorder.all(color: PdfColors.grey500),
-        columnWidths: { for (var i = 0; i < colWidths.length; i++) i: colWidths[i] },
-        children: [
-          pw.TableRow(
-            decoration: const pw.BoxDecoration(color: PdfColors.grey200),
-            children: headers.map((h) => pw.Padding(
-              padding: const pw.EdgeInsets.symmetric(horizontal: 3, vertical: 3),
-              child: pw.Text(h, textAlign: pw.TextAlign.center, style: headerStyle),
-            )).toList(),
-          ),
-          ...rows.map((row) => pw.TableRow(
-            children: row.map((cell) => pw.Padding(
-              padding: const pw.EdgeInsets.symmetric(horizontal: 3, vertical: 2),
-              child: pw.Text(cell, style: cellStyle),
-            )).toList(),
-          )),
-          pw.TableRow(
-            decoration: const pw.BoxDecoration(color: PdfColors.grey100),
-            children: List.generate(headers.length, (i) {
-              if (i == headers.length - 3) {
-                return pw.Padding(
-                  padding: const pw.EdgeInsets.symmetric(horizontal: 3, vertical: 2),
-                  child: pw.Text('单据总计', textAlign: pw.TextAlign.right, style: boldStyle),
-                );
-              }
-              if (i == headers.length - 2) {
-                return pw.Padding(
-                  padding: const pw.EdgeInsets.symmetric(horizontal: 3, vertical: 2),
-                  child: pw.Text(
-                    totalQty % 1 == 0 ? totalQty.toStringAsFixed(0) : totalQty.toStringAsFixed(3),
-                    textAlign: pw.TextAlign.right, style: boldStyle,
-                  ),
-                );
-              }
-              if (i == headers.length - 1) {
-                return pw.Padding(
-                  padding: const pw.EdgeInsets.symmetric(horizontal: 3, vertical: 2),
-                  child: pw.Text(totalAmt.toStringAsFixed(2),
-                      textAlign: pw.TextAlign.right, style: boldStyle),
-                );
-              }
-              return pw.SizedBox();
-            }),
-          ),
-        ],
-      ),
-      if ((remark ?? '').isNotEmpty) ...[
-        pw.SizedBox(height: 6),
-        pw.Text('备注：$remark', style: metaStyle),
-      ],
-      if (tipsText != null) ...[
-        pw.SizedBox(height: 6),
+        pw.SizedBox(height: 8),
+        // ── 抬头信息：灰底信息条（两行三列）────────────────────────────
        pw.Container(
          decoration: pw.BoxDecoration(
-            border: pw.Border.all(color: PdfColors.grey400),
-            color: PdfColors.grey50,
+            color: PdfColors.grey100,
+            border: pw.Border.all(color: PdfColors.grey400, width: 0.5),
+          ),
+          padding: const pw.EdgeInsets.symmetric(horizontal: 8, vertical: 6),
+          child: pw.Column(
+            children: [
+              pw.Row(
+                children: [
+                  pw.Expanded(
+                      flex: 5,
+                      child: metaText(
+                          partnerLabel, partnerName ?? '', pw.TextAlign.left)),
+                  pw.Expanded(
+                      flex: 4,
+                      child: metaText(
+                          dateLabel, _d10(orderDate), pw.TextAlign.left)),
+                  pw.Expanded(
+                      flex: 3,
+                      child: pw.Text('$noPrefix$orderNo',
+                          style: metaBold, textAlign: pw.TextAlign.right)),
+                ],
+              ),
+              pw.SizedBox(height: 3),
+              pw.Row(
+                children: [
+                  pw.Expanded(
+                      flex: 5,
+                      child: metaText('联系电话', '', pw.TextAlign.left)),
+                  pw.Expanded(
+                      flex: 4,
+                      child: metaText(addressLabel, '', pw.TextAlign.left)),
+                  pw.Expanded(
+                      flex: 3,
+                      child: metaText(
+                          '仓库', warehouseName ?? '', pw.TextAlign.right)),
+                ],
+              ),
+            ],
          ),
-          padding: const pw.EdgeInsets.all(5),
-          child: pw.Text(tipsText,
-              style: pw.TextStyle(font: font, fontSize: 9, color: PdfColors.grey700)),
        ),
-      ],
-      pw.SizedBox(height: 36),
-      pw.Row(
-        mainAxisAlignment: pw.MainAxisAlignment.spaceBetween,
-        children: [
-          _sig(font, bold, '收/出货人（签字）'),
-          _sig(font, bold, '经办人：${operatorName ?? ''}'),
-          _sig(font, bold, '制单人：${reviewerName ?? operatorName ?? ''}'),
+        pw.SizedBox(height: 8),
+        // ── 明细表（密集、灰底表头、数字等宽）──────────────────────────
+        pw.Table(
+          border: pw.TableBorder.all(color: PdfColors.grey500, width: 0.5),
+          columnWidths: {
+            for (var i = 0; i < _orderColFlex.length; i++)
+              i: pw.FlexColumnWidth(_orderColFlex[i])
+          },
+          children: [
+            pw.TableRow(
+              decoration: const pw.BoxDecoration(color: PdfColors.grey300),
+              children: [
+                for (final h in _orderHeaders)
+                  pw.Padding(
+                    padding: const pw.EdgeInsets.symmetric(
+                        horizontal: 2, vertical: 2.5),
+                    child: pw.Text(h,
+                        textAlign: pw.TextAlign.center, style: headStyle),
+                  ),
+              ],
+            ),
+            for (final row in rows)
+              pw.TableRow(
+                children: [
+                  for (var i = 0; i < row.length; i++)
+                    pw.Padding(
+                      padding: const pw.EdgeInsets.symmetric(
+                          horizontal: 3, vertical: 2),
+                      child: pw.Text(row[i],
+                          textAlign: _colAlign(i),
+                          style: (i >= 6 && i <= 8) ? numStyle : cellStyle),
+                    ),
+                ],
+              ),
+          ],
+        ),
+        // ── 单据总计：灰底条，右对齐，仅数量 + 金额（等宽数字）──────────
+        pw.SizedBox(height: 6),
+        pw.Container(
+          width: double.infinity,
+          decoration: pw.BoxDecoration(
+            color: PdfColors.grey100,
+            border: pw.Border.all(color: PdfColors.grey400, width: 0.5),
+          ),
+          padding: const pw.EdgeInsets.symmetric(horizontal: 10, vertical: 5),
+          child: pw.Row(
+            mainAxisAlignment: pw.MainAxisAlignment.end,
+            crossAxisAlignment: pw.CrossAxisAlignment.center,
+            children: [
+              pw.Text('单据总计', style: metaBold),
+              pw.SizedBox(width: 26),
+              pw.Text('数量 ', style: metaStyle),
+              pw.Text(_qtyStr(totalQty),
+                  style: pw.TextStyle(font: monoBold, fontSize: 11)),
+              pw.SizedBox(width: 26),
+              pw.Text('金额 ', style: metaStyle),
+              pw.Text(totalAmt.toStringAsFixed(2),
+                  style: pw.TextStyle(font: monoBold, fontSize: 12)),
+            ],
+          ),
+        ),
+        // ── 温馨提示（仅出库单）──────────────────────────────────────────
+        if (showTips) ...[
+          pw.SizedBox(height: 8),
+          pw.Container(
+            width: double.infinity,
+            decoration: pw.BoxDecoration(
+              border: pw.Border.all(color: PdfColors.grey400, width: 0.5),
+              color: PdfColors.grey50,
+            ),
+            padding: const pw.EdgeInsets.all(5),
+            child: pw.Text(_kTipsText,
+                style: pw.TextStyle(
+                    font: font, fontSize: 8.5, color: PdfColors.grey800)),
+          ),
        ],
-      ),
-    ],
-  );
-}
-
-pw.Widget _sig(pw.Font font, pw.Font bold, String label) {
-  return pw.Column(
-    children: [
-      pw.Container(width: 120, height: 28),
-      pw.Container(
-        width: 120,
-        decoration: const pw.BoxDecoration(
-          border: pw.Border(top: pw.BorderSide(color: PdfColors.grey700)),
+        pw.SizedBox(height: 24),
+        // ── 签字行：签收人 / 经办人 / 制单人 ──────────────────────────────
+        pw.Row(
+          mainAxisAlignment: pw.MainAxisAlignment.spaceBetween,
+          children: [
+            pw.Text('$signerLabel：', style: metaStyle),
+            pw.Text('$operatorRoleLabel：${operatorName ?? ''}',
+                style: metaStyle),
+            pw.Text('制单人：${makerName ?? ''}', style: metaStyle),
+          ],
        ),
-        padding: const pw.EdgeInsets.only(top: 3),
-        child: pw.Text(label,
-            textAlign: pw.TextAlign.center,
-            style: pw.TextStyle(font: font, fontSize: 10)),
-      ),
-    ],
+        if ((remark ?? '').isNotEmpty) ...[
+          pw.SizedBox(height: 10),
+          pw.Text('备注：$remark', style: metaStyle),
+        ],
+      ],
+    ),
  );
 }

-Future<void> printStockInOrderImpl(StockInOrder order) async {
-  try {
+/// 生成入库单 A4 PDF 字节（与实际打印同一套排版，供预览光栅化 + 打印共用）。
+Future<Uint8List> buildStockInOrderPdfImpl(
+    StockInOrder order, OrderPrintMeta meta) async {
  final font = await _loadFont();
  final bold = await _loadBoldFont();

  double totalQty = 0, totalAmt = 0;
  final rows = <List<String>>[];
-  for (int i = 0; i < order.items.length; i++) {
-    final it = order.items[i];
+  for (final it in order.items) {
    totalQty += it.quantity;
    totalAmt += it.totalPrice;
    rows.add([
-      '${i + 1}',
      it.productCode ?? '',
      it.productName ?? '',
      it.productSeries ?? '',
      it.productSpec ?? '',
-      it.quantity % 1 == 0 ? it.quantity.toStringAsFixed(0) : it.quantity.toStringAsFixed(3),
-      it.productUnit ?? '',
+      it.batchNo ?? '',
+      _d10(it.productionDate),
+      _qtyStr(it.quantity),
      it.unitPrice.toStringAsFixed(2),
      it.totalPrice.toStringAsFixed(2),
-      it.productionDate ?? '',
-      it.batchNo ?? '',
+      '',
    ]);
  }

@@ -832,23 +924,35 @@ Future<void> printStockInOrderImpl(StockInOrder order) async {
    build: (_) => [
      _buildOrderDoc(
        font: font, bold: bold,
+        shopName: meta.shopName,
        title: '入 库 单',
        orderNo: order.orderNo,
-        orderDate: order.orderDate,
-        partnerLabel: '供应商',
+        noPrefix: 'NO：',
+        partnerLabel: '单位名称',
        partnerName: order.partnerName,
+        dateLabel: '入库日期',
+        orderDate: order.orderDate,
+        addressLabel: '单位地址',
        warehouseName: order.warehouseName,
+        signerLabel: '出货人（签字）',
+        operatorRoleLabel: '采购员',
        operatorName: order.operatorName,
-        reviewerName: order.reviewerName,
+        makerName: meta.makerName,
        remark: order.remark,
-        headers: ['序号', '商品编号', '商品名称', '系列', '规格', '数量', '单位', '单价', '金额', '生产日期', '批次'],
+        showTips: false,
        rows: rows,
        totalQty: totalQty,
        totalAmt: totalAmt,
      ),
    ],
  ));
-    final bytes = await doc.save();
+  return doc.save();
+}
+
+Future<void> printStockInOrderImpl(
+    StockInOrder order, OrderPrintMeta meta) async {
+  try {
+    final bytes = await buildStockInOrderPdfImpl(order, meta);
    if (!kIsWeb && Platform.isMacOS) {
      await Future<void>.delayed(Duration.zero);
    }
@@ -862,26 +966,32 @@ Future<void> printStockInOrderImpl(StockInOrder order) async {
  }
 }

-Future<void> printStockOutOrderImpl(StockOutOrder order) async {
+/// 生成出库单 A4 PDF 字节（与实际打印同一套排版，供预览光栅化 + 打印共用）。
+Future<Uint8List> buildStockOutOrderPdfImpl(
+    StockOutOrder order, OrderPrintMeta meta) async {
  final font = await _loadFont();
  final bold = await _loadBoldFont();

  double totalQty = 0, totalAmt = 0;
  final rows = <List<String>>[];
-  for (int i = 0; i < order.items.length; i++) {
-    final it = order.items[i];
+  for (final it in order.items) {
+    // 出库单「单价」= 售价：App 单据存 sale_price；历史导入单 sale_price=0、
+    // 实际售价存在 unit_price/total_price，故 sale_price 为空时回退到 unit_price。
+    final unit = it.salePrice > 0 ? it.salePrice : it.unitPrice;
+    final amt = it.salePrice > 0 ? it.salePrice * it.quantity : it.totalPrice;
    totalQty += it.quantity;
-    totalAmt += it.totalPrice;
+    totalAmt += amt;
    rows.add([
-      '${i + 1}',
      it.productCode ?? '',
      it.productName ?? '',
      it.productSeries ?? '',
      it.productSpec ?? '',
-      it.productUnit ?? '',
-      it.quantity % 1 == 0 ? it.quantity.toStringAsFixed(0) : it.quantity.toStringAsFixed(3),
-      it.unitPrice.toStringAsFixed(2),
-      it.totalPrice.toStringAsFixed(2),
+      it.batchNo ?? '',
+      _d10(it.productionDate),
+      _qtyStr(it.quantity),
+      unit.toStringAsFixed(2),
+      amt.toStringAsFixed(2),
+      '',
    ]);
  }

@@ -892,25 +1002,35 @@ Future<void> printStockOutOrderImpl(StockOutOrder order) async {
    build: (_) => [
      _buildOrderDoc(
        font: font, bold: bold,
+        shopName: meta.shopName,
        title: '出 库 单',
        orderNo: order.orderNo,
-        orderDate: order.orderDate,
-        partnerLabel: '客户',
+        noPrefix: 'NO.',
+        partnerLabel: '客户名称',
        partnerName: order.partnerName,
+        dateLabel: '出库日期',
+        orderDate: order.orderDate,
+        addressLabel: '送货地址',
        warehouseName: order.warehouseName,
+        signerLabel: '收货人（签字）',
+        operatorRoleLabel: '销售员',
        operatorName: order.operatorName,
-        reviewerName: order.reviewerName,
+        makerName: meta.makerName,
        remark: order.remark,
-        headers: ['序号', '商品编号', '商品名称', '系列', '规格', '单位', '数量', '单价', '金额'],
+        showTips: true,
        rows: rows,
        totalQty: totalQty,
        totalAmt: totalAmt,
-        tipsText: '温馨提示：签收时，请务必核对好酒品数量、年份和日期、批次及物流码，如有问题及时反馈，酒品无质量问题一经售出概不退换，谢谢合作。',
      ),
    ],
  ));
+  return doc.save();
+}
+
+Future<void> printStockOutOrderImpl(
+    StockOutOrder order, OrderPrintMeta meta) async {
  try {
-    final bytes = await doc.save();
+    final bytes = await buildStockOutOrderPdfImpl(order, meta);
    if (!kIsWeb && Platform.isMacOS) {
      await Future<void>.delayed(Duration.zero);
    }
@@ -6,6 +6,7 @@ import '../../models/stock_in.dart';
 import '../../models/stock_out.dart';
 import '../errors/error_reporter.dart';
 import 'label_data.dart';
+import 'order_print_meta.dart';

 void _openPrintWindow(String html) {
  final win = web.window.open('', '_blank');
@@ -170,28 +171,85 @@ body { width: 38mm; height: 20mm; overflow: hidden; background: #fff; }
  }
 }

+// ── 单据 PDF 字节（Web 走 HTML 打印路径，不生成 PDF；预览弹窗仅桌面端调用）──────
+
+Future<Uint8List> buildStockInOrderPdfImpl(
+        StockInOrder order, OrderPrintMeta meta) async =>
+    throw UnsupportedError('Web 端入库单走 HTML 打印，不生成 PDF');
+
+Future<Uint8List> buildStockOutOrderPdfImpl(
+        StockOutOrder order, OrderPrintMeta meta) async =>
+    throw UnsupportedError('Web 端出库单走 HTML 打印，不生成 PDF');
+
+/// 单据打印共用样式（样式三「紧凑报表」：左侧竖线 + 抬头左对齐内联 +
+/// 灰底信息条 + 密集明细表 + 数字等宽 + 灰底总计条；入库/出库一致）。
+const String _orderPrintCss = '''
+  @page { size: A4; margin: 12mm 14mm; }
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body { font-family: "PingFang SC", "Microsoft YaHei", "SimSun", sans-serif; color: #111; border-left: 3px solid #111; padding-left: 14px; }
+  .shop { display: inline; font-size: 19px; font-weight: 700; }
+  .title { display: inline; margin-left: 12px; font-size: 13px; letter-spacing: 4px; color: #444; }
+  .head-block { background: #f3f3f3; border: 1px solid #ccc; padding: 7px 10px; margin: 10px 0; }
+  .meta-row { display: flex; font-size: 11.5px; line-height: 1.9; }
+  .meta-row + .meta-row { margin-top: 2px; }
+  .meta-row .c1 { flex: 5; } .meta-row .c2 { flex: 4; } .meta-row .c3 { flex: 3; text-align: right; }
+  .meta-row .no { font-weight: 700; }
+  table { width: 100%; border-collapse: collapse; border: 1px solid #bbb; }
+  th { background: #e5e5e5; border: 1px solid #bbb; padding: 5px 5px; font-size: 11px; font-weight: 700; text-align: center; white-space: nowrap; }
+  td { border: 1px solid #ccc; padding: 4px 6px; font-size: 11px; }
+  .c { text-align: center; } .r { text-align: right; }
+  td.r { font-family: "SF Mono", "Roboto Mono", Menlo, Consolas, monospace; }
+  .subtotal-bar { display: flex; justify-content: flex-end; align-items: baseline; gap: 28px; border: 1px solid #bbb; background: #f3f3f3; padding: 7px 12px; margin-top: 8px; font-size: 12px; font-weight: 700; }
+  .subtotal-bar .lbl-total { margin-right: auto; }
+  .subtotal-bar b { font-size: 14px; font-family: "SF Mono", Menlo, Consolas, monospace; }
+  .tips { border: 1px solid #ddd; background: #fafafa; padding: 6px 8px; margin: 8px 0; font-size: 10px; color: #555; line-height: 1.6; }
+  .sigs { display: flex; justify-content: space-between; margin-top: 30px; font-size: 12px; }
+  .remark { margin-top: 10px; font-size: 11px; color: #333; }
+''';
+
+const String _orderTipsHtml =
+    '<div class="tips">温馨提示：签收时，请务必核对好酒品数量、年份和日期、批次及物流码，'
+    '如有问题及时反馈，酒品无质量问题一经售出概不退换，谢谢合作。</div>';
+
+/// 截取日期前 10 位（yyyy-MM-dd）。
+String _d10(String? s) =>
+    (s == null || s.isEmpty) ? '' : (s.length > 10 ? s.substring(0, 10) : s);
+
+/// 单据明细表头（入库/出库一致）。
+const String _orderTableHead = '''<thead><tr>
+      <th style="width:12%">商品编号</th>
+      <th style="width:16%">商品名称</th>
+      <th style="width:9%">系列</th>
+      <th style="width:10%">规格</th>
+      <th style="width:14%">批次号</th>
+      <th style="width:11%">生产日期</th>
+      <th style="width:5%">数量</th>
+      <th style="width:8%">单价</th>
+      <th style="width:9%">金额</th>
+      <th style="width:6%">备注</th>
+    </tr></thead>''';
+
 // ── 入库单 ──────────────────────────────────────────────────────────────────

-Future<void> printStockInOrderImpl(StockInOrder order) async {
+Future<void> printStockInOrderImpl(
+    StockInOrder order, OrderPrintMeta meta) async {
  final rows = StringBuffer();
  double totalQty = 0;
  double totalAmt = 0;
-  for (int i = 0; i < order.items.length; i++) {
-    final item = order.items[i];
+  for (final item in order.items) {
    totalQty += item.quantity;
    totalAmt += item.totalPrice;
    rows.write('''<tr>
-      <td class="c">${i + 1}</td>
      <td>${item.productCode ?? ''}</td>
      <td>${item.productName ?? ''}</td>
      <td class="c">${item.productSeries ?? ''}</td>
      <td class="c">${item.productSpec ?? ''}</td>
+      <td class="c">${item.batchNo ?? ''}</td>
+      <td class="c">${_d10(item.productionDate)}</td>
      <td class="r">${item.quantity % 1 == 0 ? item.quantity.toStringAsFixed(0) : item.quantity.toStringAsFixed(3)}</td>
-      <td class="c">${item.productUnit ?? ''}</td>
      <td class="r">${item.unitPrice.toStringAsFixed(2)}</td>
      <td class="r">${item.totalPrice.toStringAsFixed(2)}</td>
-      <td class="c">${item.productionDate ?? ''}</td>
-      <td class="c">${item.batchNo ?? ''}</td>
+      <td></td>
    </tr>''');
  }

@@ -203,72 +261,38 @@ Future<void> printStockInOrderImpl(StockInOrder order) async {
 <html>
 <head>
 <meta charset="utf-8">
-<style>
-  @page { size: A4; margin: 12mm 15mm; }
-  * { box-sizing: border-box; margin: 0; padding: 0; }
-  body { font-family: "PingFang SC", "Microsoft YaHei", "SimSun", sans-serif; font-size: 11px; color: #000; }
-  .hdr { text-align: center; margin-bottom: 10px; }
-  .hdr .title { font-size: 22px; font-weight: bold; margin-bottom: 4px; }
-  .meta { display: flex; justify-content: space-between; align-items: flex-end; margin-bottom: 6px; border-bottom: 1px solid #666; padding-bottom: 5px; }
-  .meta .left, .meta .center, .meta .right { flex: 1; }
-  .meta .center { text-align: center; }
-  .meta .right { text-align: right; font-weight: bold; font-size: 12px; }
-  .meta2 { display: flex; gap: 24px; margin-bottom: 8px; font-size: 11px; }
-  table { width: 100%; border-collapse: collapse; margin-bottom: 4px; }
-  th, td { border: 1px solid #999; padding: 4px 5px; }
-  th { background: #f0f0f0; font-weight: 600; text-align: center; font-size: 11px; }
-  td { font-size: 10.5px; }
-  .c { text-align: center; }
-  .r { text-align: right; }
-  .subtotal { font-weight: bold; background: #f7f7f7; }
-  .remark { margin: 6px 0; font-size: 11px; color: #333; }
-  .sigs { display: flex; justify-content: space-between; margin-top: 28px; }
-  .sig { text-align: center; min-width: 120px; }
-  .sig-line { border-top: 1px solid #555; padding-top: 4px; margin-top: 28px; font-size: 11px; }
-  .footer-note { text-align: right; font-size: 9px; color: #aaa; margin-top: 6px; }
-</style>
+<style>$_orderPrintCss</style>
 </head>
 <body>
-  <div class="hdr"><div class="title">入 库 单</div></div>
-  <div class="meta">
-    <div class="left">供应商：${order.partnerName ?? ''}</div>
-    <div class="center">入库日期：${order.orderDate ?? ''}</div>
-    <div class="right">NO: ${order.orderNo}</div>
-  </div>
-  <div class="meta2">
-    <span>仓库：${order.warehouseName ?? ''}</span>
-    <span>采购人：${order.operatorName ?? ''}</span>
+  <div class="shop">${meta.shopName}</div>
+  <div class="title">入 库 单</div>
+  <div class="head-block">
+    <div class="meta-row">
+      <div class="c1">单位名称：${order.partnerName ?? ''}</div>
+      <div class="c2">入库日期：${_d10(order.orderDate)}</div>
+      <div class="c3 no">NO：${order.orderNo}</div>
+    </div>
+    <div class="meta-row">
+      <div class="c1">联系电话：</div>
+      <div class="c2">单位地址：</div>
+      <div class="c3">仓库：${order.warehouseName ?? ''}</div>
+    </div>
  </div>
  <table>
-    <thead><tr>
-      <th style="width:3%">序号</th>
-      <th style="width:9%">商品编号</th>
-      <th style="width:18%">商品名称</th>
-      <th style="width:10%">系列</th>
-      <th style="width:9%">规格</th>
-      <th style="width:5%">数量</th>
-      <th style="width:5%">单位</th>
-      <th style="width:8%">单价</th>
-      <th style="width:8%">金额</th>
-      <th style="width:10%">生产日期</th>
-      <th style="width:10%">批次号</th>
-    </tr></thead>
+    $_orderTableHead
    <tbody>$rows</tbody>
-    <tfoot><tr class="subtotal">
-      <td colspan="5" class="r">单据总计</td>
-      <td class="r">${totalQty % 1 == 0 ? totalQty.toStringAsFixed(0) : totalQty.toStringAsFixed(3)}</td>
-      <td></td><td></td>
-      <td class="r">${totalAmt.toStringAsFixed(2)}</td>
-      <td colspan="2"></td>
-    </tr></tfoot>
  </table>
-  $remarkLine
-  <div class="sigs">
-    <div class="sig"><div class="sig-line">出货人（签字）</div></div>
-    <div class="sig"><div class="sig-line">采购员：${order.operatorName ?? ''}</div></div>
-    <div class="sig"><div class="sig-line">制单人：${order.reviewerName ?? order.operatorName ?? ''}</div></div>
+  <div class="subtotal-bar">
+    <span class="lbl-total">单据总计</span>
+    <span>数量 <b>${totalQty % 1 == 0 ? totalQty.toStringAsFixed(0) : totalQty.toStringAsFixed(3)}</b></span>
+    <span>金额 <b>${totalAmt.toStringAsFixed(2)}</b></span>
  </div>
-  <div class="footer-note">酒库管理系统</div>
+  <div class="sigs">
+    <span>出货人（签字）：</span>
+    <span>采购员：${order.operatorName ?? ''}</span>
+    <span>制单人：${meta.makerName}</span>
+  </div>
+  $remarkLine
  <script>window.onload = function(){ window.print(); };</script>
 </body>
 </html>''';
@@ -291,24 +315,30 @@ Future<String?> detectDefaultPrinterImpl() async => null;

 // ── 出库单 ──────────────────────────────────────────────────────────────────

-Future<void> printStockOutOrderImpl(StockOutOrder order) async {
+Future<void> printStockOutOrderImpl(
+    StockOutOrder order, OrderPrintMeta meta) async {
  final rows = StringBuffer();
  double totalQty = 0;
  double totalAmt = 0;
-  for (int i = 0; i < order.items.length; i++) {
-    final item = order.items[i];
+  for (final item in order.items) {
+    // 出库单「单价」= 售价：App 单据存 sale_price；历史导入单 sale_price=0、
+    // 实际售价存在 unit_price/total_price，故 sale_price 为空时回退到 unit_price。
+    final unit = item.salePrice > 0 ? item.salePrice : item.unitPrice;
+    final amt =
+        item.salePrice > 0 ? item.salePrice * item.quantity : item.totalPrice;
    totalQty += item.quantity;
-    totalAmt += item.totalPrice;
+    totalAmt += amt;
    rows.write('''<tr>
-      <td class="c">${i + 1}</td>
      <td>${item.productCode ?? ''}</td>
      <td>${item.productName ?? ''}</td>
      <td class="c">${item.productSeries ?? ''}</td>
      <td class="c">${item.productSpec ?? ''}</td>
-      <td class="c">${item.productUnit ?? ''}</td>
+      <td class="c">${item.batchNo ?? ''}</td>
+      <td class="c">${_d10(item.productionDate)}</td>
      <td class="r">${item.quantity % 1 == 0 ? item.quantity.toStringAsFixed(0) : item.quantity.toStringAsFixed(3)}</td>
-      <td class="r">${item.unitPrice.toStringAsFixed(2)}</td>
-      <td class="r">${item.totalPrice.toStringAsFixed(2)}</td>
+      <td class="r">${unit.toStringAsFixed(2)}</td>
+      <td class="r">${amt.toStringAsFixed(2)}</td>
+      <td></td>
    </tr>''');
  }

@@ -320,71 +350,39 @@ Future<void> printStockOutOrderImpl(StockOutOrder order) async {
 <html>
 <head>
 <meta charset="utf-8">
-<style>
-  @page { size: A4; margin: 12mm 15mm; }
-  * { box-sizing: border-box; margin: 0; padding: 0; }
-  body { font-family: "PingFang SC", "Microsoft YaHei", "SimSun", sans-serif; font-size: 11px; color: #000; }
-  .hdr { text-align: center; margin-bottom: 10px; }
-  .hdr .title { font-size: 22px; font-weight: bold; margin-bottom: 4px; }
-  .meta { display: flex; justify-content: space-between; align-items: flex-end; margin-bottom: 6px; border-bottom: 1px solid #666; padding-bottom: 5px; }
-  .meta .left, .meta .center, .meta .right { flex: 1; }
-  .meta .center { text-align: center; }
-  .meta .right { text-align: right; font-weight: bold; font-size: 12px; }
-  .meta2 { display: flex; gap: 24px; margin-bottom: 8px; font-size: 11px; }
-  table { width: 100%; border-collapse: collapse; margin-bottom: 4px; }
-  th, td { border: 1px solid #999; padding: 4px 5px; }
-  th { background: #f0f0f0; font-weight: 600; text-align: center; font-size: 11px; }
-  td { font-size: 10.5px; }
-  .c { text-align: center; }
-  .r { text-align: right; }
-  .subtotal { font-weight: bold; background: #f7f7f7; }
-  .remark { margin: 6px 0; font-size: 11px; color: #333; }
-  .tips { border: 1px solid #ddd; background: #fafafa; padding: 6px 8px; margin: 8px 0; font-size: 10px; color: #555; line-height: 1.6; }
-  .sigs { display: flex; justify-content: space-between; margin-top: 28px; }
-  .sig { text-align: center; min-width: 120px; }
-  .sig-line { border-top: 1px solid #555; padding-top: 4px; margin-top: 28px; font-size: 11px; }
-  .footer-note { text-align: right; font-size: 9px; color: #aaa; margin-top: 6px; }
-</style>
+<style>$_orderPrintCss</style>
 </head>
 <body>
-  <div class="hdr"><div class="title">出 库 单</div></div>
-  <div class="meta">
-    <div class="left">客户：${order.partnerName ?? ''}</div>
-    <div class="center">出库日期：${order.orderDate ?? ''}</div>
-    <div class="right">NO.${order.orderNo}</div>
-  </div>
-  <div class="meta2">
-    <span>仓库：${order.warehouseName ?? ''}</span>
-    <span>经办人：${order.operatorName ?? ''}</span>
+  <div class="shop">${meta.shopName}</div>
+  <div class="title">出 库 单</div>
+  <div class="head-block">
+    <div class="meta-row">
+      <div class="c1">客户名称：${order.partnerName ?? ''}</div>
+      <div class="c2">出库日期：${_d10(order.orderDate)}</div>
+      <div class="c3 no">NO.${order.orderNo}</div>
+    </div>
+    <div class="meta-row">
+      <div class="c1">联系电话：</div>
+      <div class="c2">送货地址：</div>
+      <div class="c3">仓库：${order.warehouseName ?? ''}</div>
+    </div>
  </div>
  <table>
-    <thead><tr>
-      <th style="width:3%">序号</th>
-      <th style="width:9%">商品编号</th>
-      <th style="width:20%">商品名称</th>
-      <th style="width:11%">系列</th>
-      <th style="width:10%">规格</th>
-      <th style="width:5%">单位</th>
-      <th style="width:5%">数量</th>
-      <th style="width:9%">单价</th>
-      <th style="width:9%">金额</th>
-    </tr></thead>
+    $_orderTableHead
    <tbody>$rows</tbody>
-    <tfoot><tr class="subtotal">
-      <td colspan="6" class="r">单据总计</td>
-      <td class="r">${totalQty % 1 == 0 ? totalQty.toStringAsFixed(0) : totalQty.toStringAsFixed(3)}</td>
-      <td></td>
-      <td class="r">${totalAmt.toStringAsFixed(2)}</td>
-    </tr></tfoot>
  </table>
-  $remarkLine
-  <div class="tips">温馨提示：签收时，请务必核对好酒品数量、年份和日期、批次及物流码，如有问题及时反馈，酒品无质量问题一经售出概不退换，谢谢合作。</div>
-  <div class="sigs">
-    <div class="sig"><div class="sig-line">收货人（签字）</div></div>
-    <div class="sig"><div class="sig-line">销售员：${order.operatorName ?? ''}</div></div>
-    <div class="sig"><div class="sig-line">制单人：${order.reviewerName ?? order.operatorName ?? ''}</div></div>
+  <div class="subtotal-bar">
+    <span class="lbl-total">单据总计</span>
+    <span>数量 <b>${totalQty % 1 == 0 ? totalQty.toStringAsFixed(0) : totalQty.toStringAsFixed(3)}</b></span>
+    <span>金额 <b>${totalAmt.toStringAsFixed(2)}</b></span>
  </div>
-  <div class="footer-note">酒库管理系统</div>
+  $_orderTipsHtml
+  <div class="sigs">
+    <span>收货人（签字）：</span>
+    <span>销售员：${order.operatorName ?? ''}</span>
+    <span>制单人：${meta.makerName}</span>
+  </div>
+  $remarkLine
  <script>window.onload = function(){ window.print(); };</script>
 </body>
 </html>''';
@@ -61,8 +61,9 @@ class StockOutItem {
        productSeries: lineOrProduct('series', 'series'),
        productSpec: lineOrProduct('spec', 'spec'),
        productUnit: (json['product'] as Map<String, dynamic>?)?['unit'] as String?,
-        batchNo: json['batch_no'] as String?,
-        productionDate: json['production_date'] as String?,
+        // 批次号/生产日期：优先明细行快照，回退 product 关联（App 新建单据快照列常为空）
+        batchNo: lineOrProduct('batch_no', 'batch_no'),
+        productionDate: lineOrProduct('production_date', 'production_date'),
      );
  }
 }
@@ -1,3 +1,5 @@
+import 'dart:async';
+
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import '../core/api/api_client.dart';
 import '../core/auth/auth_state.dart';
@@ -25,9 +27,11 @@ class StockInListNotifier extends AsyncNotifier<PageResult<StockInOrder>> {
  String? _endDate;
  String _keyword = '';
  PageResult<StockInOrder>? _cache;
+  Timer? _searchDebounce;

  @override
  Future<PageResult<StockInOrder>> build() async {
+    ref.onDispose(() => _searchDebounce?.cancel());
    ref.watch(authStateProvider.select((s) => s.user?.shopId));
    ref.watch(networkRecoveryCountProvider);
    try {
@@ -65,6 +69,8 @@ class StockInListNotifier extends AsyncNotifier<PageResult<StockInOrder>> {
  /// 当前服务端状态过滤值（供页面进入时对齐标签/下拉，避免重复拉取）
  String get currentStatus => _status;

+  String get currentKeyword => _keyword;
+
  void setStatus(String status) {
    _status = status;
    _page = 1;
@@ -78,10 +84,17 @@ class StockInListNotifier extends AsyncNotifier<PageResult<StockInOrder>> {
    reload();
  }

+  /// 关键词搜索（含酒名模糊反查，单次约 55ms 的明细扫描）。
+  /// 去重 + 防抖限流：同词不重查；连发回车/狂点合并取最后一次，避免昂贵查询被刷。
  void setKeyword(String keyword) {
-    _keyword = keyword;
-    _page = 1;
-    reload();
+    final kw = keyword.trim();
+    if (kw == _keyword) return;
+    _searchDebounce?.cancel();
+    _searchDebounce = Timer(const Duration(milliseconds: 350), () {
+      _keyword = kw;
+      _page = 1;
+      reload();
+    });
  }

  void reload() {
@@ -1,3 +1,5 @@
+import 'dart:async';
+
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import '../core/api/api_client.dart';
 import '../core/auth/auth_state.dart';
@@ -26,9 +28,11 @@ class StockOutListNotifier extends AsyncNotifier<PageResult<StockOutOrder>> {
  String _keyword = '';
  String _productCode = '';
  PageResult<StockOutOrder>? _cache;
+  Timer? _searchDebounce;

  @override
  Future<PageResult<StockOutOrder>> build() async {
+    ref.onDispose(() => _searchDebounce?.cancel());
    ref.watch(authStateProvider.select((s) => s.user?.shopId));
    ref.watch(networkRecoveryCountProvider);
    try {
@@ -67,6 +71,8 @@ class StockOutListNotifier extends AsyncNotifier<PageResult<StockOutOrder>> {
  /// 当前服务端状态过滤值（供页面进入时对齐标签/下拉，避免重复拉取）
  String get currentStatus => _status;

+  String get currentKeyword => _keyword;
+
  void setStatus(String status) {
    _status = status;
    _page = 1;
@@ -80,10 +86,17 @@ class StockOutListNotifier extends AsyncNotifier<PageResult<StockOutOrder>> {
    reload();
  }

+  /// 关键词搜索（含酒名模糊反查，单次约 55ms 的明细扫描）。
+  /// 去重 + 防抖限流：同词不重查；连发回车/狂点合并取最后一次，避免昂贵查询被刷。
  void setKeyword(String keyword) {
-    _keyword = keyword;
-    _page = 1;
-    reload();
+    final kw = keyword.trim();
+    if (kw == _keyword) return;
+    _searchDebounce?.cancel();
+    _searchDebounce = Timer(const Duration(milliseconds: 350), () {
+      _keyword = kw;
+      _page = 1;
+      reload();
+    });
  }

  /// 按商品编码精确反查（独立于 keyword）
@@ -142,4 +142,17 @@ class StockInRepository {
      );
    }
  }
+
+  /// 确认进价：把指定明细的暂估 0 价补成真实进价（前向补偿成本与应付）。
+  /// items 形如 [{'item_id': 1, 'unit_price': 50.0}]。
+  Future<void> confirmCost(int id, List<Map<String, dynamic>> items) async {
+    try {
+      await _client.post('/stock-in/orders/$id/confirm-cost', data: {'items': items});
+    } on DioException catch (e) {
+      throw AppException(
+        e.response?.data?['error'] as String? ?? '确认进价失败',
+        statusCode: e.response?.statusCode,
+      );
+    }
+  }
 }
@@ -312,7 +312,10 @@ class _InventoryListScreenState extends ConsumerState<InventoryListScreen> {
          style: const TextStyle(fontFamily: 'monospace', fontSize: 12))),
      'warehouse' => DataCell(Text(item.warehouseName.isEmpty ? '-' : item.warehouseName)),
      'price' => DataCell(Text(
-          item.unitPrice != null ? '¥${item.unitPrice!.toStringAsFixed(2)}' : '-')),
+          item.unitPrice != null ? '¥${item.unitPrice!.toStringAsFixed(2)}' : '待定价',
+          style: item.unitPrice == null
+              ? const TextStyle(color: AppTheme.warning)
+              : null)),
      'prodDate' => DataCell(Text(item.productionDate ?? '-')),
      'inTime' => DataCell(Text(
          item.createdAt != null && item.createdAt!.length >= 10
@@ -358,8 +361,8 @@ class _InventoryListScreenState extends ConsumerState<InventoryListScreen> {
        if (item.series.isNotEmpty) MobileCardField('系列', item.series),
        if (item.batchNo.isNotEmpty) MobileCardField('批次', item.batchNo),
        MobileCardField('仓库', item.warehouseName.isEmpty ? '-' : item.warehouseName),
-        if (item.unitPrice != null)
-          MobileCardField('单价', '¥${item.unitPrice!.toStringAsFixed(2)}'),
+        MobileCardField('单价',
+            item.unitPrice != null ? '¥${item.unitPrice!.toStringAsFixed(2)}' : '待定价'),
        if (item.supplierName.isNotEmpty)
          MobileCardField('供应商', item.supplierName),
      ],
@@ -9,6 +9,7 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
 import '../../core/config/app_config.dart';
 import '../../core/utils/print_util.dart';
 import '../../widgets/label_preview_dialog.dart';
+import '../../widgets/fullscreen_image_viewer.dart';
 import '../../widgets/write_guard.dart';
 import '../../core/theme/app_theme.dart';
 import '../../models/product.dart';
@@ -309,9 +310,16 @@ class _ProductDetailScreenState extends ConsumerState<ProductDetailScreen> {
          height: 120,
          child: Row(
            children: [
-              ...p.images.map((img) => _ImageThumbnail(
-                    url: AppConfig.baseUrl + img.url,
-                    onDelete: () => _deleteImage(img),
+              ...p.images.asMap().entries.map((e) => _ImageThumbnail(
+                    url: AppConfig.baseUrl + e.value.url,
+                    onDelete: () => _deleteImage(e.value),
+                    onView: () => showFullscreenImages(
+                      context,
+                      p.images
+                          .map((img) => AppConfig.baseUrl + img.url)
+                          .toList(),
+                      initialIndex: e.key,
+                    ),
                  )),
              if (p.images.length < 5)
                WriteGuard(
@@ -567,7 +575,9 @@ class _ProductDetailScreenState extends ConsumerState<ProductDetailScreen> {
 class _ImageThumbnail extends StatelessWidget {
  final String url;
  final VoidCallback onDelete;
-  const _ImageThumbnail({required this.url, required this.onDelete});
+  final VoidCallback onView;
+  const _ImageThumbnail(
+      {required this.url, required this.onDelete, required this.onView});

  @override
  Widget build(BuildContext context) {
@@ -575,19 +585,22 @@ class _ImageThumbnail extends StatelessWidget {
      padding: const EdgeInsets.only(right: 8),
      child: Stack(
        children: [
-          ClipRRect(
-            borderRadius: BorderRadius.circular(4),
-            child: Image.network(
-              url,
-              width: 110,
-              height: 110,
-              fit: BoxFit.cover,
-              errorBuilder: (_, __, ___) => Container(
+          GestureDetector(
+            onDoubleTap: onView,
+            child: ClipRRect(
+              borderRadius: BorderRadius.circular(4),
+              child: Image.network(
+                url,
                width: 110,
                height: 110,
-                color: AppTheme.border,
-                child: const Icon(Icons.broken_image,
-                    color: AppTheme.textSecondary),
+                fit: BoxFit.cover,
+                errorBuilder: (_, __, ___) => Container(
+                  width: 110,
+                  height: 110,
+                  color: AppTheme.border,
+                  child: const Icon(Icons.broken_image,
+                      color: AppTheme.textSecondary),
+                ),
              ),
            ),
          ),
@@ -6,6 +6,7 @@ import 'package:flutter/services.dart';
 import 'package:go_router/go_router.dart';
 import 'package:url_launcher/url_launcher.dart';
 import '../../core/config/app_config.dart';
+import '../../widgets/fullscreen_image_viewer.dart';

 // ── Palette & typography constants ────────────────────────────────────
 const _kPaper = Color(0xFFFAF8F5);
@@ -476,12 +477,7 @@ class _HeroGalleryState extends State<_HeroGallery> {
  }

  void _openFullscreen(int index) {
-    Navigator.of(context).push(PageRouteBuilder(
-      opaque: false,
-      barrierColor: Colors.black87,
-      pageBuilder: (_, __, ___) => _FullscreenViewer(
-        urls: widget.imageUrls, initialIndex: index),
-    ));
+    showFullscreenImages(context, widget.imageUrls, initialIndex: index);
  }
 }

@@ -534,66 +530,6 @@ class _GlassChip extends StatelessWidget {
  }
 }

-// ── Full-screen image viewer ──────────────────────────────────────────
-
-class _FullscreenViewer extends StatefulWidget {
-  final List<String> urls;
-  final int initialIndex;
-  const _FullscreenViewer({required this.urls, required this.initialIndex});
-
-  @override
-  State<_FullscreenViewer> createState() => _FullscreenViewerState();
-}
-
-class _FullscreenViewerState extends State<_FullscreenViewer> {
-  late PageController _ctrl;
-
-  @override
-  void initState() {
-    super.initState();
-    _ctrl = PageController(initialPage: widget.initialIndex);
-  }
-
-  @override
-  void dispose() { _ctrl.dispose(); super.dispose(); }
-
-  @override
-  Widget build(BuildContext context) {
-    return GestureDetector(
-      onTap: () => Navigator.of(context).pop(),
-      child: Scaffold(
-        backgroundColor: Colors.transparent,
-        body: Stack(
-          children: [
-            PageView.builder(
-              controller: _ctrl,
-              itemCount: widget.urls.length,
-              itemBuilder: (_, i) => Center(
-                child: InteractiveViewer(
-                  child: Image.network(widget.urls[i], fit: BoxFit.contain,
-                      errorBuilder: (_, __, ___) =>
-                          const Icon(Icons.broken_image, size: 64, color: Colors.white54)),
-                )),
-            ),
-            Positioned(
-              top: 40, right: 16,
-              child: GestureDetector(
-                onTap: () => Navigator.of(context).pop(),
-                child: Container(
-                  padding: const EdgeInsets.all(8),
-                  decoration: BoxDecoration(
-                    color: Colors.black54, borderRadius: BorderRadius.circular(20)),
-                  child: const Icon(Icons.close, color: Colors.white, size: 20),
-                ),
-              ),
-            ),
-          ],
-        ),
-      ),
-    );
-  }
-}
-
 // ── Verified Ribbon ───────────────────────────────────────────────────

 class _VerifiedRibbon extends StatelessWidget {
@@ -5,8 +5,8 @@ import '../../core/responsive/responsive.dart';
 import 'package:go_router/go_router.dart';
 import '../../core/theme/app_theme.dart';
 import '../../core/auth/auth_state.dart';
-import '../../core/utils/print_util.dart';
 import '../../core/utils/date_util.dart';
+import '../../widgets/order_print_preview_dialog.dart';
 import '../../models/stock_in.dart';
 import '../../core/config/app_constants.dart';
 import '../../providers/partner_provider.dart';
@@ -227,7 +227,7 @@ class _StockInFormScreenState extends ConsumerState<StockInFormScreen> {

  Future<void> _printOrder() async {
    if (_loadedOrder == null) return;
-    await safePrint(context, () => printStockInOrder(_loadedOrder!));
+    await showStockInOrderPrint(context, ref, _loadedOrder!);
  }

  Future<void> _submit(bool asDraft) async {
@@ -868,11 +868,8 @@ class _StockInFormScreenState extends ConsumerState<StockInFormScreen> {
        FilteringTextInputFormatter.allow(RegExp(r'^\d+\.?\d{0,2}'))
      ],
      onChanged: (_) => setState(() {}),
-      validator: (v) {
-        if (v == null || v.isEmpty) return '不能为空';
-        if ((double.tryParse(v) ?? 0) <= 0) return '>0';
-        return null;
-      },
+      // 单价允许为空或 0：表示「待定价」，入库审核后可在单据详情「确认进价」补填真实进价
+      validator: (_) => null,
    );
  }

@@ -976,15 +973,6 @@ class _StockInFormScreenState extends ConsumerState<StockInFormScreen> {
    );
  }

-  String _productCodeOf(_ItemRow item) =>
-      ref
-          .read(productNameListProvider)
-          .valueOrNull
-          ?.where((o) => o.id == item.selectedNameId)
-          .firstOrNull
-          ?.code ??
-      '';
-
  // ── 桌面表格：表头行 ──────────────────────────────────────────────────────
  Widget _buildItemTableHeader() {
    Widget th(String s) => Padding(
@@ -1019,7 +1007,6 @@ class _StockInFormScreenState extends ConsumerState<StockInFormScreen> {
    final qty = double.tryParse(item.qtyCtrl.text) ?? 0;
    final price = double.tryParse(item.priceCtrl.text) ?? 0;
    final amount = qty * price;
-    final productCode = _productCodeOf(item);

    Widget tc(String s, {Color? color, FontWeight? weight}) => Padding(
          padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 12),
@@ -1166,7 +1153,6 @@ class _StockInFormScreenState extends ConsumerState<StockInFormScreen> {
    final qty = double.tryParse(item.qtyCtrl.text) ?? 0;
    final price = double.tryParse(item.priceCtrl.text) ?? 0;
    final amount = qty * price;
-    final productCode = _productCodeOf(item);

    return MobileListCard(
      title: Text('商品 ${index + 1}'),
@@ -1,7 +1,9 @@
 import '../../core/utils/dialog_util.dart';
 import '../../core/errors/error_reporter.dart';
-import '../../core/utils/print_util.dart' show safePrint, printStockInOrder, LabelData;
+import '../../core/exceptions.dart';
+import '../../core/utils/print_util.dart' show LabelData;
 import '../../widgets/label_preview_dialog.dart';
+import '../../widgets/order_print_preview_dialog.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:go_router/go_router.dart';
@@ -16,6 +18,7 @@ import '../../widgets/multi_select_dropdown.dart' show ColDef, ColumnToggleButto
 import '../../core/storage/column_prefs.dart';
 import '../../widgets/page_scaffold.dart';
 import '../../widgets/status_badge.dart';
+import '../../widgets/search_chip.dart';
 import '../../core/utils/export_util.dart';
 import '../../providers/inventory_provider.dart';
 import '../../providers/tab_state_provider.dart';
@@ -43,6 +46,7 @@ class _StockInListScreenState extends ConsumerState<StockInListScreen> {
  Set<String> _filterSupplier = {};
  Set<String>? _hiddenCols; // null = 尚未载入本地存档（回退到 minWidth 首次默认）
  final _searchCtrl = TextEditingController();
+  String _appliedKw = ''; // 已生效的搜索词（框内 chip 标签展示）

  static const _screenId = 'stock_in_list';

@@ -71,6 +75,10 @@ class _StockInListScreenState extends ConsumerState<StockInListScreen> {
      final want = tab == 1 ? 'pending,draft' : _statusFilter;
      final notifier = ref.read(stockInListProvider.notifier);
      if (notifier.currentStatus != want) notifier.setStatus(want);
+      // 同步已生效的搜索词到框内 chip（provider 持久化，切走再回来不丢）
+      if (notifier.currentKeyword != _appliedKw) {
+        setState(() => _appliedKw = notifier.currentKeyword);
+      }
    });
  }

@@ -80,8 +88,19 @@ class _StockInListScreenState extends ConsumerState<StockInListScreen> {
    super.dispose();
  }

-  void _triggerSearch() =>
-      ref.read(stockInListProvider.notifier).setKeyword(_searchCtrl.text.trim());
+  void _triggerSearch() {
+    final kw = _searchCtrl.text.trim();
+    ref.read(stockInListProvider.notifier).setKeyword(kw);
+    // 仅支持单个搜索词：生效后输入框清空，搜索词转为框内 chip 标签
+    setState(() => _appliedKw = kw);
+    if (kw.isNotEmpty) _searchCtrl.clear();
+  }
+
+  void _clearSearch() {
+    _searchCtrl.clear();
+    setState(() => _appliedKw = '');
+    ref.read(stockInListProvider.notifier).setKeyword('');
+  }

  String? get _startDate => _dateRange != null
      ? '${_dateRange!.start.year}-${_dateRange!.start.month.toString().padLeft(2, '0')}-${_dateRange!.start.day.toString().padLeft(2, '0')}'
@@ -362,12 +381,29 @@ class _StockInListScreenState extends ConsumerState<StockInListScreen> {
              )
            : null;

+        final hasKw = _appliedKw.isNotEmpty;
        final searchField = TextField(
          controller: _searchCtrl,
          decoration: InputDecoration(
-            hintText: '单号/往来单位，回车搜索',
-            prefixIcon: const Icon(Icons.search, size: 16),
+            hintText: hasKw ? '继续输入新关键词…' : '单号/往来单位/酒名，回车搜索',
            hintStyle: const TextStyle(fontSize: 12),
+            // 搜索图标 +（已生效时）框内 chip 标签，仅一个词；✕ 删除即清除搜索。
+            // 用 prefixIcon 而非 prefix：后者仅在聚焦/有文字时才显示，搜索后输入框为空会被隐藏。
+            prefixIconConstraints:
+                const BoxConstraints(minWidth: 0, minHeight: 0),
+            prefixIcon: Padding(
+              padding: const EdgeInsets.only(left: 8, right: 6),
+              child: Row(
+                mainAxisSize: MainAxisSize.min,
+                children: [
+                  const Icon(Icons.search, size: 16),
+                  if (hasKw) ...[
+                    const SizedBox(width: 6),
+                    SearchChip(label: _appliedKw, onDeleted: _clearSearch),
+                  ],
+                ],
+              ),
+            ),
            suffixIcon: IconButton(
              icon: const Icon(Icons.search, size: 16),
              tooltip: '搜索',
@@ -494,7 +530,7 @@ class _StockInListScreenState extends ConsumerState<StockInListScreen> {
      onPrint: () async {
        final order = await ref.read(stockInRepositoryProvider).get(o.id);
        if (context.mounted) {
-          await safePrint(context, () => printStockInOrder(order));
+          await showStockInOrderPrint(context, ref, order);
        }
      },
      afterPrint: [
@@ -572,6 +608,8 @@ class _StockInListScreenState extends ConsumerState<StockInListScreen> {
  Future<void> _showDetail(BuildContext context, int orderId) async {
    showAppDialog(
      context: context,
+      // 用分支 Navigator 承载，全屏弹窗只覆盖内容区，不盖住左侧栏/顶栏/状态栏
+      useRootNavigator: false,
      builder: (ctx) => _StockInDetailDialog(
        orderId: orderId,
        repository: ref.read(stockInRepositoryProvider),
@@ -897,7 +935,11 @@ class _StockInDetailDialogState extends ConsumerState<_StockInDetailDialog> {
  @override
  void initState() {
    super.initState();
-    _future = widget.repository.get(widget.orderId).then((order) async {
+    _future = _load();
+  }
+
+  Future<StockInOrder> _load() {
+    return widget.repository.get(widget.orderId).then((order) async {
      if (mounted) setState(() => _loadedOrder = order);
      try {
        final result = await ref
@@ -915,42 +957,126 @@ class _StockInDetailDialogState extends ConsumerState<_StockInDetailDialog> {
    });
  }

+  /// 确认进价：为 0 价（待定）明细补填真实进价，调后端前向补偿后刷新。
+  Future<void> _confirmCost(StockInOrder o) async {
+    final pending =
+        o.items.where((it) => it.unitPrice == 0 && it.id != null).toList();
+    if (pending.isEmpty) return;
+    final controllers = {
+      for (final it in pending) it.id!: TextEditingController()
+    };
+
+    final ok = await showDialog<bool>(
+      context: context,
+      builder: (ctx) => AlertDialog(
+        title: const Text('确认进价'),
+        content: SizedBox(
+          width: context.dialogWidth(440),
+          child: SingleChildScrollView(
+            child: Column(
+              mainAxisSize: MainAxisSize.min,
+              children: pending.map((it) {
+                return Padding(
+                  padding: const EdgeInsets.symmetric(vertical: 6),
+                  child: Row(
+                    children: [
+                      Expanded(
+                        child: Text(
+                          '${it.productName ?? ''} ${it.productSpec ?? ''} ×${it.quantity.toStringAsFixed(0)}',
+                          style: const TextStyle(fontSize: 13),
+                        ),
+                      ),
+                      const SizedBox(width: 8),
+                      SizedBox(
+                        width: 120,
+                        child: TextField(
+                          controller: controllers[it.id],
+                          keyboardType: const TextInputType.numberWithOptions(
+                              decimal: true),
+                          decoration: const InputDecoration(
+                              prefixText: '¥',
+                              hintText: '进价',
+                              isDense: true),
+                        ),
+                      ),
+                    ],
+                  ),
+                );
+              }).toList(),
+            ),
+          ),
+        ),
+        actions: [
+          TextButton(
+              onPressed: () => Navigator.pop(ctx, false),
+              child: const Text('取消')),
+          ElevatedButton(
+              onPressed: () => Navigator.pop(ctx, true),
+              child: const Text('确认')),
+        ],
+      ),
+    );
+
+    final items = <Map<String, dynamic>>[];
+    if (ok == true) {
+      for (final it in pending) {
+        final v = double.tryParse(controllers[it.id]!.text.trim());
+        if (v != null && v > 0) {
+          items.add({'item_id': it.id, 'unit_price': v});
+        }
+      }
+    }
+    for (final c in controllers.values) {
+      c.dispose();
+    }
+    if (ok != true || items.isEmpty) return;
+
+    try {
+      await widget.repository.confirmCost(o.id, items);
+      if (!mounted) return;
+      ScaffoldMessenger.of(context)
+          .showSnackBar(const SnackBar(content: Text('进价已确认')));
+      setState(() => _future = _load());
+      ref.invalidate(stockInListProvider);
+    } on AppException catch (e) {
+      if (!mounted) return;
+      ScaffoldMessenger.of(context)
+          .showSnackBar(SnackBar(content: Text('确认失败：${e.message}')));
+    }
+  }
+
  @override
  Widget build(BuildContext context) {
-    return Dialog(
-      child: Container(
-        width: context.dialogWidth(720),
-        constraints: const BoxConstraints(maxHeight: 600),
+    return Dialog.fullscreen(
+      child: SafeArea(
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Container(
-              padding: const EdgeInsets.symmetric(horizontal: 20, vertical: 14),
+              padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 8),
              decoration: const BoxDecoration(
-                color: AppTheme.primary,
-                borderRadius: BorderRadius.only(
-                  topLeft: Radius.circular(12),
-                  topRight: Radius.circular(12),
-                ),
+                color: AppTheme.brand50,
+                border: Border(bottom: BorderSide(color: AppTheme.border)),
              ),
              child: Row(
                children: [
+                  IconButton(
+                    icon: const Icon(Icons.arrow_back, color: AppTheme.primaryDark),
+                    tooltip: '返回',
+                    onPressed: () => Navigator.of(context).pop(),
+                  ),
                  const Text('入库单详情',
                      style: TextStyle(
                          fontSize: 16,
                          fontWeight: FontWeight.w600,
-                          color: Colors.white)),
+                          color: AppTheme.primaryDark)),
                  const Spacer(),
                  if (_loadedOrder != null)
                    IconButton(
-                      icon: const Icon(Icons.print_outlined, color: Colors.white),
+                      icon: const Icon(Icons.print_outlined, color: AppTheme.primaryDark),
                      tooltip: '打印',
-                      onPressed: () => safePrint(context, () => printStockInOrder(_loadedOrder!)),
+                      onPressed: () => showStockInOrderPrint(context, ref, _loadedOrder!),
                    ),
-                  IconButton(
-                    icon: const Icon(Icons.close, color: Colors.white),
-                    onPressed: () => Navigator.of(context).pop(),
-                  ),
                ],
              ),
            ),
@@ -1034,10 +1160,10 @@ class _StockInDetailDialogState extends ConsumerState<_StockInDetailDialog> {
                        MobileCardField('系列', item.productSeries!),
                      MobileCardField('规格', item.productSpec ?? '-'),
                      MobileCardField('数量', item.quantity.toStringAsFixed(3)),
-                      MobileCardField(
-                          '单价', '¥${item.unitPrice.toStringAsFixed(2)}'),
-                      MobileCardField(
-                          '金额', '¥${item.totalPrice.toStringAsFixed(2)}'),
+                      MobileCardField('单价',
+                          item.unitPrice == 0 ? '待定价' : '¥${item.unitPrice.toStringAsFixed(2)}'),
+                      MobileCardField('金额',
+                          item.totalPrice == 0 ? '待定' : '¥${item.totalPrice.toStringAsFixed(2)}'),
                      if (item.batchNo?.isNotEmpty ?? false)
                        MobileCardField('批次号', item.batchNo!),
                      if (item.productionDate?.isNotEmpty ?? false)
@@ -1131,13 +1257,31 @@ class _StockInDetailDialogState extends ConsumerState<_StockInDetailDialog> {
                      _TableCell(
                          (item.batchNo?.isNotEmpty ?? false) ? item.batchNo! : '-'),
                      _TableCell(item.quantity.toStringAsFixed(3)),
-                      _TableCell('¥${item.unitPrice.toStringAsFixed(2)}'),
-                      _TableCell('¥${item.totalPrice.toStringAsFixed(2)}'),
+                      _TableCell(item.unitPrice == 0 ? '待定价' : '¥${item.unitPrice.toStringAsFixed(2)}'),
+                      _TableCell(item.totalPrice == 0 ? '待定' : '¥${item.totalPrice.toStringAsFixed(2)}'),
                    ],
                  );
                }),
              ],
            ),
+          if (o.status == 'approved' &&
+              ref.watch(isAdminProvider) &&
+              o.items.any((it) => it.unitPrice == 0)) ...[
+            const SizedBox(height: 16),
+            Align(
+              alignment: Alignment.centerLeft,
+              child: ElevatedButton.icon(
+                onPressed: () => _confirmCost(o),
+                icon: const Icon(Icons.price_check, size: 18),
+                label: const Text('确认进价'),
+              ),
+            ),
+            const SizedBox(height: 4),
+            const Text(
+              '该单含「待定价」明细：价格确定后补填真实进价，将自动回填库存成本、已出库成本快照与应付差额（不影响售价/应收）。',
+              style: TextStyle(fontSize: 12, color: AppTheme.textSecondary),
+            ),
+          ],
        ],
      ),
    );
@@ -7,8 +7,8 @@ import 'package:go_router/go_router.dart';
 import '../../core/responsive/responsive.dart';
 import '../../core/theme/app_theme.dart';
 import '../../core/auth/auth_state.dart';
-import '../../core/utils/print_util.dart';
 import '../../core/utils/date_util.dart';
+import '../../widgets/order_print_preview_dialog.dart';
 import '../../models/inventory.dart';
 import '../../models/stock_out.dart';
 import '../../widgets/date_picker_field.dart';
@@ -258,7 +258,7 @@ class _StockOutFormScreenState extends ConsumerState<StockOutFormScreen> {

  Future<void> _printOrder() async {
    if (_loadedOrder == null) return;
-    await safePrint(context, () => printStockOutOrder(_loadedOrder!));
+    await showStockOutOrderPrint(context, ref, _loadedOrder!);
  }

  Future<void> _submit(bool asDraft) async {
@@ -1,6 +1,6 @@
 import '../../core/utils/dialog_util.dart';
 import '../../core/errors/error_reporter.dart';
-import '../../core/utils/print_util.dart' show safePrint, printStockOutOrder;
+import '../../widgets/order_print_preview_dialog.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:go_router/go_router.dart';
@@ -15,8 +15,8 @@ import '../../widgets/multi_select_dropdown.dart' show ColDef, ColumnToggleButto
 import '../../core/storage/column_prefs.dart';
 import '../../widgets/page_scaffold.dart';
 import '../../widgets/status_badge.dart';
+import '../../widgets/search_chip.dart';
 import '../../core/utils/export_util.dart';
-import '../../core/utils/print_util.dart';
 import '../../providers/inventory_provider.dart';
 import '../../providers/tab_state_provider.dart';
 import '../../providers/product_provider.dart';
@@ -43,6 +43,7 @@ class _StockOutListScreenState extends ConsumerState<StockOutListScreen> {
  Set<String>? _hiddenCols; // null = 尚未载入本地存档（回退到 minWidth 首次默认）
  final _searchCtrl = TextEditingController();
  final _codeSearchCtrl = TextEditingController();
+  String _appliedKw = ''; // 已生效的搜索词（框内 chip 标签展示）

  static const _screenId = 'stock_out_list';

@@ -59,6 +60,10 @@ class _StockOutListScreenState extends ConsumerState<StockOutListScreen> {
      final want = tab == 1 ? 'pending,draft' : _statusFilter;
      final notifier = ref.read(stockOutListProvider.notifier);
      if (notifier.currentStatus != want) notifier.setStatus(want);
+      // 同步已生效的搜索词到框内 chip（provider 持久化，切走再回来不丢）
+      if (notifier.currentKeyword != _appliedKw) {
+        setState(() => _appliedKw = notifier.currentKeyword);
+      }
    });
  }

@@ -82,9 +87,19 @@ class _StockOutListScreenState extends ConsumerState<StockOutListScreen> {
    super.dispose();
  }

-  void _triggerSearch() => ref
-      .read(stockOutListProvider.notifier)
-      .setKeyword(_searchCtrl.text.trim());
+  void _triggerSearch() {
+    final kw = _searchCtrl.text.trim();
+    ref.read(stockOutListProvider.notifier).setKeyword(kw);
+    // 仅支持单个搜索词：生效后输入框清空，搜索词转为框内 chip 标签
+    setState(() => _appliedKw = kw);
+    if (kw.isNotEmpty) _searchCtrl.clear();
+  }
+
+  void _clearSearch() {
+    _searchCtrl.clear();
+    setState(() => _appliedKw = '');
+    ref.read(stockOutListProvider.notifier).setKeyword('');
+  }

  void _triggerCodeSearch() => ref
      .read(stockOutListProvider.notifier)
@@ -375,12 +390,29 @@ class _StockOutListScreenState extends ConsumerState<StockOutListScreen> {
              )
            : null;

+        final hasKw = _appliedKw.isNotEmpty;
        final searchField = TextField(
          controller: _searchCtrl,
          decoration: InputDecoration(
-            hintText: '单号/往来单位，回车搜索',
-            prefixIcon: const Icon(Icons.search, size: 16),
+            hintText: hasKw ? '继续输入新关键词…' : '单号/往来单位/酒名，回车搜索',
            hintStyle: const TextStyle(fontSize: 12),
+            // 搜索图标 +（已生效时）框内 chip 标签，仅一个词；✕ 删除即清除搜索。
+            // 用 prefixIcon 而非 prefix：后者仅在聚焦/有文字时才显示，搜索后输入框为空会被隐藏。
+            prefixIconConstraints:
+                const BoxConstraints(minWidth: 0, minHeight: 0),
+            prefixIcon: Padding(
+              padding: const EdgeInsets.only(left: 8, right: 6),
+              child: Row(
+                mainAxisSize: MainAxisSize.min,
+                children: [
+                  const Icon(Icons.search, size: 16),
+                  if (hasKw) ...[
+                    const SizedBox(width: 6),
+                    SearchChip(label: _appliedKw, onDeleted: _clearSearch),
+                  ],
+                ],
+              ),
+            ),
            suffixIcon: IconButton(
              icon: const Icon(Icons.search, size: 16),
              tooltip: '搜索',
@@ -526,7 +558,7 @@ class _StockOutListScreenState extends ConsumerState<StockOutListScreen> {
      onPrint: () async {
        final order = await ref.read(stockOutRepositoryProvider).get(o.id);
        if (context.mounted) {
-          await safePrint(context, () => printStockOutOrder(order));
+          await showStockOutOrderPrint(context, ref, order);
        }
      },
      onSettle: () => _confirmSettle(context, o.id, 'stock_out'),
@@ -574,6 +606,8 @@ class _StockOutListScreenState extends ConsumerState<StockOutListScreen> {
  Future<void> _showDetail(BuildContext context, int orderId) async {
    showAppDialog(
      context: context,
+      // 用分支 Navigator 承载，全屏弹窗只覆盖内容区，不盖住左侧栏/顶栏/状态栏
+      useRootNavigator: false,
      builder: (ctx) => _StockOutDetailDialog(
        orderId: orderId,
        repository: ref.read(stockOutRepositoryProvider),
@@ -924,40 +958,36 @@ class _StockOutDetailDialogState extends ConsumerState<_StockOutDetailDialog> {

  @override
  Widget build(BuildContext context) {
-    return Dialog(
-      child: Container(
-        width: context.dialogWidth(720),
-        constraints: const BoxConstraints(maxHeight: 600),
+    return Dialog.fullscreen(
+      child: SafeArea(
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Container(
-              padding: const EdgeInsets.symmetric(horizontal: 20, vertical: 14),
+              padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 8),
              decoration: const BoxDecoration(
-                color: AppTheme.primary,
-                borderRadius: BorderRadius.only(
-                  topLeft: Radius.circular(12),
-                  topRight: Radius.circular(12),
-                ),
+                color: AppTheme.brand50,
+                border: Border(bottom: BorderSide(color: AppTheme.border)),
              ),
              child: Row(
                children: [
+                  IconButton(
+                    icon: const Icon(Icons.arrow_back, color: AppTheme.primaryDark),
+                    tooltip: '返回',
+                    onPressed: () => Navigator.of(context).pop(),
+                  ),
                  const Text('出库单详情',
                      style: TextStyle(
                          fontSize: 16,
                          fontWeight: FontWeight.w600,
-                          color: Colors.white)),
+                          color: AppTheme.primaryDark)),
                  const Spacer(),
                  if (_loadedOrder != null)
                    IconButton(
-                      icon: const Icon(Icons.print_outlined, color: Colors.white),
+                      icon: const Icon(Icons.print_outlined, color: AppTheme.primaryDark),
                      tooltip: '打印',
-                      onPressed: () => safePrint(context, () => printStockOutOrder(_loadedOrder!)),
+                      onPressed: () => showStockOutOrderPrint(context, ref, _loadedOrder!),
                    ),
-                  IconButton(
-                    icon: const Icon(Icons.close, color: Colors.white),
-                    onPressed: () => Navigator.of(context).pop(),
-                  ),
                ],
              ),
            ),
@@ -1040,7 +1070,7 @@ class _StockOutDetailDialogState extends ConsumerState<_StockOutDetailDialog> {
              children: [
                TableRow(
                  decoration: const BoxDecoration(color: Color(0xFFF0F4FF)),
-                  children: ['序号', '商品编码', '名称', '系列', '规格', '生产日期', '批次号', '数量', '单价', '金额']
+                  children: ['序号', '商品编码', '名称', '系列', '规格', '生产日期', '批次号', '成本价', '售价', '利润']
                      .map((h) => Padding(
                            padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 10),
                            child: Text(h,
@@ -1069,9 +1099,9 @@ class _StockOutDetailDialogState extends ConsumerState<_StockOutDetailDialog> {
                          : (item.productionDate ?? '-')),
                      _TableCell(
                          (item.batchNo?.isNotEmpty ?? false) ? item.batchNo! : '-'),
-                      _TableCell(item.quantity.toStringAsFixed(3)),
                      _TableCell('¥${item.unitPrice.toStringAsFixed(2)}'),
-                      _TableCell('¥${item.totalPrice.toStringAsFixed(2)}'),
+                      _TableCell('¥${item.salePrice.toStringAsFixed(2)}'),
+                      _TableCell('¥${(item.salePrice - item.unitPrice).toStringAsFixed(2)}'),
                    ],
                  );
                }),
@@ -0,0 +1,86 @@
+import 'package:flutter/material.dart';
+
+/// 全屏图片查看器：黑底 modal + 多图左右翻页（PageView）+ 双指缩放/拖拽（InteractiveViewer）。
+/// 点击背景或右上角关闭按钮退出。纯 Flutter 内置组件，无需额外依赖。
+///
+/// 用法：
+/// ```dart
+/// showFullscreenImages(context, urls, initialIndex: 2);
+/// ```
+void showFullscreenImages(BuildContext context, List<String> urls,
+    {int initialIndex = 0}) {
+  if (urls.isEmpty) return;
+  Navigator.of(context).push(PageRouteBuilder(
+    opaque: false,
+    barrierColor: Colors.black87,
+    pageBuilder: (_, __, ___) =>
+        FullscreenImageViewer(urls: urls, initialIndex: initialIndex),
+  ));
+}
+
+class FullscreenImageViewer extends StatefulWidget {
+  final List<String> urls;
+  final int initialIndex;
+  const FullscreenImageViewer(
+      {super.key, required this.urls, this.initialIndex = 0});
+
+  @override
+  State<FullscreenImageViewer> createState() => _FullscreenImageViewerState();
+}
+
+class _FullscreenImageViewerState extends State<FullscreenImageViewer> {
+  late PageController _ctrl;
+
+  @override
+  void initState() {
+    super.initState();
+    _ctrl = PageController(initialPage: widget.initialIndex);
+  }
+
+  @override
+  void dispose() {
+    _ctrl.dispose();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return GestureDetector(
+      onTap: () => Navigator.of(context).pop(),
+      child: Scaffold(
+        backgroundColor: Colors.transparent,
+        body: Stack(
+          children: [
+            PageView.builder(
+              controller: _ctrl,
+              itemCount: widget.urls.length,
+              itemBuilder: (_, i) => Center(
+                child: InteractiveViewer(
+                  child: Image.network(widget.urls[i], fit: BoxFit.contain,
+                      errorBuilder: (_, __, ___) => const Icon(
+                          Icons.broken_image,
+                          size: 64,
+                          color: Colors.white54)),
+                ),
+              ),
+            ),
+            Positioned(
+              top: 40,
+              right: 16,
+              child: GestureDetector(
+                onTap: () => Navigator.of(context).pop(),
+                child: Container(
+                  padding: const EdgeInsets.all(8),
+                  decoration: BoxDecoration(
+                      color: Colors.black54,
+                      borderRadius: BorderRadius.circular(20)),
+                  child: const Icon(Icons.close, color: Colors.white, size: 20),
+                ),
+              ),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}
@@ -0,0 +1,282 @@
+import 'dart:typed_data';
+import 'package:flutter/foundation.dart' show kIsWeb;
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:printing/printing.dart';
+import '../core/auth/auth_state.dart';
+import '../core/errors/error_reporter.dart';
+import '../core/theme/app_theme.dart';
+import '../core/responsive/responsive.dart';
+import '../core/utils/print_util.dart';
+import '../models/shop.dart';
+import '../models/stock_in.dart';
+import '../models/stock_out.dart';
+import '../providers/shop_provider.dart';
+
+/// 单据打印预览弹窗：把待打印的 A4 PDF 光栅化成图片（所见即所得）逐页展示，
+/// 页内点「打印」再调系统打印。解决部分 Windows 系统打印对话框无预览的问题。
+///
+/// 仅桌面端使用；Web 端走浏览器自带的打印预览（见 [showStockInOrderPrint]）。
+class OrderPrintPreviewDialog extends StatefulWidget {
+  /// 标题，如「入库单打印预览」。
+  final String title;
+
+  /// 系统打印任务名（也作另存默认文件名前缀）。
+  final String printName;
+
+  /// 惰性生成 PDF 字节。
+  final Future<Uint8List> Function() pdfBuilder;
+
+  const OrderPrintPreviewDialog({
+    super.key,
+    required this.title,
+    required this.printName,
+    required this.pdfBuilder,
+  });
+
+  @override
+  State<OrderPrintPreviewDialog> createState() =>
+      _OrderPrintPreviewDialogState();
+}
+
+class _OrderPrintPreviewDialogState extends State<OrderPrintPreviewDialog> {
+  Uint8List? _pdfBytes;
+  final List<Uint8List> _pages = [];
+  bool _rendering = true;
+  bool _printing = false;
+  String _error = '';
+
+  @override
+  void initState() {
+    super.initState();
+    _render();
+  }
+
+  Future<void> _render() async {
+    try {
+      final bytes = await widget.pdfBuilder();
+      if (!mounted) return;
+      setState(() => _pdfBytes = bytes);
+      // 逐页光栅化（progressive），DPI 取 110 兼顾清晰与速度。
+      await for (final raster in Printing.raster(bytes, dpi: 110)) {
+        final png = await raster.toPng();
+        if (!mounted) return;
+        setState(() => _pages.add(png));
+      }
+    } catch (e, st) {
+      reportError(e, st);
+      if (mounted) setState(() => _error = '预览生成失败：$e');
+    } finally {
+      if (mounted) setState(() => _rendering = false);
+    }
+  }
+
+  Future<void> _doPrint() async {
+    final bytes = _pdfBytes;
+    if (bytes == null || _printing) return;
+    setState(() => _printing = true);
+    try {
+      await Printing.layoutPdf(
+        name: '${widget.printName}_${_ts()}',
+        dynamicLayout: false,
+        onLayout: (_) async => bytes,
+      );
+      if (mounted) Navigator.of(context).pop();
+    } catch (e, st) {
+      reportError(e, st);
+      if (mounted) {
+        setState(() {
+          _printing = false;
+          _error = '打印失败，请检查打印机连接和驱动是否正常。\n详情：$e';
+        });
+      }
+    }
+  }
+
+  String _ts() {
+    final n = DateTime.now();
+    String p(int v) => v.toString().padLeft(2, '0');
+    return '${n.year}${p(n.month)}${p(n.day)}_${p(n.hour)}${p(n.minute)}${p(n.second)}';
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Dialog(
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(12)),
+      child: Container(
+        width: context.dialogWidth(720),
+        constraints: const BoxConstraints(maxHeight: 720),
+        child: Column(
+          children: [
+            // ── 顶栏 ──────────────────────────────────────────────────────────
+            Container(
+              padding:
+                  const EdgeInsets.symmetric(horizontal: 20, vertical: 14),
+              decoration: const BoxDecoration(
+                color: AppTheme.primary,
+                borderRadius: BorderRadius.only(
+                  topLeft: Radius.circular(12),
+                  topRight: Radius.circular(12),
+                ),
+              ),
+              child: Row(
+                children: [
+                  Text(widget.title,
+                      style: const TextStyle(
+                          fontSize: 16,
+                          fontWeight: FontWeight.w600,
+                          color: Colors.white)),
+                  const Spacer(),
+                  IconButton(
+                    icon: const Icon(Icons.close, color: Colors.white),
+                    onPressed:
+                        _printing ? null : () => Navigator.of(context).pop(),
+                    padding: EdgeInsets.zero,
+                    constraints: const BoxConstraints(),
+                  ),
+                ],
+              ),
+            ),
+
+            // ── 预览区 ─────────────────────────────────────────────────────────
+            Expanded(
+              child: Container(
+                width: double.infinity,
+                color: const Color(0xFFE9ECF1),
+                child: _buildBody(),
+              ),
+            ),
+
+            // ── 底栏 ──────────────────────────────────────────────────────────
+            Padding(
+              padding: const EdgeInsets.fromLTRB(16, 10, 16, 14),
+              child: Row(
+                children: [
+                  Expanded(
+                    child: Text(
+                      _error.isNotEmpty
+                          ? _error
+                          : (_rendering
+                              ? '正在生成预览…'
+                              : '共 ${_pages.length} 页'),
+                      style: TextStyle(
+                          fontSize: 12,
+                          color: _error.isNotEmpty
+                              ? Colors.red
+                              : AppTheme.textSecondary),
+                    ),
+                  ),
+                  TextButton(
+                    onPressed:
+                        _printing ? null : () => Navigator.of(context).pop(),
+                    child: const Text('取消'),
+                  ),
+                  const SizedBox(width: 8),
+                  FilledButton.icon(
+                    icon: const Icon(Icons.print, size: 18),
+                    onPressed: (_pdfBytes == null || _printing)
+                        ? null
+                        : _doPrint,
+                    label: Text(_printing ? '打印中…' : '打印'),
+                  ),
+                ],
+              ),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+
+  Widget _buildBody() {
+    if (_pages.isEmpty) {
+      if (_error.isNotEmpty) {
+        return Center(
+          child: Padding(
+            padding: const EdgeInsets.all(24),
+            child: Text(_error,
+                textAlign: TextAlign.center,
+                style: const TextStyle(color: Colors.red, fontSize: 13)),
+          ),
+        );
+      }
+      return const Center(child: CircularProgressIndicator());
+    }
+    return ListView.separated(
+      padding: const EdgeInsets.symmetric(horizontal: 20, vertical: 16),
+      itemCount: _pages.length,
+      separatorBuilder: (_, __) => const SizedBox(height: 16),
+      itemBuilder: (_, i) => Center(
+        child: Container(
+          decoration: BoxDecoration(
+            color: Colors.white,
+            boxShadow: [
+              BoxShadow(
+                color: Colors.black.withOpacity(0.18),
+                blurRadius: 8,
+                offset: const Offset(0, 2),
+              ),
+            ],
+          ),
+          child: Image.memory(_pages[i], fit: BoxFit.contain),
+        ),
+      ),
+    );
+  }
+}
+
+/// 组装单据打印抬头信息：公司名称（门店）+ 制单人（当前登录、点击打印的人）。
+Future<OrderPrintMeta> _buildPrintMeta(WidgetRef ref) async {
+  ShopInfo? shop;
+  try {
+    shop = await ref.read(shopInfoProvider.future);
+  } catch (_) {
+    // 门店信息拉取失败（离线等）时抬头留空，不阻塞打印。
+  }
+  return OrderPrintMeta(
+    shopName: shop?.name ?? '',
+    shopAddress: shop?.address ?? '',
+    shopPhone: shop?.phone ?? '',
+    makerName: ref.read(authStateProvider).user?.realName ?? '',
+  );
+}
+
+/// 打印入库单：桌面端先弹应用内预览，Web 端走浏览器自带打印预览。
+Future<void> showStockInOrderPrint(
+    BuildContext context, WidgetRef ref, StockInOrder order) async {
+  final meta = await _buildPrintMeta(ref);
+  if (!context.mounted) return;
+  if (kIsWeb) {
+    await safePrint(context, () => printStockInOrder(order, meta));
+    return;
+  }
+  await showDialog<void>(
+    context: context,
+    barrierDismissible: false,
+    builder: (_) => OrderPrintPreviewDialog(
+      title: '入库单打印预览',
+      printName: '入库单',
+      pdfBuilder: () => buildStockInOrderPdf(order, meta),
+    ),
+  );
+}
+
+/// 打印出库单：桌面端先弹应用内预览，Web 端走浏览器自带打印预览。
+Future<void> showStockOutOrderPrint(
+    BuildContext context, WidgetRef ref, StockOutOrder order) async {
+  final meta = await _buildPrintMeta(ref);
+  if (!context.mounted) return;
+  if (kIsWeb) {
+    await safePrint(context, () => printStockOutOrder(order, meta));
+    return;
+  }
+  await showDialog<void>(
+    context: context,
+    barrierDismissible: false,
+    builder: (_) => OrderPrintPreviewDialog(
+      title: '出库单打印预览',
+      printName: '出库单',
+      pdfBuilder: () => buildStockOutOrderPdf(order, meta),
+    ),
+  );
+}
@@ -0,0 +1,52 @@
+import 'package:flutter/material.dart';
+
+/// 搜索框内嵌的「已生效搜索词」标签：紧凑圆角 chip + ✕ 删除按钮。
+///
+/// 用于列表屏搜索框 [InputDecoration.prefix]，仅展示单个搜索词；
+/// 点 ✕ 触发 [onDeleted] 清除搜索。
+class SearchChip extends StatelessWidget {
+  const SearchChip({super.key, required this.label, required this.onDeleted});
+
+  final String label;
+  final VoidCallback onDeleted;
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final bg = theme.colorScheme.primary.withValues(alpha: 0.12);
+    final fg = theme.colorScheme.primary;
+    return Container(
+      padding: const EdgeInsets.only(left: 8, right: 2, top: 2, bottom: 2),
+      decoration: BoxDecoration(
+        color: bg,
+        borderRadius: BorderRadius.circular(12),
+      ),
+      child: Row(
+        mainAxisSize: MainAxisSize.min,
+        children: [
+          ConstrainedBox(
+            constraints: const BoxConstraints(maxWidth: 120),
+            child: Text(
+              label,
+              maxLines: 1,
+              overflow: TextOverflow.ellipsis,
+              style: TextStyle(
+                fontSize: 12,
+                color: fg,
+                fontWeight: FontWeight.w500,
+              ),
+            ),
+          ),
+          InkResponse(
+            onTap: onDeleted,
+            radius: 14,
+            child: Padding(
+              padding: const EdgeInsets.all(2),
+              child: Icon(Icons.close, size: 14, color: fg),
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+}
@@ -0,0 +1,82 @@
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:jiu_client/core/api/api_client.dart';
+import 'package:jiu_client/core/models/page_result.dart';
+import 'package:jiu_client/models/stock_in.dart';
+import 'package:jiu_client/providers/stock_in_provider.dart';
+import 'package:jiu_client/repositories/stock_in_repository.dart';
+
+/// 统计 list() 调用次数与最后一次关键词的假仓库，用于验证搜索限流。
+class _CountingStockInRepo extends StockInRepository {
+  int listCalls = 0;
+  String? lastKeyword;
+
+  _CountingStockInRepo() : super(ApiClient(token: 't'));
+
+  @override
+  Future<PageResult<StockInOrder>> list({
+    String? status,
+    String? startDate,
+    String? endDate,
+    String? keyword,
+    int page = 1,
+    int pageSize = 20,
+  }) async {
+    listCalls++;
+    lastKeyword = keyword;
+    return const PageResult<StockInOrder>(
+        data: [], total: 0, page: 1, pageSize: 20);
+  }
+}
+
+void main() {
+  test('setKeyword 防抖：350ms 内连发只触发最后一次', () async {
+    final repo = _CountingStockInRepo();
+    final container = ProviderContainer(
+      overrides: [stockInRepositoryProvider.overrideWithValue(repo)],
+    );
+    addTearDown(container.dispose);
+
+    // 初次 build 自动拉一次列表
+    await container.read(stockInListProvider.future);
+    expect(repo.listCalls, 1);
+
+    final notifier = container.read(stockInListProvider.notifier);
+
+    // 350ms 内连发三个不同关键词
+    notifier.setKeyword('茅');
+    notifier.setKeyword('茅台');
+    notifier.setKeyword('飞天茅台');
+
+    // 防抖窗口未到 → 不应有新请求
+    await Future<void>.delayed(const Duration(milliseconds: 120));
+    expect(repo.listCalls, 1);
+
+    // 过了防抖窗口 → 合并成 1 次，关键词取最后一个
+    await Future<void>.delayed(const Duration(milliseconds: 350));
+    expect(repo.listCalls, 2);
+    expect(repo.lastKeyword, '飞天茅台');
+  });
+
+  test('setKeyword 去重：相同关键词不重复查询', () async {
+    final repo = _CountingStockInRepo();
+    final container = ProviderContainer(
+      overrides: [stockInRepositoryProvider.overrideWithValue(repo)],
+    );
+    addTearDown(container.dispose);
+
+    await container.read(stockInListProvider.future);
+    final notifier = container.read(stockInListProvider.notifier);
+
+    // 首次搜索「茅台」
+    notifier.setKeyword('茅台');
+    await Future<void>.delayed(const Duration(milliseconds: 400));
+    expect(repo.listCalls, 2);
+    expect(repo.lastKeyword, '茅台');
+
+    // 再次搜索完全相同的关键词 → 直接 return，不发请求
+    notifier.setKeyword('茅台');
+    await Future<void>.delayed(const Duration(milliseconds: 400));
+    expect(repo.listCalls, 2);
+  });
+}
@@ -0,0 +1,103 @@
+# 阿里云独立 nginx 版（宿主机直接终结 TLS，不经 pangolin）。
+# 与 nginx-jiu.conf（EC2 pangolin 容器版，listen 127.0.0.1:8445）等价，
+# 仅入口监听改为对公网 443 直连。CI deploy-server.sh 的 ali 分支落到
+# /etc/nginx/conf.d/jiu.conf。
+limit_req_zone $binary_remote_addr zone=jiu_pub:10m rate=10r/s;
+limit_req_status 429;
+
+server {
+    listen 443 ssl http2;
+    server_name jiu.51yanmei.com;
+
+    ssl_certificate     /etc/letsencrypt/live/jiu.51yanmei.com/fullchain.pem;
+    ssl_certificate_key /etc/letsencrypt/live/jiu.51yanmei.com/privkey.pem;
+    ssl_protocols       TLSv1.2 TLSv1.3;
+    ssl_ciphers         HIGH:!aNULL:!MD5;
+
+    client_max_body_size 20m;
+
+    # 商品图片静态文件
+    location ^~ /images/ {
+        alias /opt/jiu/images/;
+        expires 30d;
+        add_header Cache-Control "public, immutable";
+    }
+
+    # 文件导入接口（超时更长）
+    location ~ ^/api/v1/import/ {
+        proxy_pass         http://127.0.0.1:8080;
+        proxy_set_header   Host $host;
+        proxy_set_header   X-Real-IP $remote_addr;
+        proxy_read_timeout 300s;
+    }
+
+    # 未鉴权公开/登录接口：加最外层 per-IP 限流
+    location ~ ^/api/v1/(public|auth)/ {
+        limit_req          zone=jiu_pub burst=20 nodelay;
+        proxy_pass         http://127.0.0.1:8080;
+        proxy_set_header   Host $host;
+        proxy_set_header   X-Real-IP $remote_addr;
+        proxy_read_timeout 30s;
+    }
+
+    # API 反向代理
+    location ~ ^/(api|health|version) {
+        proxy_pass         http://127.0.0.1:8080;
+        proxy_set_header   Host $host;
+        proxy_set_header   X-Real-IP $remote_addr;
+        proxy_read_timeout 30s;
+    }
+
+    # Flutter 管理端（仅 /app/ 前缀）
+    location /app/ {
+        alias /opt/jiu/web/;
+        index index.html;
+        try_files $uri $uri/ /app/index.html;
+    }
+
+    location = /app/index.html {
+        alias /opt/jiu/web/index.html;
+        add_header Cache-Control "no-cache, no-store, must-revalidate";
+        add_header Pragma "no-cache";
+        expires 0;
+    }
+
+    # 公开商品详情页（扫码跳转）→ 后端注入 OG 标签
+    location ~ ^/product/ {
+        limit_req          zone=jiu_pub burst=20 nodelay;
+        proxy_pass         http://127.0.0.1:8080;
+        proxy_set_header   Host $host;
+        proxy_set_header   X-Real-IP $remote_addr;
+        proxy_read_timeout 30s;
+    }
+
+    # Flutter base-href=/app/ 会把 /product/:id 重写为 /app/product/:id
+    location ~ ^/app/product/ {
+        limit_req          zone=jiu_pub burst=20 nodelay;
+        rewrite ^/app(/product/.+)$ $1 break;
+        proxy_pass         http://127.0.0.1:8080;
+        proxy_set_header   Host $host;
+        proxy_set_header   X-Real-IP $remote_addr;
+        proxy_read_timeout 30s;
+    }
+
+    # 桌面客户端安装包下载
+    location /downloads/ {
+        alias /opt/jiu/downloads/;
+        add_header Content-Disposition "attachment";
+        add_header Cache-Control "no-cache";
+        autoindex off;
+    }
+
+    # 营销站点兜底
+    location / {
+        root /opt/jiu/marketing;
+        try_files $uri $uri.html $uri/index.html /index.html;
+    }
+}
+
+server {
+    listen 80;
+    server_name jiu.51yanmei.com;
+    return 301 https://$host$request_uri;
+}
@@ -0,0 +1,281 @@
+<!DOCTYPE html><html lang="zh"><head><meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>出入库单排版方案 · 6 种黑白样式</title>
+<style>
+* { box-sizing:border-box; margin:0; padding:0; }
+body { background:#e9ebee; font-family:"PingFang SC","Microsoft YaHei",sans-serif; color:#111; padding-bottom:60px; }
+.page-head { position:sticky; top:0; z-index:10; background:#fff; border-bottom:1px solid #ccc; padding:14px 24px; display:flex; align-items:center; gap:24px; flex-wrap:wrap; }
+.page-head h1 { font-size:17px; font-weight:700; }
+.page-head nav a { color:#111; text-decoration:none; font-size:13px; margin-right:14px; border-bottom:1px dashed #999; padding-bottom:1px; }
+.style-block { max-width:900px; margin:34px auto; }
+.style-block > h2 { font-size:16px; margin:0 12px 4px; }
+.style-block > .desc { font-size:12.5px; color:#555; margin:0 12px 16px; line-height:1.6; }
+.sheet { background:#fff; box-shadow:0 2px 12px rgba(0,0,0,.16); padding:46px 40px; margin-bottom:26px; }
+
+.doc table { width:100%; border-collapse:collapse; }
+.doc th { text-align:center; white-space:nowrap; }
+.doc td.num { text-align:right; }
+.doc td.ctr { text-align:center; }
+.doc .meta-row { display:flex; }
+.doc .total { display:flex; }
+.doc .sign { display:flex; justify-content:space-between; margin-top:40px; font-size:13px; }
+.doc .tips { font-size:11px; color:#555; line-height:1.6; border:1px solid #ddd; background:#fafafa; padding:7px 10px; margin-top:12px; }
+
+/* 一 极简线框 */
+.s1 .doc { color:#1a1a1a; }
+.s1 .hd { display:flex; align-items:baseline; gap:14px; border-bottom:2px solid #111; padding-bottom:12px; margin-bottom:16px; }
+.s1 .co { font-size:23px; font-weight:700; letter-spacing:1px; }
+.s1 .ty { font-size:14px; color:#666; letter-spacing:6px; }
+.s1 .meta { margin-bottom:16px; }
+.s1 .meta-row { justify-content:flex-start; gap:52px; font-size:12.5px; color:#333; line-height:2.1; }
+.s1 .m-no { font-weight:700; color:#111; }
+.s1 table { border:none; }
+.s1 th { border:none; border-bottom:2px solid #111; padding:8px 6px; font-size:12px; font-weight:700; letter-spacing:.5px; }
+.s1 td { border:none; border-bottom:1px solid #e2e2e2; padding:9px 6px; font-size:12px; }
+.s1 .total { border-top:2px solid #111; margin-top:-1px; justify-content:flex-end; gap:44px; padding:12px 4px; font-size:13px; }
+.s1 .t-label { margin-right:auto; color:#666; font-weight:700; }
+.s1 .total b { font-size:15px; font-weight:700; }
+.s1 .sign { margin-top:48px; }
+.s1 .tips { border:none; border-left:3px solid #111; background:none; padding:2px 0 2px 10px; }
+
+/* 二 现代分区 */
+.s2 .hd { text-align:center; margin-bottom:14px; }
+.s2 .co { font-size:24px; font-weight:800; }
+.s2 .ty { display:inline-block; margin-top:8px; font-size:14px; font-weight:700; letter-spacing:6px; border:1.5px solid #111; border-radius:2px; padding:3px 18px; }
+.s2 .meta { display:grid; grid-template-columns:repeat(3,1fr); border:1px solid #bbb; margin-bottom:14px; }
+.s2 .meta-row { display:contents; }
+.s2 .m { border:.5px solid #ccc; padding:8px 10px; font-size:12.5px; }
+.s2 table { border:1px solid #ccc; }
+.s2 th { background:#ececec; border:1px solid #ccc; padding:8px 6px; font-size:12px; font-weight:700; }
+.s2 td { border:1px solid #ddd; padding:7px 8px; font-size:12px; }
+.s2 tbody tr:nth-child(even) { background:#f7f7f7; }
+.s2 .total { margin-top:12px; justify-content:flex-end; align-items:center; gap:36px; background:#efefef; border:1px solid #bbb; border-radius:2px; padding:12px 18px; }
+.s2 .t-label { margin-right:auto; font-weight:800; font-size:14px; }
+.s2 .total b { font-size:17px; font-weight:800; }
+
+/* 三 紧凑报表 */
+.s3 .doc { border-left:4px solid #111; padding-left:18px; }
+.s3 .hd { display:flex; align-items:baseline; gap:12px; margin-bottom:10px; }
+.s3 .co { font-size:19px; font-weight:700; }
+.s3 .ty { font-size:13px; letter-spacing:4px; color:#444; }
+.s3 .meta { background:#f3f3f3; border:1px solid #ccc; padding:7px 10px; margin-bottom:10px; }
+.s3 .meta-row { justify-content:space-between; font-size:11.5px; line-height:1.9; }
+.s3 .m-no { font-weight:700; }
+.s3 table { border:1px solid #bbb; }
+.s3 th { background:#e5e5e5; border:1px solid #bbb; padding:5px 5px; font-size:11px; font-weight:700; }
+.s3 td { border:1px solid #ccc; padding:4px 6px; font-size:11px; }
+.s3 td.num { font-family:"SF Mono","Roboto Mono",Menlo,Consolas,monospace; }
+.s3 .total { justify-content:flex-end; gap:28px; margin-top:8px; border:1px solid #bbb; background:#f3f3f3; padding:7px 12px; font-size:12px; font-weight:700; }
+.s3 .t-label { margin-right:auto; }
+.s3 .total b { font-size:14px; font-family:"SF Mono",Menlo,Consolas,monospace; }
+.s3 .sign { margin-top:30px; font-size:12px; }
+
+/* 四 西式发票 */
+.s4 .topbar { display:flex; justify-content:space-between; align-items:flex-start; border-bottom:3px solid #111; padding-bottom:14px; margin-bottom:16px; }
+.s4 .co { font-size:30px; font-weight:800; letter-spacing:1px; }
+.s4 .docmeta { text-align:right; }
+.s4 .doctype { font-size:18px; font-weight:700; letter-spacing:6px; margin-bottom:8px; }
+.s4 .mbox { font-size:12px; line-height:1.8; color:#333; }
+.s4 .party { margin-bottom:14px; }
+.s4 .plabel { font-size:10.5px; letter-spacing:3px; color:#888; text-transform:uppercase; margin-bottom:5px; }
+.s4 .pgrid { display:flex; gap:40px; font-size:13px; }
+.s4 .seclabel { font-size:11px; letter-spacing:3px; color:#111; font-weight:700; border-bottom:1px solid #111; padding-bottom:5px; text-transform:uppercase; }
+.s4 th { border-bottom:1.5px solid #111; padding:8px 6px; font-size:11.5px; font-weight:700; }
+.s4 td { border-bottom:1px solid #e0e0e0; padding:8px 6px; font-size:12px; }
+.s4 .grand { display:flex; flex-direction:column; align-items:flex-end; gap:4px; margin-top:14px; }
+.s4 .grand > div { display:flex; gap:18px; min-width:230px; justify-content:space-between; font-size:13px; }
+.s4 .grand .g1 { justify-content:flex-end; color:#888; letter-spacing:2px; }
+.s4 .grand .g3 { border-top:2px solid #111; padding-top:6px; margin-top:2px; font-weight:800; }
+.s4 .grand b { font-size:15px; } .s4 .grand .g3 b { font-size:19px; }
+.s4 .sign { border-top:1px solid #ccc; padding-top:14px; }
+
+/* 五 瑞士网格 */
+.s5 .kicker { font-size:12px; letter-spacing:4px; text-transform:uppercase; color:#888; }
+.s5 .headline { font-size:46px; font-weight:800; letter-spacing:4px; line-height:1; margin:4px 0 16px; }
+.s5 .metaline { display:flex; gap:42px; flex-wrap:wrap; border-top:1px solid #111; border-bottom:1px solid #111; padding:10px 0; font-size:12.5px; margin-bottom:22px; }
+.s5 .metaline i { display:block; font-style:normal; font-size:10px; letter-spacing:2px; text-transform:uppercase; color:#999; margin-bottom:3px; }
+.s5 .sec { font-size:10.5px; letter-spacing:3px; text-transform:uppercase; color:#666; margin-bottom:6px; }
+.s5 th { border-top:2px solid #111; border-bottom:2px solid #111; padding:8px 6px; font-size:11px; letter-spacing:.5px; font-weight:700; }
+.s5 td { border-bottom:1px solid #e4e4e4; padding:9px 6px; font-size:12px; }
+.s5 td.num { font-variant-numeric:tabular-nums; font-feature-settings:"tnum"; }
+.s5 .total8 { display:flex; justify-content:flex-end; align-items:baseline; gap:14px; border-bottom:3px double #111; padding:12px 2px; margin-top:-1px; }
+.s5 .total8 > span { margin-right:auto; font-size:11px; letter-spacing:3px; text-transform:uppercase; color:#666; }
+.s5 .total8 em { font-style:normal; font-size:11px; color:#999; letter-spacing:2px; }
+.s5 .total8 b { font-size:18px; font-weight:800; }
+.s5 .sign { margin-top:46px; }
+
+/* 六 填空表单 */
+.s6 .frame { border:1px solid #111; outline:3px solid #111; outline-offset:3px; padding:18px 18px 16px; }
+.s6 .co9 { text-align:center; font-size:14px; letter-spacing:2px; color:#333; }
+.s6 .title9 { text-align:center; font-size:22px; font-weight:800; letter-spacing:10px; margin:2px 0 14px; }
+.s6 .meta9 { display:grid; grid-template-columns:repeat(3,1fr); gap:6px 24px; margin-bottom:12px; }
+.s6 .f { display:flex; align-items:baseline; font-size:12.5px; }
+.s6 .f label { color:#333; white-space:nowrap; } .s6 .f label::after { content:"："; }
+.s6 .f .fill { flex:1; border-bottom:1px solid #111; min-height:18px; padding:0 4px; font-weight:600; }
+.s6 table, .s6 th, .s6 td { border:1px solid #111; }
+.s6 th { background:#eee; padding:6px; font-size:11.5px; font-weight:700; }
+.s6 td { padding:6px 7px; font-size:11.5px; }
+.s6 .total9 { display:flex; border:1px solid #111; border-top:none; padding:8px 12px; font-size:13px; font-weight:700; }
+.s6 .total9 span:first-child { margin-right:auto; }
+.s6 .total9 span+span { margin-left:36px; }
+.s6 .sign9 { display:flex; margin-top:16px; gap:10px; }
+.s6 .sign9 div { flex:1; border:1px solid #111; padding:14px 10px 8px; font-size:12.5px; }
+
+@media print {
+  @page { size:A4; margin:10mm; }
+  body { background:#fff; padding:0; }
+  .page-head { display:none; }
+  .style-block { max-width:none; margin:0; break-before:page; }
+  .style-block:first-of-type { break-before:auto; }
+  .style-block > h2 { font-size:13px; margin:0 0 2px; }
+  .style-block > .desc { font-size:10px; color:#555; margin:0 0 8px; }
+  .sheet { box-shadow:none; border:1px solid #e3e3e3; padding:18px 20px; margin-bottom:10px; break-inside:avoid; }
+}
+</style></head><body>
+<header class="page-head"><h1>出入库单排版方案 · 6 种黑白样式</h1><nav><a href="#s1">极简线框</a><a href="#s2">现代分区</a><a href="#s3">紧凑报表</a><a href="#s4">西式发票</a><a href="#s5">瑞士网格</a><a href="#s6">填空表单</a></nav></header>
+
+<section id="s1" class="style-block">
+  <h2>样式一 · 极简线框</h2><p class="desc">无竖线、仅细横线分隔，大留白、左对齐抬头 —— 清爽现代，激光打印省墨。</p>
+  <div class="sheet s1"><div class="doc">
+  <div class="hd"><div class="co">鼎晟酒行</div><div class="ty">入 库 单</div></div>
+  <div class="meta">
+    <div class="meta-row r1"><span class="m m-partner">单位名称：丁小峰</span><span class="m m-date">入库日期：2026-06-23</span><span class="m m-no">NO：RK20260623000013</span></div>
+    <div class="meta-row r2"><span class="m m-phone">联系电话：</span><span class="m m-addr">单位地址：</span><span class="m m-wh">仓库：鼎晟酒行</span></div>
+  </div>
+  <table><thead><tr><th>商品编号</th><th>商品名称</th><th>系列</th><th>规格</th><th>批次号</th><th>生产日期</th><th>数量</th><th>单价</th><th>金额</th><th>备注</th></tr></thead><tbody><tr><td class="">P1328</td><td class="">茅台1935原箱2026</td><td class="ctr">普通/53度</td><td class="ctr">500ml*6/件</td><td class="ctr">8719005920</td><td class="ctr">2026-02-28</td><td class="num">6</td><td class="num">600.00</td><td class="num">3600.00</td><td class=""></td></tr><tr><td class="">P1329</td><td class="">茅台1935原箱2026</td><td class="ctr">普通/53度</td><td class="ctr">500ml*6/件</td><td class="ctr">8719007000</td><td class="ctr">2026-02-28</td><td class="num">6</td><td class="num">600.00</td><td class="num">3600.00</td><td class=""></td></tr><tr><td class="">P1330</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-184/248896472708</td><td class="ctr">2026-06-01</td><td class="num">6</td><td class="num">3080.00</td><td class="num">18480.00</td><td class=""></td></tr><tr><td class="">P1331</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-126/009192582386</td><td class="ctr">2026-03-13</td><td class="num">6</td><td class="num">3080.00</td><td class="num">18480.00</td><td class=""></td></tr></tbody></table>
+  <div class="total"><span class="t-label">单据总计</span><span class="t-qty">数量 <b>24</b></span><span class="t-amt">金额 <b>44160.00</b></span></div>
+  <div class="sign"><span>出货人（签字）：</span><span>采购员：汤宇飞</span><span>制单人：汤宇飞</span></div></div></div>
+  <div class="sheet s1"><div class="doc">
+  <div class="hd"><div class="co">鼎晟酒行</div><div class="ty">出 库 单</div></div>
+  <div class="meta">
+    <div class="meta-row r1"><span class="m m-partner">客户名称：刘总</span><span class="m m-date">出库日期：2026-06-23</span><span class="m m-no">NO.CK20260623000020</span></div>
+    <div class="meta-row r2"><span class="m m-phone">联系电话：</span><span class="m m-addr">送货地址：</span><span class="m m-wh">仓库：鼎晟酒行</span></div>
+  </div>
+  <table><thead><tr><th>商品编号</th><th>商品名称</th><th>系列</th><th>规格</th><th>批次号</th><th>生产日期</th><th>数量</th><th>单价</th><th>金额</th><th>备注</th></tr></thead><tbody><tr><td class="">P1331</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-126/009192582386</td><td class="ctr">2026-03-13</td><td class="num">1</td><td class="num">3080.00</td><td class="num">3080.00</td><td class=""></td></tr><tr><td class="">P1330</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-184/248896472708</td><td class="ctr">2026-06-01</td><td class="num">1</td><td class="num">3080.00</td><td class="num">3080.00</td><td class=""></td></tr></tbody></table>
+  <div class="total"><span class="t-label">单据总计</span><span class="t-qty">数量 <b>2</b></span><span class="t-amt">金额 <b>6160.00</b></span></div>
+  <div class="tips">温馨提示：签收时，请务必核对好酒品数量、年份和日期、批次及物流码，如有问题及时反馈，酒品无质量问题一经售出概不退换，谢谢合作。</div><div class="sign"><span>收货人（签字）：</span><span>销售员：汤宇飞</span><span>制单人：汤宇飞</span></div></div></div>
+</section>
+<section id="s2" class="style-block">
+  <h2>样式二 · 现代分区</h2><p class="desc">抬头字段做成带框表单格、明细斑马纹、总计高亮条 —— 信息分区清晰。</p>
+  <div class="sheet s2"><div class="doc">
+  <div class="hd"><div class="co">鼎晟酒行</div><div class="ty">入 库 单</div></div>
+  <div class="meta">
+    <div class="meta-row r1"><span class="m m-partner">单位名称：丁小峰</span><span class="m m-date">入库日期：2026-06-23</span><span class="m m-no">NO：RK20260623000013</span></div>
+    <div class="meta-row r2"><span class="m m-phone">联系电话：</span><span class="m m-addr">单位地址：</span><span class="m m-wh">仓库：鼎晟酒行</span></div>
+  </div>
+  <table><thead><tr><th>商品编号</th><th>商品名称</th><th>系列</th><th>规格</th><th>批次号</th><th>生产日期</th><th>数量</th><th>单价</th><th>金额</th><th>备注</th></tr></thead><tbody><tr><td class="">P1328</td><td class="">茅台1935原箱2026</td><td class="ctr">普通/53度</td><td class="ctr">500ml*6/件</td><td class="ctr">8719005920</td><td class="ctr">2026-02-28</td><td class="num">6</td><td class="num">600.00</td><td class="num">3600.00</td><td class=""></td></tr><tr><td class="">P1329</td><td class="">茅台1935原箱2026</td><td class="ctr">普通/53度</td><td class="ctr">500ml*6/件</td><td class="ctr">8719007000</td><td class="ctr">2026-02-28</td><td class="num">6</td><td class="num">600.00</td><td class="num">3600.00</td><td class=""></td></tr><tr><td class="">P1330</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-184/248896472708</td><td class="ctr">2026-06-01</td><td class="num">6</td><td class="num">3080.00</td><td class="num">18480.00</td><td class=""></td></tr><tr><td class="">P1331</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-126/009192582386</td><td class="ctr">2026-03-13</td><td class="num">6</td><td class="num">3080.00</td><td class="num">18480.00</td><td class=""></td></tr></tbody></table>
+  <div class="total"><span class="t-label">单据总计</span><span class="t-qty">数量 <b>24</b></span><span class="t-amt">金额 <b>44160.00</b></span></div>
+  <div class="sign"><span>出货人（签字）：</span><span>采购员：汤宇飞</span><span>制单人：汤宇飞</span></div></div></div>
+  <div class="sheet s2"><div class="doc">
+  <div class="hd"><div class="co">鼎晟酒行</div><div class="ty">出 库 单</div></div>
+  <div class="meta">
+    <div class="meta-row r1"><span class="m m-partner">客户名称：刘总</span><span class="m m-date">出库日期：2026-06-23</span><span class="m m-no">NO.CK20260623000020</span></div>
+    <div class="meta-row r2"><span class="m m-phone">联系电话：</span><span class="m m-addr">送货地址：</span><span class="m m-wh">仓库：鼎晟酒行</span></div>
+  </div>
+  <table><thead><tr><th>商品编号</th><th>商品名称</th><th>系列</th><th>规格</th><th>批次号</th><th>生产日期</th><th>数量</th><th>单价</th><th>金额</th><th>备注</th></tr></thead><tbody><tr><td class="">P1331</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-126/009192582386</td><td class="ctr">2026-03-13</td><td class="num">1</td><td class="num">3080.00</td><td class="num">3080.00</td><td class=""></td></tr><tr><td class="">P1330</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-184/248896472708</td><td class="ctr">2026-06-01</td><td class="num">1</td><td class="num">3080.00</td><td class="num">3080.00</td><td class=""></td></tr></tbody></table>
+  <div class="total"><span class="t-label">单据总计</span><span class="t-qty">数量 <b>2</b></span><span class="t-amt">金额 <b>6160.00</b></span></div>
+  <div class="tips">温馨提示：签收时，请务必核对好酒品数量、年份和日期、批次及物流码，如有问题及时反馈，酒品无质量问题一经售出概不退换，谢谢合作。</div><div class="sign"><span>收货人（签字）：</span><span>销售员：汤宇飞</span><span>制单人：汤宇飞</span></div></div></div>
+</section>
+<section id="s3" class="style-block">
+  <h2>样式三 · 紧凑报表</h2><p class="desc">小字号、数字等宽对齐、左侧竖线点缀 —— 单页能塞更多行，密集报表风。</p>
+  <div class="sheet s3"><div class="doc">
+  <div class="hd"><div class="co">鼎晟酒行</div><div class="ty">入 库 单</div></div>
+  <div class="meta">
+    <div class="meta-row r1"><span class="m m-partner">单位名称：丁小峰</span><span class="m m-date">入库日期：2026-06-23</span><span class="m m-no">NO：RK20260623000013</span></div>
+    <div class="meta-row r2"><span class="m m-phone">联系电话：</span><span class="m m-addr">单位地址：</span><span class="m m-wh">仓库：鼎晟酒行</span></div>
+  </div>
+  <table><thead><tr><th>商品编号</th><th>商品名称</th><th>系列</th><th>规格</th><th>批次号</th><th>生产日期</th><th>数量</th><th>单价</th><th>金额</th><th>备注</th></tr></thead><tbody><tr><td class="">P1328</td><td class="">茅台1935原箱2026</td><td class="ctr">普通/53度</td><td class="ctr">500ml*6/件</td><td class="ctr">8719005920</td><td class="ctr">2026-02-28</td><td class="num">6</td><td class="num">600.00</td><td class="num">3600.00</td><td class=""></td></tr><tr><td class="">P1329</td><td class="">茅台1935原箱2026</td><td class="ctr">普通/53度</td><td class="ctr">500ml*6/件</td><td class="ctr">8719007000</td><td class="ctr">2026-02-28</td><td class="num">6</td><td class="num">600.00</td><td class="num">3600.00</td><td class=""></td></tr><tr><td class="">P1330</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-184/248896472708</td><td class="ctr">2026-06-01</td><td class="num">6</td><td class="num">3080.00</td><td class="num">18480.00</td><td class=""></td></tr><tr><td class="">P1331</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-126/009192582386</td><td class="ctr">2026-03-13</td><td class="num">6</td><td class="num">3080.00</td><td class="num">18480.00</td><td class=""></td></tr></tbody></table>
+  <div class="total"><span class="t-label">单据总计</span><span class="t-qty">数量 <b>24</b></span><span class="t-amt">金额 <b>44160.00</b></span></div>
+  <div class="sign"><span>出货人（签字）：</span><span>采购员：汤宇飞</span><span>制单人：汤宇飞</span></div></div></div>
+  <div class="sheet s3"><div class="doc">
+  <div class="hd"><div class="co">鼎晟酒行</div><div class="ty">出 库 单</div></div>
+  <div class="meta">
+    <div class="meta-row r1"><span class="m m-partner">客户名称：刘总</span><span class="m m-date">出库日期：2026-06-23</span><span class="m m-no">NO.CK20260623000020</span></div>
+    <div class="meta-row r2"><span class="m m-phone">联系电话：</span><span class="m m-addr">送货地址：</span><span class="m m-wh">仓库：鼎晟酒行</span></div>
+  </div>
+  <table><thead><tr><th>商品编号</th><th>商品名称</th><th>系列</th><th>规格</th><th>批次号</th><th>生产日期</th><th>数量</th><th>单价</th><th>金额</th><th>备注</th></tr></thead><tbody><tr><td class="">P1331</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-126/009192582386</td><td class="ctr">2026-03-13</td><td class="num">1</td><td class="num">3080.00</td><td class="num">3080.00</td><td class=""></td></tr><tr><td class="">P1330</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-184/248896472708</td><td class="ctr">2026-06-01</td><td class="num">1</td><td class="num">3080.00</td><td class="num">3080.00</td><td class=""></td></tr></tbody></table>
+  <div class="total"><span class="t-label">单据总计</span><span class="t-qty">数量 <b>2</b></span><span class="t-amt">金额 <b>6160.00</b></span></div>
+  <div class="tips">温馨提示：签收时，请务必核对好酒品数量、年份和日期、批次及物流码，如有问题及时反馈，酒品无质量问题一经售出概不退换，谢谢合作。</div><div class="sign"><span>收货人（签字）：</span><span>销售员：汤宇飞</span><span>制单人：汤宇飞</span></div></div></div>
+</section>
+<section id="s4" class="style-block">
+  <h2>样式四 · 西式发票</h2><p class="desc">左上大字号商号 + 右上单号块、底部「单据总计」金额栈、字母大写小标题 —— 借鉴欧美 INVOICE。</p>
+  <div class="sheet s4"><div class="doc">
+  <div class="topbar"><div class="co">鼎晟酒行</div>
+    <div class="docmeta"><div class="doctype">入 库 单</div>
+      <div class="mbox"><div>NO：RK20260623000013</div><div>入库日期：2026-06-23</div><div>仓库：鼎晟酒行</div></div></div></div>
+  <div class="party"><div class="plabel">往来信息</div>
+    <div class="pgrid"><span>单位名称：丁小峰</span><span>联系电话：</span><span>单位地址：</span></div></div>
+  <div class="seclabel">商品明细 / ITEMS</div>
+  <table><thead><tr><th>商品编号</th><th>商品名称</th><th>系列</th><th>规格</th><th>批次号</th><th>生产日期</th><th>数量</th><th>单价</th><th>金额</th><th>备注</th></tr></thead><tbody><tr><td class="">P1328</td><td class="">茅台1935原箱2026</td><td class="ctr">普通/53度</td><td class="ctr">500ml*6/件</td><td class="ctr">8719005920</td><td class="ctr">2026-02-28</td><td class="num">6</td><td class="num">600.00</td><td class="num">3600.00</td><td class=""></td></tr><tr><td class="">P1329</td><td class="">茅台1935原箱2026</td><td class="ctr">普通/53度</td><td class="ctr">500ml*6/件</td><td class="ctr">8719007000</td><td class="ctr">2026-02-28</td><td class="num">6</td><td class="num">600.00</td><td class="num">3600.00</td><td class=""></td></tr><tr><td class="">P1330</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-184/248896472708</td><td class="ctr">2026-06-01</td><td class="num">6</td><td class="num">3080.00</td><td class="num">18480.00</td><td class=""></td></tr><tr><td class="">P1331</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-126/009192582386</td><td class="ctr">2026-03-13</td><td class="num">6</td><td class="num">3080.00</td><td class="num">18480.00</td><td class=""></td></tr></tbody></table>
+  <div class="grand"><div class="g1">单据总计</div>
+    <div class="g2"><span>数量</span><b>24</b></div>
+    <div class="g3"><span>金额</span><b>44160.00</b></div></div>
+  <div class="sign"><span>出货人（签字）：</span><span>采购员：汤宇飞</span><span>制单人：汤宇飞</span></div></div></div>
+  <div class="sheet s4"><div class="doc">
+  <div class="topbar"><div class="co">鼎晟酒行</div>
+    <div class="docmeta"><div class="doctype">出 库 单</div>
+      <div class="mbox"><div>NO.CK20260623000020</div><div>出库日期：2026-06-23</div><div>仓库：鼎晟酒行</div></div></div></div>
+  <div class="party"><div class="plabel">往来信息</div>
+    <div class="pgrid"><span>客户名称：刘总</span><span>联系电话：</span><span>送货地址：</span></div></div>
+  <div class="seclabel">商品明细 / ITEMS</div>
+  <table><thead><tr><th>商品编号</th><th>商品名称</th><th>系列</th><th>规格</th><th>批次号</th><th>生产日期</th><th>数量</th><th>单价</th><th>金额</th><th>备注</th></tr></thead><tbody><tr><td class="">P1331</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-126/009192582386</td><td class="ctr">2026-03-13</td><td class="num">1</td><td class="num">3080.00</td><td class="num">3080.00</td><td class=""></td></tr><tr><td class="">P1330</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-184/248896472708</td><td class="ctr">2026-06-01</td><td class="num">1</td><td class="num">3080.00</td><td class="num">3080.00</td><td class=""></td></tr></tbody></table>
+  <div class="grand"><div class="g1">单据总计</div>
+    <div class="g2"><span>数量</span><b>2</b></div>
+    <div class="g3"><span>金额</span><b>6160.00</b></div></div>
+  <div class="tips">温馨提示：签收时，请务必核对好酒品数量、年份和日期、批次及物流码，如有问题及时反馈，酒品无质量问题一经售出概不退换，谢谢合作。</div><div class="sign"><span>收货人（签字）：</span><span>销售员：汤宇飞</span><span>制单人：汤宇飞</span></div></div></div>
+</section>
+<section id="s5" class="style-block">
+  <h2>样式五 · 瑞士网格</h2><p class="desc">超大标题 + 细基线网格、小标签等宽数字、表格仅上下粗线 —— 杂志/瑞士排版。</p>
+  <div class="sheet s5"><div class="doc">
+  <div class="kicker">鼎晟酒行</div>
+  <h1 class="headline">入 库 单</h1>
+  <div class="metaline"><span><i>单号</i>RK20260623000013</span><span><i>入库日期</i>2026-06-23</span><span><i>单位名称</i>丁小峰</span><span><i>仓库</i>鼎晟酒行</span></div>
+  <div class="sec">商品明细</div>
+  <table><thead><tr><th>商品编号</th><th>商品名称</th><th>系列</th><th>规格</th><th>批次号</th><th>生产日期</th><th>数量</th><th>单价</th><th>金额</th><th>备注</th></tr></thead><tbody><tr><td class="">P1328</td><td class="">茅台1935原箱2026</td><td class="ctr">普通/53度</td><td class="ctr">500ml*6/件</td><td class="ctr">8719005920</td><td class="ctr">2026-02-28</td><td class="num">6</td><td class="num">600.00</td><td class="num">3600.00</td><td class=""></td></tr><tr><td class="">P1329</td><td class="">茅台1935原箱2026</td><td class="ctr">普通/53度</td><td class="ctr">500ml*6/件</td><td class="ctr">8719007000</td><td class="ctr">2026-02-28</td><td class="num">6</td><td class="num">600.00</td><td class="num">3600.00</td><td class=""></td></tr><tr><td class="">P1330</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-184/248896472708</td><td class="ctr">2026-06-01</td><td class="num">6</td><td class="num">3080.00</td><td class="num">18480.00</td><td class=""></td></tr><tr><td class="">P1331</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-126/009192582386</td><td class="ctr">2026-03-13</td><td class="num">6</td><td class="num">3080.00</td><td class="num">18480.00</td><td class=""></td></tr></tbody></table>
+  <div class="total8"><span>单据总计</span><em>数量</em><b>24</b><em>金额</em><b>44160.00</b></div>
+  <div class="sign"><span>出货人（签字）：</span><span>采购员：汤宇飞</span><span>制单人：汤宇飞</span></div></div></div>
+  <div class="sheet s5"><div class="doc">
+  <div class="kicker">鼎晟酒行</div>
+  <h1 class="headline">出 库 单</h1>
+  <div class="metaline"><span><i>单号</i>CK20260623000020</span><span><i>出库日期</i>2026-06-23</span><span><i>客户名称</i>刘总</span><span><i>仓库</i>鼎晟酒行</span></div>
+  <div class="sec">商品明细</div>
+  <table><thead><tr><th>商品编号</th><th>商品名称</th><th>系列</th><th>规格</th><th>批次号</th><th>生产日期</th><th>数量</th><th>单价</th><th>金额</th><th>备注</th></tr></thead><tbody><tr><td class="">P1331</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-126/009192582386</td><td class="ctr">2026-03-13</td><td class="num">1</td><td class="num">3080.00</td><td class="num">3080.00</td><td class=""></td></tr><tr><td class="">P1330</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-184/248896472708</td><td class="ctr">2026-06-01</td><td class="num">1</td><td class="num">3080.00</td><td class="num">3080.00</td><td class=""></td></tr></tbody></table>
+  <div class="total8"><span>单据总计</span><em>数量</em><b>2</b><em>金额</em><b>6160.00</b></div>
+  <div class="tips">温馨提示：签收时，请务必核对好酒品数量、年份和日期、批次及物流码，如有问题及时反馈，酒品无质量问题一经售出概不退换，谢谢合作。</div><div class="sign"><span>收货人（签字）：</span><span>销售员：汤宇飞</span><span>制单人：汤宇飞</span></div></div></div>
+</section>
+<section id="s6" class="style-block">
+  <h2>样式六 · 填空表单</h2><p class="desc">双线外框、字段下划线填空、底部多签字格 —— 仿手工三联单/预印单据，正式可手填。</p>
+  <div class="sheet s6"><div class="doc form9"><div class="frame">
+  <div class="co9">鼎晟酒行</div>
+  <div class="title9">入 库 单</div>
+  <div class="meta9">
+    <div class="f"><label>单位名称</label><span class="fill">丁小峰</span></div>
+    <div class="f"><label>入库日期</label><span class="fill">2026-06-23</span></div>
+    <div class="f"><label>单据编号</label><span class="fill">RK20260623000013</span></div>
+    <div class="f"><label>联系电话</label><span class="fill"></span></div>
+    <div class="f"><label>单位地址</label><span class="fill"></span></div>
+    <div class="f"><label>仓库</label><span class="fill">鼎晟酒行</span></div>
+  </div>
+  <table><thead><tr><th>商品编号</th><th>商品名称</th><th>系列</th><th>规格</th><th>批次号</th><th>生产日期</th><th>数量</th><th>单价</th><th>金额</th><th>备注</th></tr></thead><tbody><tr><td class="">P1328</td><td class="">茅台1935原箱2026</td><td class="ctr">普通/53度</td><td class="ctr">500ml*6/件</td><td class="ctr">8719005920</td><td class="ctr">2026-02-28</td><td class="num">6</td><td class="num">600.00</td><td class="num">3600.00</td><td class=""></td></tr><tr><td class="">P1329</td><td class="">茅台1935原箱2026</td><td class="ctr">普通/53度</td><td class="ctr">500ml*6/件</td><td class="ctr">8719007000</td><td class="ctr">2026-02-28</td><td class="num">6</td><td class="num">600.00</td><td class="num">3600.00</td><td class=""></td></tr><tr><td class="">P1330</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-184/248896472708</td><td class="ctr">2026-06-01</td><td class="num">6</td><td class="num">3080.00</td><td class="num">18480.00</td><td class=""></td></tr><tr><td class="">P1331</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-126/009192582386</td><td class="ctr">2026-03-13</td><td class="num">6</td><td class="num">3080.00</td><td class="num">18480.00</td><td class=""></td></tr></tbody></table>
+  <div class="total9"><span>单据总计</span><span>数量 24</span><span>金额 44160.00</span></div>
+  
+  <div class="sign9"><div>出货人（签字）：</div><div>采购员：汤宇飞</div><div>制单人：汤宇飞</div></div>
+  </div></div></div>
+  <div class="sheet s6"><div class="doc form9"><div class="frame">
+  <div class="co9">鼎晟酒行</div>
+  <div class="title9">出 库 单</div>
+  <div class="meta9">
+    <div class="f"><label>客户名称</label><span class="fill">刘总</span></div>
+    <div class="f"><label>出库日期</label><span class="fill">2026-06-23</span></div>
+    <div class="f"><label>单据编号</label><span class="fill">CK20260623000020</span></div>
+    <div class="f"><label>联系电话</label><span class="fill"></span></div>
+    <div class="f"><label>送货地址</label><span class="fill"></span></div>
+    <div class="f"><label>仓库</label><span class="fill">鼎晟酒行</span></div>
+  </div>
+  <table><thead><tr><th>商品编号</th><th>商品名称</th><th>系列</th><th>规格</th><th>批次号</th><th>生产日期</th><th>数量</th><th>单价</th><th>金额</th><th>备注</th></tr></thead><tbody><tr><td class="">P1331</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-126/009192582386</td><td class="ctr">2026-03-13</td><td class="num">1</td><td class="num">3080.00</td><td class="num">3080.00</td><td class=""></td></tr><tr><td class="">P1330</td><td class="">茅台公斤2026原箱</td><td class="ctr">普通/53度</td><td class="ctr">1.00L*6/件</td><td class="ctr">2025-184/248896472708</td><td class="ctr">2026-06-01</td><td class="num">1</td><td class="num">3080.00</td><td class="num">3080.00</td><td class=""></td></tr></tbody></table>
+  <div class="total9"><span>单据总计</span><span>数量 2</span><span>金额 6160.00</span></div>
+  <div class="tips">温馨提示：签收时，请务必核对好酒品数量、年份和日期、批次及物流码，如有问题及时反馈，酒品无质量问题一经售出概不退换，谢谢合作。</div>
+  <div class="sign9"><div>收货人（签字）：</div><div>销售员：汤宇飞</div><div>制单人：汤宇飞</div></div>
+  </div></div></div>
+</section>
+</body></html>
@@ -0,0 +1,118 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>暂估价 → 确认进价 设计 — 酒库管理系统</title>
+<style>
+  :root{
+    --primary:#2563AC; --primary-dark:#154072; --danger:#D14343; --danger-bg:#FDECEC;
+    --success:#2E8B57; --warn:#B45309; --accent:#8B2331;
+    --ink:#232934; --muted:#6E7888; --border:#DCE2EB; --paper:#F5F7FA; --head:#F0F4FF;
+  }
+  *{box-sizing:border-box;font-family:-apple-system,"PingFang SC","Microsoft YaHei",sans-serif;}
+  body{margin:0;background:var(--paper);color:var(--ink);padding:28px;line-height:1.65;}
+  h1{font-size:20px;margin:0 0 4px;}
+  h2{font-size:16px;margin:26px 0 8px;color:var(--primary-dark);border-left:4px solid var(--primary);padding-left:10px;}
+  h3{font-size:14px;margin:18px 0 6px;color:var(--accent);}
+  .sub{color:var(--muted);font-size:13px;margin-bottom:18px;}
+  .card{background:#fff;border:1px solid var(--border);border-radius:10px;padding:16px 20px;max-width:920px;margin-bottom:16px;}
+  p{font-size:14px;margin:6px 0;}
+  code{font-family:ui-monospace,Menlo,monospace;font-size:12.5px;background:#EEF2F8;padding:1px 5px;border-radius:4px;color:var(--primary-dark);}
+  ol,ul{font-size:14px;margin:6px 0;padding-left:22px;}
+  li{margin:4px 0;}
+  table{width:100%;border-collapse:collapse;font-size:13px;max-width:920px;margin:8px 0;}
+  th{background:var(--head);color:var(--primary-dark);font-weight:600;font-size:12px;text-align:left;padding:9px 10px;border:1px solid var(--border);}
+  td{padding:9px 10px;border:1px solid #EEF1F5;vertical-align:top;}
+  .tag{font-size:11px;padding:2px 8px;border-radius:10px;display:inline-block;}
+  .tag.ok{background:#E6F3EC;color:var(--success);}
+  .tag.warn{background:#FFF4E5;color:var(--warn);}
+  .tag.no{background:var(--danger-bg);color:var(--danger);}
+  .lead{font-size:14px;background:#F0F6FF;border-left:3px solid var(--primary);padding:10px 14px;border-radius:4px;max-width:920px;}
+  .flow{font-family:ui-monospace,Menlo,monospace;font-size:13px;background:#1d2430;color:#e6edf6;padding:14px 18px;border-radius:8px;max-width:920px;overflow:auto;}
+  .flow .c{color:#7fd1a0;}
+</style>
+</head>
+<body>
+  <h1>暂估价（0 价）→ 确认进价 · 设计方案</h1>
+  <div class="sub">调货「先卖后定价」场景 · 分支 feature/jiu_20260623 · 2026-06-23</div>
+
+  <div class="lead">
+    从朋友处调货，价格未定时以 <b>进价 0（暂估）</b> 入库并照常审核、出库售卖；价格确定后，对该入库单执行
+    <b>「确认进价」</b>——系统<b>前向补偿</b>真实成本（不反审核、不撤销任何已发生的动作）：回填库存成本、已出库成本快照，
+    并按差额补一条应付流水。售价 / 应收完全不受影响。
+  </div>
+
+  <h2>1. 背景与取舍</h2>
+  <div class="card">
+    <p>老系统做法是「入库价填 0 → 出库 → <b>反审核</b>入库单改价 → 重审」。新系统已审核单据只读、无反审核、流水不可变、库存成本一旦落地无修改接口——强行复刻反审核在「货已出库」时几乎无法回滚干净，且违反现有不可变设计。</p>
+    <p>故改用会计上的「暂估入库 → 实际成本确认」模型：<b>不反审核</b>，以一次前向调整补齐成本与应付。关键前提是新系统的<b>序列号数据模型</b>让这件事变得精确——</p>
+    <ul>
+      <li><b>product ↔ 入库明细 1:1</b>：每行入库新建一个独立 product（序列号），出库明细也带 <code>product_id</code>。因此「某次调货的成本」就是「某个 product 的成本」，可凭 <code>product_id</code> 精确回填到它的所有已出库行，<b>无需额外的批次消耗映射表</b>。</li>
+      <li><b>库存成本天然可空</b>：<code>inventories.unit_price</code> 为 <code>*float64</code>，0 价入库即存 <code>NULL</code>，<b>天然表示「待定价」</b>。</li>
+    </ul>
+    <p>用户确认的口径：①不填预估、直接填 0；②确认后补成本 + 补应付流水；③调货<b>不</b>单独建单据类型，复用普通入库单；④利润统计遇到无进价的行须跳过并单独说明。</p>
+    <p><b>简化决策</b>：不新增 schema 字段（遵循「禁止为每个业务字段改表结构」）。约定 <b>成本待定 = 成本为 0 / <code>unit_price</code> 为 NULL</b>。调货白酒成本不会真为 0，歧义可忽略。</p>
+  </div>
+
+  <h2>2. 核心动作：确认进价</h2>
+  <div class="card">
+    <p>接口：<code>POST /api/v1/stock-in/orders/:id/confirm-cost</code>，body <code>{"items":[{"item_id":N,"unit_price":50.0}]}</code>。
+    仅 <b>approved</b> 单可确认（draft 直接编辑即可）；权限 <b>管理员/超管</b>；后端实现 <code>StockService.ConfirmStockInCost</code>。</p>
+    <p>一个事务内，对每个有变化的明细（旧价→新价，差额 <code>diff = (new-old)×qty</code>）前向写补偿：</p>
+    <div class="flow">
+1. <span class="c">入库明细</span>   StockInItem.unit_price / total_price 改为真实值
+2. <span class="c">剩余库存</span>   Inventory.unit_price  NULL → 真实值  (按 stock_in_item_id；已全出则无行)
+3. <span class="c">已出库行</span>   StockOutItem.unit_price / total_price 回填  (按 product_id；不动 sale_price)
+4. <span class="c">入库单总额</span>  StockInOrder.total_amount += Σ diff
+5. <span class="c">应付差额</span>   新增 FinanceRecord{type:payable, amount:Σdiff, ref_type:stock_in_cost_adjust}
+6. <span class="c">参考进价</span>   Product.purchase_price 同步（按 product_id）
+    </div>
+    <p><b>幂等 / 可重复</b>：以「旧价→新价」差额计算，多次修正各补一条差额流水（如 0→50 补 +500，再 50→60 补 +100）。</p>
+    <p><b>应付余额语义</b>：<code>balance</code> 是该往来单位「应收 + 应付」混合的滚动总账（沿用既有 <code>partnerLastBalance</code>），确认流水在此基础上累加差额。</p>
+  </div>
+
+  <h2>3. 影响矩阵</h2>
+  <table>
+    <tr><th>数据</th><th>0 价入库审核后</th><th>确认进价后</th></tr>
+    <tr><td>入库明细 unit_price</td><td>0</td><td><span class="tag ok">→ 真实价</span></td></tr>
+    <tr><td>库存批次 unit_price</td><td>NULL（待定）</td><td><span class="tag ok">→ 真实价</span></td></tr>
+    <tr><td>已出库行 unit_price（成本快照）</td><td>0</td><td><span class="tag ok">→ 真实价（按 product_id）</span></td></tr>
+    <tr><td>出库 sale_price / 应收</td><td>正常</td><td><span class="tag ok">不变</span></td></tr>
+    <tr><td>入库单 total_amount</td><td>0</td><td><span class="tag ok">→ Σ 真实小计</span></td></tr>
+    <tr><td>对供应商应付</td><td>+0</td><td><span class="tag ok">补一条 +差额 流水</span></td></tr>
+  </table>
+
+  <h2>4. 边界</h2>
+  <div class="card">
+    <ul>
+      <li><b>未出库就确认</b>：只走第 1/2/4/5/6 步（无已出库行可回填）。</li>
+      <li><b>部分出库</b>：剩余批次更新 + 已出行回填，各自按 <code>product_id</code> 命中。</li>
+      <li><b>退货</b>（<code>returned_quantity</code>）：按现有快照同样回填 <code>unit_price</code>，退货金额逻辑不变；如需特殊冲减再议。</li>
+      <li><b>历史导入单</b>（共享占位 product，<code>product_id=0</code>）：不向出库行/参考进价传播（避免误伤），仅改本单明细与库存。</li>
+      <li><b>校验</b>：进价必须 &gt; 0；非管理员 403；非 approved 单 400。</li>
+    </ul>
+  </div>
+
+  <h2>5. 前端</h2>
+  <div class="card">
+    <ul>
+      <li><b>待定价标注</b>：库存列表、入库单明细单价/金额为 0/NULL 时显示「待定价」（橙色），而非 <code>-</code> 或 <code>¥0.00</code>。</li>
+      <li><b>确认进价入口</b>：入库单详情弹窗中，单据为 <b>已审核</b> 且含待定行、且当前用户为管理员时，显示「确认进价」按钮 → 弹窗逐行填真实进价 → 调接口 → 刷新详情与列表。</li>
+    </ul>
+  </div>
+
+  <h2>6. 利润口径（前瞻约定）</h2>
+  <div class="card">
+    <p>系统当前<b>无</b>利润/毛利报表，本次<b>不</b>新建（YAGNI）。约定：<b>未来任何利润/毛利统计，须排除成本待定（<code>unit_price ≤ 0 / NULL</code>）的出库行，并单独列「N 笔成本待定，未计入利润」。</b> 本设计的「待定价」标识即为该口径提供可识别依据。</p>
+  </div>
+
+  <h2>7. 关键文件</h2>
+  <div class="card">
+    <ul>
+      <li>后端：<code>backend/internal/service/stock.go</code>（<code>ConfirmStockInCost</code> + <code>CostConfirmItem</code>）、<code>internal/handler/stock_in.go</code>（<code>ConfirmCost</code>）、<code>internal/router/router.go</code>、<code>internal/handler/stock_cost_confirm_test.go</code>（4 用例：回填+应付 / 403 / 非 approved / 重复确认）。</li>
+      <li>前端：<code>client/lib/repositories/stock_in_repository.dart</code>（<code>confirmCost</code>）、<code>client/lib/screens/stock_in/stock_in_list_screen.dart</code>（确认进价弹窗 + 待定价）、<code>client/lib/screens/inventory/inventory_list_screen.dart</code>（待定价）。</li>
+    </ul>
+  </div>
+</body>
+</html>
@@ -0,0 +1,60 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>文档索引 — 酒库管理系统</title>
+<style>
+  :root{
+    --primary:#2563AC; --primary-dark:#154072; --accent:#8B2331;
+    --ink:#232934; --muted:#6E7888; --border:#DCE2EB; --paper:#F5F7FA; --head:#F0F4FF;
+  }
+  *{box-sizing:border-box;font-family:-apple-system,"PingFang SC","Microsoft YaHei",sans-serif;}
+  body{margin:0;background:var(--paper);color:var(--ink);padding:28px;line-height:1.6;}
+  h1{font-size:20px;margin:0 0 4px;}
+  .sub{color:var(--muted);font-size:13px;margin-bottom:20px;}
+  h2{font-size:15px;margin:24px 0 8px;color:var(--primary-dark);border-bottom:2px solid var(--head);padding-bottom:6px;}
+  ul{margin:6px 0;padding-left:20px;}
+  li{margin:5px 0;font-size:13.5px;}
+  a{color:var(--primary);text-decoration:none;}
+  a:hover{text-decoration:underline;}
+  .hint{color:var(--muted);font-size:12px;}
+  .tag{display:inline-block;font-size:10px;padding:1px 7px;border-radius:9px;background:#EEF2F8;color:var(--muted);margin-left:6px;}
+  .tag.html{background:#E5EEF9;color:var(--primary);}
+</style>
+</head>
+<body>
+  <h1>酒库管理系统 · 文档索引</h1>
+  <div class="sub">项目所有文档的单一入口。新增文档须同时登记到此处。</div>
+
+  <h2>设计方案 / 原型</h2>
+  <ul>
+    <li><a href="design/order-return-prototype.html">退单原型（已审核单据）</a><span class="tag html">HTML</span></li>
+    <li><a href="design/order-print-layouts.html">出入库单打印排版方案（6 种黑白样式精选）</a><span class="tag html">HTML</span> · <a href="design/order-print-layouts.pdf">PDF</a></li>
+  </ul>
+
+  <h2>实现计划</h2>
+  <ul>
+    <li class="hint">（暂无）</li>
+  </ul>
+
+  <h2>排障 / 运维 Runbook</h2>
+  <ul>
+    <li><a href="runbooks/ec2-to-ali-migration.html">EC2 → 阿里云 迁移计划</a><span class="tag html">HTML</span> <span class="hint">— jiu 服务/数据/DB/文件/域名/CI 整体迁移</span></li>
+  </ul>
+
+  <h2>知识库 / 调研 / 测试</h2>
+  <ul>
+    <li><a href="testing/license-test-flow.html">授权兑换券测试流程</a><span class="tag html">HTML</span></li>
+  </ul>
+
+  <h2>历史 Markdown 文档（逐步迁移）</h2>
+  <ul>
+    <li><a href="deployment-nas-gitea.md">部署：NAS Gitea/Forgejo</a><span class="tag">MD</span></li>
+    <li><a href="dev-setup.md">开发环境搭建</a><span class="tag">MD</span></li>
+    <li><a href="android-signing.md">Android 签名</a> · <a href="ios-signing.md">iOS 签名</a> · <a href="macos-signing.md">macOS 签名</a><span class="tag">MD</span></li>
+    <li><a href="user-manual.md">用户手册</a><span class="tag">MD</span></li>
+    <li class="hint">另有 api/ architecture/ requirements/ review/ security/ runbooks/ context/ 等目录下的过程文档</li>
+  </ul>
+</body>
+</html>
@@ -26,6 +26,7 @@ mv backend/jiu-gencode dist/jiu-gencode
 # it belongs to the client pipeline.
 tar -czf dist/configs.tar.gz \
  deploy/nginx-jiu.conf \
+  deploy/nginx-jiu-ali.conf \
  deploy/jiu.service \
  deploy/production.env.template \
  deploy/setup-ec2.sh \
@@ -1,14 +1,17 @@
 #!/usr/bin/env bash
 # deploy-client.sh <tag>  —  deploy the Flutter web app, desktop/mobile installers,
-# and version.yaml to EC2. Does NOT restart the backend (version.yaml is read
-# per-request) nor touch nginx / the marketing site.
+# and version.yaml. Does NOT restart the backend (version.yaml is read
+# per-request) nor touch nginx / the marketing site. Target is EC2 by default;
+# set DEPLOY_HOST/DEPLOY_USER/DEPLOY_SSH_KEY to retarget the Ali box (migration).
 set -euo pipefail

 # shellcheck source=scripts/ci/lib-forgejo.sh
 . "$(dirname "$0")/lib-forgejo.sh"

 TAG="$1"
-echo "==> deploy-client: tag=${TAG}"
+TARGET_HOST="${DEPLOY_HOST:-$EC2_HOST}"
+TARGET_USER="${DEPLOY_USER:-$EC2_USER}"
+echo "==> deploy-client: tag=${TAG} host=${TARGET_HOST}"

 if [ ! -f dist/web.tar.gz ] || [ ! -f dist/version.yaml ]; then
  download_release_assets "$TAG"
@@ -27,18 +30,18 @@ mkdir -p /tmp/jiu-web-new
 tar -xzf dist/web.tar.gz -C /tmp/jiu-web-new --strip-components=1

 setup_ssh
-echo "==> deploy-client: uploading files to EC2"
-${SCP} "$VERSION_YAML" "${EC2_USER}@${EC2_HOST}:/tmp/version.yaml"
+echo "==> deploy-client: uploading files to ${TARGET_HOST}"
+${SCP} "$VERSION_YAML" "${TARGET_USER}@${TARGET_HOST}:/tmp/version.yaml"
 rsync -avz --delete -e "ssh -i ~/.ssh/ec2_deploy.pem -o StrictHostKeyChecking=no" \
-  /tmp/jiu-web-new/ "${EC2_USER}@${EC2_HOST}:/tmp/jiu-web-new/"
+  /tmp/jiu-web-new/ "${TARGET_USER}@${TARGET_HOST}:/tmp/jiu-web-new/"

 # Desktop / mobile installers (served from /downloads/ by nginx). Guarded —
 # may be absent in a partial manual deploy.
-[ -f dist/jiu-windows-x64-setup.exe ] && ${SCP} dist/jiu-windows-x64-setup.exe "${EC2_USER}@${EC2_HOST}:/tmp/jiu-windows-x64-setup.exe" || true
-[ -f dist/jiu-macos-x64.zip ] && ${SCP} dist/jiu-macos-x64.zip "${EC2_USER}@${EC2_HOST}:/tmp/jiu-macos-x64.zip" || true
-[ -f dist/jiu-android.apk ] && ${SCP} dist/jiu-android.apk "${EC2_USER}@${EC2_HOST}:/tmp/jiu-android.apk" || true
+[ -f dist/jiu-windows-x64-setup.exe ] && ${SCP} dist/jiu-windows-x64-setup.exe "${TARGET_USER}@${TARGET_HOST}:/tmp/jiu-windows-x64-setup.exe" || true
+[ -f dist/jiu-macos-x64.zip ] && ${SCP} dist/jiu-macos-x64.zip "${TARGET_USER}@${TARGET_HOST}:/tmp/jiu-macos-x64.zip" || true
+[ -f dist/jiu-android.apk ] && ${SCP} dist/jiu-android.apk "${TARGET_USER}@${TARGET_HOST}:/tmp/jiu-android.apk" || true

-${SSH} "${EC2_USER}@${EC2_HOST}" << 'ENDSSH'
+${SSH} "${TARGET_USER}@${TARGET_HOST}" << 'ENDSSH'
 set -e

 # Update version config (WorkingDirectory=/opt/jiu reads config/version.yaml).
@@ -1,15 +1,26 @@
 #!/usr/bin/env bash
-# deploy-server.sh <tag>  —  deploy the backend binary + nginx config to EC2.
-# Two modes: uses dist/ built in the same job, or downloads the release assets
-# by tag (manual rollback). Does NOT touch the web app, marketing site, or
-# version.yaml.
+# deploy-server.sh <tag>  —  deploy the backend binary + nginx config.
+# Two source modes: uses dist/ built in the same job, or downloads the release
+# assets by tag (manual rollback). Does NOT touch the web app, marketing site,
+# or version.yaml.
+#
+# Target is EC2 by default. During the EC2→Ali migration, set DEPLOY_TARGET=ali
+# plus DEPLOY_HOST/DEPLOY_USER/DEPLOY_SSH_KEY to deploy to the Alibaba Cloud box.
+#   - ec2 (default): stop jiu → swap binary → start jiu → health check →
+#                    reload nginx inside the pangolin-edge container.
+#   - ali: swap binary only (jiu.service stays stopped — the Ali DB is a
+#          read-only replica until cutover; backend is started at cutover) →
+#          reload the host nginx with the standalone (listen 443) config.
 set -euo pipefail

 # shellcheck source=scripts/ci/lib-forgejo.sh
 . "$(dirname "$0")/lib-forgejo.sh"

 TAG="$1"
-echo "==> deploy-server: tag=${TAG}"
+DEPLOY_TARGET="${DEPLOY_TARGET:-ec2}"
+TARGET_HOST="${DEPLOY_HOST:-$EC2_HOST}"
+TARGET_USER="${DEPLOY_USER:-$EC2_USER}"
+echo "==> deploy-server: tag=${TAG} target=${DEPLOY_TARGET} host=${TARGET_HOST}"

 if [ ! -f dist/jiu-server ] || [ ! -f dist/configs.tar.gz ]; then
  download_release_assets "$TAG"
@@ -22,19 +33,54 @@ rm -rf /tmp/jiu-configs
 mkdir -p /tmp/jiu-configs
 tar -xzf dist/configs.tar.gz -C /tmp/jiu-configs

+# Pick the nginx config matching the target's reverse-proxy topology.
+if [ "$DEPLOY_TARGET" = "ali" ]; then
+  NGINX_SRC=/tmp/jiu-configs/deploy/nginx-jiu-ali.conf
+else
+  NGINX_SRC=/tmp/jiu-configs/deploy/nginx-jiu.conf
+fi
+
 setup_ssh
-echo "==> deploy-server: uploading files to EC2"
-${SCP} dist/jiu-server "${EC2_USER}@${EC2_HOST}:/tmp/jiu-server"
-${SCP} /tmp/jiu-configs/deploy/nginx-jiu.conf "${EC2_USER}@${EC2_HOST}:/tmp/nginx-jiu.conf"
+echo "==> deploy-server: uploading files to ${TARGET_HOST}"
+${SCP} dist/jiu-server "${TARGET_USER}@${TARGET_HOST}:/tmp/jiu-server"
+${SCP} "${NGINX_SRC}" "${TARGET_USER}@${TARGET_HOST}:/tmp/nginx-jiu.conf"

 # Platform code-minting CLI + wrapper (absent when rolling back to a pre-gencode
 # release — upload only when present).
 if [ -f dist/jiu-gencode ]; then
-  ${SCP} dist/jiu-gencode "${EC2_USER}@${EC2_HOST}:/tmp/jiu-gencode"
-  ${SCP} /tmp/jiu-configs/deploy/jiu-gencode.sh "${EC2_USER}@${EC2_HOST}:/tmp/jiu-gencode.sh"
+  ${SCP} dist/jiu-gencode "${TARGET_USER}@${TARGET_HOST}:/tmp/jiu-gencode"
+  ${SCP} /tmp/jiu-configs/deploy/jiu-gencode.sh "${TARGET_USER}@${TARGET_HOST}:/tmp/jiu-gencode.sh"
 fi

-${SSH} "${EC2_USER}@${EC2_HOST}" << 'ENDSSH'
+if [ "$DEPLOY_TARGET" = "ali" ]; then
+  # --- Alibaba Cloud (shadow target, pre-cutover) ---
+  # Swap the binary but DO NOT start jiu: the Ali DB is a read-only replica, so
+  # the backend's startup AutoMigrate/backfill would fail. jiu.service is started
+  # only at cutover (after the replica is promoted to primary). Reload the host
+  # nginx with the standalone listen-443 config.
+  ${SSH} "${TARGET_USER}@${TARGET_HOST}" << 'ENDSSH'
+set -e
+
+cp /tmp/jiu-server /opt/jiu/backend/jiu-server
+chmod +x /opt/jiu/backend/jiu-server
+
+if [ -f /tmp/jiu-gencode ]; then
+  cp /tmp/jiu-gencode /opt/jiu/backend/jiu-gencode
+  chmod +x /opt/jiu/backend/jiu-gencode
+  if [ -f /tmp/jiu-gencode.sh ]; then
+    cp /tmp/jiu-gencode.sh /opt/jiu/backend/jiu-gencode.sh
+    chmod +x /opt/jiu/backend/jiu-gencode.sh
+  fi
+fi
+
+cp /tmp/nginx-jiu.conf /etc/nginx/conf.d/jiu.conf
+nginx -t && systemctl reload nginx
+
+echo "Ali server staged (binary swapped, jiu.service left stopped, nginx reloaded)"
+ENDSSH
+else
+  # --- EC2 (live primary) ---
+  ${SSH} "${TARGET_USER}@${TARGET_HOST}" << 'ENDSSH'
 set -e

 # Replace backend binary
@@ -72,7 +118,8 @@ docker exec pangolin-edge nginx -t && docker exec pangolin-edge nginx -s reload

 echo "Server deploy complete!"
 ENDSSH
+fi

 teardown_ssh
 rm -rf /tmp/jiu-configs
-echo "==> deploy-server: done"
+echo "==> deploy-server: done (target=${DEPLOY_TARGET})"
@@ -1,13 +1,16 @@
 #!/usr/bin/env bash
-# deploy-site.sh <tag>  —  deploy the Eleventy marketing site to EC2
-# (/opt/jiu/marketing). Does NOT restart the backend or touch nginx.
+# deploy-site.sh <tag>  —  deploy the Eleventy marketing site to /opt/jiu/marketing.
+# Does NOT restart the backend or touch nginx. Target is EC2 by default; set
+# DEPLOY_HOST/DEPLOY_USER/DEPLOY_SSH_KEY to retarget the Ali box (migration).
 set -euo pipefail

 # shellcheck source=scripts/ci/lib-forgejo.sh
 . "$(dirname "$0")/lib-forgejo.sh"

 TAG="$1"
-echo "==> deploy-site: tag=${TAG}"
+TARGET_HOST="${DEPLOY_HOST:-$EC2_HOST}"
+TARGET_USER="${DEPLOY_USER:-$EC2_USER}"
+echo "==> deploy-site: tag=${TAG} host=${TARGET_HOST}"

 if [ ! -f dist/marketing.tar.gz ]; then
  download_release_assets "$TAG"
@@ -21,11 +24,11 @@ mkdir -p /tmp/jiu-marketing-new
 tar -xzf dist/marketing.tar.gz -C /tmp/jiu-marketing-new

 setup_ssh
-echo "==> deploy-site: uploading marketing site to EC2"
+echo "==> deploy-site: uploading marketing site to ${TARGET_HOST}"
 rsync -avz --delete -e "ssh -i ~/.ssh/ec2_deploy.pem -o StrictHostKeyChecking=no" \
-  /tmp/jiu-marketing-new/ "${EC2_USER}@${EC2_HOST}:/tmp/jiu-marketing-new/"
+  /tmp/jiu-marketing-new/ "${TARGET_USER}@${TARGET_HOST}:/tmp/jiu-marketing-new/"

-${SSH} "${EC2_USER}@${EC2_HOST}" << 'ENDSSH'
+${SSH} "${TARGET_USER}@${TARGET_HOST}" << 'ENDSSH'
 set -e
 mkdir -p /opt/jiu/marketing
 rsync -a --delete /tmp/jiu-marketing-new/ /opt/jiu/marketing/
@@ -106,12 +106,21 @@ for a in rel.get('assets', []):
 PYEOF
 }

-# setup_ssh — write the EC2 deploy key and export SSH / SCP commands.
+# setup_ssh — write the deploy key and export SSH / SCP commands.
+# Target is the EC2 host by default; set DEPLOY_HOST / DEPLOY_USER / DEPLOY_SSH_KEY
+# to retarget another host (e.g. the Alibaba Cloud box during the EC2→Ali migration).
+# Backward-compatible: with no DEPLOY_* set, behaves exactly as before (EC2).
 setup_ssh() {
+  local host="${DEPLOY_HOST:-$EC2_HOST}"
+  local key="${DEPLOY_SSH_KEY:-$EC2_SSH_KEY}"
  mkdir -p ~/.ssh
-  printf '%s' "${EC2_SSH_KEY}" > ~/.ssh/ec2_deploy.pem
+  # `printf '%s\n'` 末尾补一个换行：Forgejo 存 secret 会去掉结尾换行，而
+  # OpenSSH 格式私钥（-----BEGIN OPENSSH PRIVATE KEY-----，如阿里 ed25519 部署 key）
+  # 缺结尾换行会被判为 "invalid format" 而拒绝加载，退化成无密钥 → Permission denied。
+  # 多补的换行对已含结尾换行的 PEM（如 EC2 key）无害。
+  printf '%s\n' "${key}" > ~/.ssh/ec2_deploy.pem
  chmod 600 ~/.ssh/ec2_deploy.pem
-  ssh-keyscan -H "${EC2_HOST}" >> ~/.ssh/known_hosts 2>/dev/null
+  ssh-keyscan -H "${host}" >> ~/.ssh/known_hosts 2>/dev/null
  SSH="ssh -i ~/.ssh/ec2_deploy.pem -o StrictHostKeyChecking=no"
  SCP="scp -O -i ~/.ssh/ec2_deploy.pem"
 }
Author	SHA1	Message	Date
wangjia	68fce1970c	chore: release client-v1.0.83 Deploy Client / build-client-web (push) Successful in 46s Details Deploy Client / build-windows (push) Successful in 1m54s Details Deploy Client / build-macos (push) Successful in 2m22s Details Deploy Client / build-android (push) Successful in 1m28s Details Deploy Client / build-ios (push) Successful in 3m19s Details Deploy Client / release-deploy-client (push) Successful in 1m53s Details	2026-06-26 18:11:40 +08:00
wangjia	2ad893fb40	docs: 出入库单打印排版方案（6 种黑白样式 HTML + PDF）参考真实发票/送货单产出 6 种黑白排版供选型，已登记 docs 索引。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-26 18:10:19 +08:00
wangjia	1558ce1e94	refactor(client): 出入库单打印改用「紧凑报表」版式 - 左侧竖线点缀 + 抬头左对齐内联（公司名 + 单据类型同行） - 抬头信息改为灰底信息条；明细表收紧字号/行距、灰底表头 - 数量/单价/金额/总计改等宽数字（PDF 内置 Courier，Web monospace） - 单据总计改为右对齐灰底条 - 仅排版调整，字段/数据/售价口径/温馨提示逻辑均不变 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-26 18:10:12 +08:00
wangjia	a355a3a2a2	feat(client): 出入库单打印按新版式重做 + 单价口径修正 - 版式参照单据样板：公司抬头 + 两行三列表头 + 统一明细列（商品编号/名称/系列/规格/批次号/生产日期/数量/单价/金额/备注） - 单据总计独立成行（仅数量+金额，右对齐高亮） - 出库单保留温馨提示，入库单去掉 - 签字行：制单人=当前登录用户(OrderPrintMeta)，采购员/销售员=经办人；公司名取门店(shopInfoProvider) - 出库单单价=售价(sale_price)，金额=售价×数量；历史单 sale_price=0 时回退 unit_price/total_price。入库单单价=进价(unit_price) - 桌面 PDF 与 Web HTML 两端同构 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-26 17:03:23 +08:00
wangjia	5187702fc5	chore: release client-v1.0.82 Deploy Client / build-client-web (push) Successful in 47s Details Deploy Client / build-windows (push) Successful in 1m56s Details Deploy Client / build-macos (push) Successful in 2m15s Details Deploy Client / build-android (push) Successful in 1m20s Details Deploy Client / build-ios (push) Successful in 2m47s Details Deploy Client / release-deploy-client (push) Successful in 1m51s Details Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-26 01:52:04 +08:00
wangjia	3d83f94f24	chore: release client-v1.0.81 Deploy Client / build-client-web (push) Successful in 42s Details Deploy Client / build-windows (push) Successful in 1m55s Details Deploy Client / build-macos (push) Successful in 2m19s Details Deploy Client / build-android (push) Successful in 1m7s Details Deploy Client / build-ios (push) Successful in 2m37s Details Deploy Client / release-deploy-client (push) Successful in 1m53s Details Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-24 18:40:23 +08:00
wangjia	5861b9210c	chore: release client-v1.0.80 Deploy Client / build-client-web (push) Successful in 43s Details Deploy Client / build-windows (push) Successful in 1m56s Details Deploy Client / build-macos (push) Successful in 2m11s Details Deploy Client / build-android (push) Successful in 1m29s Details Deploy Client / build-ios (push) Successful in 2m47s Details Deploy Client / release-deploy-client (push) Successful in 1m49s Details Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-24 18:02:32 +08:00
wangjia	a678c3806e	chore: release client-v1.0.79 Deploy Client / build-client-web (push) Successful in 44s Details Deploy Client / build-macos (push) Successful in 2m29s Details Deploy Client / build-android (push) Successful in 1m23s Details Deploy Client / build-ios (push) Successful in 2m59s Details Deploy Client / build-windows (push) Successful in 1m52s Details Deploy Client / release-deploy-client (push) Successful in 2m40s Details 入库/出库单搜索框升级：搜索后关键词转为框内 chip 标签 + 一键清除（✕），仅保留单个搜索词；新增 SearchChip 组件 + provider currentKeyword getter 进屏同步。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YZ4DskSRKsSiheQonFtQvx	2026-06-24 12:08:55 +08:00
wangjia	5ff41cc505	chore: release server-v1.0.81 Deploy Server / release-deploy-server (push) Successful in 1m54s Details 修复入库单/出库单按商品名搜不到历史导入单：搜索酒名条件由 COALESCE(被占位名劫持) 改为 p.name OR it.product_name 任一命中，并加回归测试。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YZ4DskSRKsSiheQonFtQvx	2026-06-24 11:56:21 +08:00
wangjia	33b0f6c30c	chore: release client-v1.0.78 Deploy Client / build-windows (push) Successful in 1m52s Details Deploy Client / build-client-web (push) Successful in 41s Details Deploy Client / build-macos (push) Successful in 2m36s Details Deploy Client / build-android (push) Successful in 1m16s Details Deploy Client / build-ios (push) Successful in 3m0s Details Deploy Client / release-deploy-client (push) Successful in 3m11s Details Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YZ4DskSRKsSiheQonFtQvx	2026-06-24 01:26:39 +08:00
wangjia	6f25972277	chore: release server-v1.0.80 Deploy Server / release-deploy-server (push) Successful in 1m57s Details Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YZ4DskSRKsSiheQonFtQvx	2026-06-24 01:25:51 +08:00
wangjia	a06c1c0709	fix(deploy): setup_ssh 给私钥补结尾换行，修复阿里 ed25519 部署 key "invalid format" Forgejo 存 secret 时会去掉结尾换行，而 OpenSSH 格式私钥（如阿里 ed25519 部署 key）缺结尾换行会被 openssh 判为 "invalid format" 拒绝加载，退化成无密钥 → Permission denied，导致迁移期 Deploy → Ali 影子轨每次都失败（因 continue-on-error 不阻塞 EC2、流水线仍显示成功，故未被察觉）。 EC2 那把是 RSA/PEM 对结尾换行宽容，未暴露此问题。改 printf '%s' → printf '%s\n' 始终补一个结尾换行；对已含换行的 PEM 无害。已本机端到端复现并验证：去掉结尾换行的 key 经修复后 deploy-server.sh 阿里分支跑通，阿里二进制已与 EC2 一致（sha 7e77ec46）、jiu.service 保持 stopped。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YZ4DskSRKsSiheQonFtQvx	2026-06-24 01:23:13 +08:00
wangjia	052a541084	chore: release client-v1.0.77 Deploy Client / build-client-web (push) Successful in 42s Details Deploy Client / build-windows (push) Successful in 1m57s Details Deploy Client / build-macos (push) Successful in 2m51s Details Deploy Client / build-android (push) Successful in 1m32s Details Deploy Client / build-ios (push) Successful in 3m42s Details Deploy Client / release-deploy-client (push) Successful in 3m10s Details Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YZ4DskSRKsSiheQonFtQvx	2026-06-24 00:33:22 +08:00
wangjia	b260939563	chore: release server-v1.0.79 Deploy Server / release-deploy-server (push) Successful in 1m46s Details Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YZ4DskSRKsSiheQonFtQvx	2026-06-24 00:32:24 +08:00
wangjia	84f99ef459	test: 补酒名搜索拼音/多租户与前端搜索限流用例 - backend: 入库酒名全拼(feitian)+首字母(ftmt)命中、不相关拼音不命中 - backend: 入库酒名反查的多租户隔离（店A搜茅台不串到店B） - client: setKeyword 防抖(350ms内连发取最后一次)+去重(同词不重查) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-24 00:19:34 +08:00
wangjia	102ace42ac	feat(client): 入库/出库搜索框支持酒名，并对搜索限流 - 搜索框 hint 改为「单号/往来单位/酒名」 - setKeyword 加去重+350ms 防抖：同词不重查、连发回车/狂点合并取最后一次，避免酒名模糊查询（单次约 55ms 明细扫描）被刷 - Timer 在 provider dispose 时取消 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-24 00:19:34 +08:00
wangjia	e8f416ddea	feat(backend): 入库/出库列表 keyword 支持酒名模糊反查 - keyword 在单号/往来单位基础上，新增按酒名反查含该酒明细的单据 - 酒名匹配复用拼音基建：name(优先 product 回退快照) + name_pinyin + name_initials - 子查询带 shop_id，多租户隔离不破 - 补 stock_in/stock_out List 按酒名+拼音命中的测试用例 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-24 00:19:34 +08:00
wangjia	08b41a8f63	feat(client): 入库单价允许留空/0（待定价），移除 >0 校验 - 删除新建入库商品明细单价的「不能为空 + >0」校验，留空或填 0 视为「待定价」 - 待定价明细经审核后在入库单详情「确认进价」补填真实进价 - 清理未使用的 productCode 局部变量与 _productCodeOf 辅助方法 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-24 00:19:34 +08:00
wangjia	2eb4275e6f	chore(deploy): CI 双轨——发版同时部署 EC2 + 阿里（EC2→Ali 迁移期） deploy-{server,site,client}.sh 目标主机参数化（DEPLOY_HOST/USER/SSH_KEY），不传时行为与现状完全一致（只发 EC2）。workflow 的 Deploy 拆成 EC2（前）+ Ali（后，if:always + continue-on-error，影子目标失败不挡线上）。deploy-server 的 ali 分支只换二进制 + reload 独立 nginx（listen 443），不启动 jiu（阿里 DB 为只读从库，切流提升为主后才起）。新增 deploy/nginx-jiu-ali.conf 并打进 configs.tar.gz。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YZ4DskSRKsSiheQonFtQvx	2026-06-23 22:57:41 +08:00
wangjia	9139192097	chore: release server-v1.0.78 Deploy Server / release-deploy-server (push) Successful in 6m36s Details Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-23 20:12:34 +08:00
wangjia	ff4a2db7cc	chore: release client-v1.0.76 Deploy Client / build-client-web (push) Successful in 42s Details Deploy Client / build-macos (push) Successful in 2m33s Details Deploy Client / build-android (push) Successful in 1m37s Details Deploy Client / build-ios (push) Successful in 2m51s Details Deploy Client / build-windows (push) Successful in 2m22s Details Deploy Client / release-deploy-client (push) Successful in 2m58s Details Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-23 20:12:12 +08:00
wangjia	21aa2523b7	docs: 暂估价→确认进价设计方案（HTML） Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-23 20:07:50 +08:00
wangjia	f395920a8c	feat(client): 入库确认进价入口与「待定价」标注入库单详情弹窗为已审核+含 0 价明细+管理员时显示「确认进价」，逐行补填真实进价调后端；库存列表与入库明细 0 价/NULL 显示「待定价」而非 ¥0.00。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-23 20:07:50 +08:00
wangjia	3625240839	feat(backend): 入库「确认进价」前向补偿（暂估价→真实价）调货 0 价入库并已审核/出库后，价格确定时补填真实进价：一事务内回填入库明细/库存批次/已出库成本快照，重算入库单总额，按差额补应付流水，同步参考进价。按 product_id 精确命中（序列号 1:1），不动售价/应收。仅 approved 单、管理员/超管，差额幂等可重复确认。新增 POST /stock-in/orders/:id/confirm-cost 及 4 个测试用例。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-23 20:07:49 +08:00
wangjia	7969bb41e3	feat(client): 商品详情页图片支持双击全屏查看抽出共享全屏查看器 fullscreen_image_viewer.dart（复用扫码页的 InteractiveViewer+PageView+黑底 modal），详情页缩略图双击打开，扫码公开页改为复用同一组件去重。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-23 20:07:49 +08:00