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/widgets/form_dialog.dart

@@ -1,3 +1,4 @@
+import '../core/utils/dialog_util.dart';
 import 'package:flutter/material.dart';
 import '../core/theme/app_theme.dart';
 

client/lib/widgets/multi_select_dropdown.dart

@@ -1,3 +1,4 @@
+import '../core/utils/dialog_util.dart';
 import 'package:flutter/material.dart';
 import '../core/theme/app_theme.dart';
 
@@ -50,7 +51,7 @@ class MultiSelectDropdown extends StatelessWidget {
   }
 
   void _show(BuildContext context) {
-    showDialog(
+    showAppDialog(
       context: context,
       barrierColor: Colors.black12,
       builder: (_) => _MultiSelectDialog(
@@ -213,7 +214,7 @@ class _FilterableColumnHeaderState extends State<FilterableColumnHeader> {
   }
 
   void _show(BuildContext context) {
-    showDialog(
+    showAppDialog(
       context: context,
       barrierColor: Colors.black12,
       builder: (_) => _MultiSelectDialog(
@@ -273,7 +274,7 @@ class ColumnToggleButton extends StatelessWidget {
   }
 
   void _show(BuildContext context) {
-    showDialog(
+    showAppDialog(
       context: context,
       barrierColor: Colors.black12,
       builder: (_) => _ColumnToggleDialog(

client/lib/widgets/page_scaffold.dart

@@ -1,11 +1,12 @@
 import 'package:flutter/material.dart';
 import '../core/theme/app_theme.dart';
 
-class PageScaffold extends StatelessWidget {
+class PageScaffold extends StatefulWidget {
   final String title;
   final List<Widget> tabs;
   final List<Widget> tabViews;
   final int initialTab;
+  final ValueChanged<int>? onTabChanged;
 
   const PageScaffold({
     super.key,
@@ -13,36 +14,68 @@ class PageScaffold extends StatelessWidget {
     required this.tabs,
     required this.tabViews,
     this.initialTab = 0,
+    this.onTabChanged,
   });
 
+  @override
+  State<PageScaffold> createState() => _PageScaffoldState();
+}
+
+class _PageScaffoldState extends State<PageScaffold>
+    with SingleTickerProviderStateMixin {
+  late TabController _controller;
+
+  @override
+  void initState() {
+    super.initState();
+    _controller = TabController(
+      length: widget.tabs.length,
+      initialIndex: widget.initialTab.clamp(0, widget.tabs.length - 1),
+      vsync: this,
+    );
+    if (widget.onTabChanged != null) {
+      _controller.addListener(() {
+        if (!_controller.indexIsChanging) {
+          widget.onTabChanged!(_controller.index);
+        }
+      });
+    }
+  }
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    super.dispose();
+  }
+
   @override
   Widget build(BuildContext context) {
-    return DefaultTabController(
-      length: tabs.length,
-      initialIndex: initialTab,
-      child: Column(
-        crossAxisAlignment: CrossAxisAlignment.start,
-        children: [
-          Container(
-            color: AppTheme.surface,
-            child: TabBar(
-              isScrollable: true,
-              tabAlignment: TabAlignment.start,
-              labelColor: AppTheme.primary,
-              unselectedLabelColor: AppTheme.textSecondary,
-              indicatorColor: AppTheme.primary,
-              indicatorWeight: 2,
-              labelStyle:
-                  const TextStyle(fontSize: 14, fontWeight: FontWeight.w500),
-              tabs: tabs,
-            ),
+    return Column(
+      crossAxisAlignment: CrossAxisAlignment.start,
+      children: [
+        Container(
+          color: AppTheme.surface,
+          child: TabBar(
+            controller: _controller,
+            isScrollable: true,
+            tabAlignment: TabAlignment.start,
+            labelColor: AppTheme.primary,
+            unselectedLabelColor: AppTheme.textSecondary,
+            indicatorColor: AppTheme.primary,
+            indicatorWeight: 2,
+            labelStyle:
+                const TextStyle(fontSize: 14, fontWeight: FontWeight.w500),
+            tabs: widget.tabs,
           ),
-          const Divider(height: 1),
-          Expanded(
-            child: TabBarView(children: tabViews),
+        ),
+        const Divider(height: 1),
+        Expanded(
+          child: TabBarView(
+            controller: _controller,
+            children: widget.tabViews,
           ),
-        ],
-      ),
+        ),
+      ],
     );
   }
 }

client/lib/widgets/searchable_option_field.dart

@@ -1,3 +1,4 @@
+import '../core/utils/dialog_util.dart';
 import 'package:flutter/material.dart';
 import 'package:lpinyin/lpinyin.dart';
 import '../core/theme/app_theme.dart';