feat: 财务结清、酒行信息、库存备注编辑、标签溯源、入库必填校验

后端
- 新增 shop handler：GET/PUT /shop/info（管理员权限）
- 新增 finance CloseByRef：按单据 ref_type+ref_id 结清账款
- 新增 inventory UpdateRemark：PUT /inventory/:id/remark
- 入库/出库审批自动生成财务应付/应收记录（去除金额>0限制）
- 种子数据 S001-S003 补充真实门店信息

前端
- 设置页新增「酒行信息」Tab，管理员可编辑门店名称/地址/电话/负责人
- 入库单列表新增结清按钮（含确认弹窗），出库单同步
- 入库表单：规格、系列、生产日期、供应商、商品名称改为提交必填
- 入库/出库列表新增入库时间、出库时间、创建时间列
- 商品标签标题改为读取 shop 表门店名，扫码文案改为「扫码溯源 · TRACE」
- 标签页脚显示门店地址和电话（从 API 读取，不再依赖编译时 dart-define）
- 库存备注支持点击编辑，超4字截断显示+Hover展示全文
- ApiClient 新增 patch() 方法（已改用 PUT 规避 CORS）

文档
- 新增 docs/user-manual.md 完整用户操作手册（12章）

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

backend/internal/handler/stock_out.go

@@ -65,25 +65,46 @@ func (h *StockOutHandler) Get(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{"data": order})
 }
 
-// checkInventory validates that warehouse has enough stock for each item.
+// checkInventory validates that warehouse has enough stock for each item (SUM aggregate).
 // warehouseID is the order's warehouse; items are the stock-out line items.
 func (h *StockOutHandler) checkInventory(shopID, warehouseID uint64, items []model.StockOutItem) error {
+	if len(items) == 0 {
+		return nil
+	}
+
+	// Collect product IDs
+	productIDs := make([]uint64, 0, len(items))
 	for _, item := range items {
-		var inv model.Inventory
-		err := h.db.Where("shop_id = ? AND warehouse_id = ? AND product_id = ?",
-			shopID, warehouseID, item.ProductID).First(&inv).Error
-		if err != nil || inv.Quantity < item.Quantity {
-			// Try to get product name for a clearer error message
+		productIDs = append(productIDs, item.ProductID)
+	}
+
+	type inventorySum struct {
+		ProductID uint64
+		Total     float64
+	}
+	var sums []inventorySum
+	h.db.Model(&model.Inventory{}).
+		Select("product_id, COALESCE(SUM(quantity), 0) AS total").
+		Where("shop_id = ? AND warehouse_id = ? AND product_id IN ? AND deleted_at IS NULL",
+			shopID, warehouseID, productIDs).
+		Group("product_id").Scan(&sums)
+
+	// Build map for quick lookup
+	sumMap := make(map[uint64]float64, len(sums))
+	for _, s := range sums {
+		sumMap[s.ProductID] = s.Total
+	}
+
+	for _, item := range items {
+		have := sumMap[item.ProductID]
+		if have < item.Quantity {
+			// Get product name for a clearer error message
 			var p model.Product
 			h.db.Where("id = ?", item.ProductID).First(&p)
 			name := p.Name
 			if name == "" {
 				name = fmt.Sprintf("商品ID %d", item.ProductID)
 			}
-			have := 0.0
-			if err == nil {
-				have = inv.Quantity
-			}
 			return fmt.Errorf("库存不足：%s 当前库存 %.0f，需要 %.0f", name, have, item.Quantity)
 		}
 	}