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>

client/lib/repositories/finance_repository.dart

@@ -33,4 +33,38 @@ class FinanceRepository {
       );
     }
   }
+
+  Future<void> create(Map<String, dynamic> body) async {
+    try {
+      await _client.post('/finance/records', data: body);
+    } on DioException catch (e) {
+      throw AppException(
+        e.response?.data?['error'] as String? ?? '创建记录失败',
+        statusCode: e.response?.statusCode,
+      );
+    }
+  }
+
+  Future<void> close(int id) async {
+    try {
+      await _client.put('/finance/records/$id/close');
+    } on DioException catch (e) {
+      throw AppException(
+        e.response?.data?['error'] as String? ?? '操作失败',
+        statusCode: e.response?.statusCode,
+      );
+    }
+  }
+
+  Future<void> closeByRef(String refType, int refId) async {
+    try {
+      await _client.put(
+          '/finance/records/close-by-ref?ref_type=$refType&ref_id=$refId');
+    } on DioException catch (e) {
+      throw AppException(
+        e.response?.data?['error'] as String? ?? '结清失败',
+        statusCode: e.response?.statusCode,
+      );
+    }
+  }
 }

client/lib/repositories/inventory_repository.dart

@@ -47,27 +47,12 @@ class InventoryRepository {
     }
   }
 
-  Future<PageResult<ProductTrackingRecord>> listProducts({
-    int? productId,
-    int? warehouseId,
-    int page = 1,
-    int pageSize = 20,
-  }) async {
+  Future<void> updateRemark(int id, String remark) async {
     try {
-      final params = <String, dynamic>{
-        'page': page,
-        'page_size': pageSize,
-        if (productId != null) 'product_id': productId,
-        if (warehouseId != null) 'warehouse_id': warehouseId,
-      };
-      final resp = await _client.get('/inventory/products', params: params);
-      return PageResult.fromJson(
-        resp.data as Map<String, dynamic>,
-        ProductTrackingRecord.fromJson,
-      );
+      await _client.put('/inventory/$id/remark', data: {'remark': remark});
     } on DioException catch (e) {
       throw AppException(
-        e.response?.data?['error'] as String? ?? '获取商品追踪数据失败',
+        e.response?.data?['error'] as String? ?? '更新备注失败',
         statusCode: e.response?.statusCode,
       );
     }

client/lib/repositories/product_option_repository.dart

@@ -30,6 +30,15 @@ class ProductOptionRepository {
     }
   }
 
+  Future<void> updateName(int id, Map<String, dynamic> data) async {
+    try {
+      await _client.put('/product-options/names/$id', data: data);
+    } on DioException catch (e) {
+      throw AppException(e.response?.data?['error'] as String? ?? '更新失败',
+          statusCode: e.response?.statusCode);
+    }
+  }
+
   Future<void> deleteName(int id) async {
     try {
       await _client.delete('/product-options/names/$id');
@@ -61,6 +70,15 @@ class ProductOptionRepository {
     }
   }
 
+  Future<void> updateSeries(int id, Map<String, dynamic> data) async {
+    try {
+      await _client.put('/product-options/series/$id', data: data);
+    } on DioException catch (e) {
+      throw AppException(e.response?.data?['error'] as String? ?? '更新失败',
+          statusCode: e.response?.statusCode);
+    }
+  }
+
   Future<void> deleteSeries(int id) async {
     try {
       await _client.delete('/product-options/series/$id');
@@ -92,6 +110,15 @@ class ProductOptionRepository {
     }
   }
 
+  Future<void> updateSpec(int id, Map<String, dynamic> data) async {
+    try {
+      await _client.put('/product-options/specs/$id', data: data);
+    } on DioException catch (e) {
+      throw AppException(e.response?.data?['error'] as String? ?? '更新失败',
+          statusCode: e.response?.statusCode);
+    }
+  }
+
   Future<void> deleteSpec(int id) async {
     try {
       await _client.delete('/product-options/specs/$id');

client/lib/repositories/shop_repository.dart

@@ -0,0 +1,33 @@
+import 'package:dio/dio.dart';
+import '../core/api/api_client.dart';
+import '../core/exceptions.dart';
+import '../models/shop.dart';
+
+class ShopRepository {
+  final ApiClient _client;
+  const ShopRepository(this._client);
+
+  Future<ShopInfo> getInfo() async {
+    try {
+      final resp = await _client.get('/shop/info');
+      return ShopInfo.fromJson(resp.data as Map<String, dynamic>);
+    } on DioException catch (e) {
+      throw AppException(
+        e.response?.data?['error'] as String? ?? '获取酒行信息失败',
+        statusCode: e.response?.statusCode,
+      );
+    }
+  }
+
+  Future<ShopInfo> updateInfo(Map<String, dynamic> body) async {
+    try {
+      final resp = await _client.put('/shop/info', data: body);
+      return ShopInfo.fromJson(resp.data as Map<String, dynamic>);
+    } on DioException catch (e) {
+      throw AppException(
+        e.response?.data?['error'] as String? ?? '更新失败',
+        statusCode: e.response?.statusCode,
+      );
+    }
+  }
+}