feat(client): 移动壳基建——底部 5 tab + 我的 hub + 统一底部 sheet + 移动组件四件套

对齐移动原型体系(m-*.html)的 Stage 0 共享基建,桌面形态零改动:

- 导航:router 新增 branch 9(/me 我的 + /me/license 授权屏);窄屏 tab 根
  (库存/入库/出库/财务/我的)出底部 MTabBar,二级屏隐藏 tabbar + 顶栏返回箭头
  (PopScope 拦系统返回键防退 app);窄屏 Drawer/汉堡删除;窄屏顶栏对齐 m-top
  (标题 + 主题/通知铃/头像→我的)
- sheet:showMSheet(grip/标题/86vh/键盘避让)+ showAdaptiveSheet;六个共享
  弹层呈现函数加窄屏 sheet 分支(订单/往来/财务往来/商品编辑抽屉 + 退单/登记收支
  dialog 的 asSheet 形态)
- 徽章:DsBadge/StatusPill/StatusBadge 加图标变体(默认圆点零漂移)+
  status_icon_map 转录原型 BADGE_ICON 28 词
- 组件:MKpiGrid(2×2 可点 KPI)/ MSearchRow(搜索+状态钮+详搜钮)/
  MHubGroup(hub 入口组)/ showThemeSheet(主题外观 sheet)
- 授权:_LicensePanel/_SettingsCard 抽取为公共 LicensePanel/SettingsCard,
  窄屏授权跳转 /me/license
- golden:app_shell_mobile + me 各三主题(390×844@2x);全量 259 测试绿,
  check_ds_code / check-l1-sync 闸过

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
wangjia
2026-07-04 11:56:04 +08:00
parent b683adece9
commit be9afcf68d
34 changed files with 1851 additions and 390 deletions
@@ -78,7 +78,8 @@ GoRouter _router() => GoRouter(
initialLocation: '/inventory',
routes: [
StatefulShellRoute.indexedStack(
builder: (ctx, state, shell) => AppShell(navigationShell: shell),
builder: (ctx, state, shell) =>
AppShell(navigationShell: shell, location: state.matchedLocation),
branches: [
_branch('/stock-in'),
_branch('/stock-out'),
@@ -0,0 +1,126 @@
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:go_router/go_router.dart';
import 'package:shared_preferences/shared_preferences.dart';
import 'package:jiu_client/core/auth/auth_state.dart';
import 'package:jiu_client/core/theme/themes.dart';
import 'package:jiu_client/models/shop.dart';
import 'package:jiu_client/providers/shop_provider.dart';
import 'package:jiu_client/providers/license_provider.dart';
import 'package:jiu_client/providers/update_provider.dart';
import 'package:jiu_client/providers/connectivity_provider.dart';
import 'package:jiu_client/providers/session_heartbeat.dart';
import 'package:jiu_client/screens/shell/app_shell.dart';
import 'package:jiu_client/widgets/app_status_bar.dart';
import '../support/golden_harness.dart';
/// 移动壳 golden × 三主题(390×844 @2x):窄屏顶栏(标题 + 主题/铃/头像)
/// + 底部 5 tab(库存/入库/出库/财务/我的,库存激活)——对齐原型移动壳
/// mobile-shell.jsm-top + m-tabbar)。二级屏返回箭头形态另see me golden。
/// 更新基准:flutter test --update-goldens test/golden/app_shell_mobile_golden_test.dart
class _FakeAuth extends AuthNotifier {
_FakeAuth() {
state = const AuthState(
user: AuthUser(
accessToken: 't',
refreshToken: 'r',
id: 1,
username: 'wang',
realName: '王经理',
shopNo: 'DSJH-001',
shopId: 1,
role: 'admin'),
);
}
}
class _FakeUpdate extends UpdateNotifier {
@override
Future<AppUpdateInfo?> build() async => null;
}
class _FakeLicense extends LicenseNotifier {
@override
Future<LicenseInfo?> build() async => null;
}
const _shop = ShopInfo(
id: 1,
code: 'DSJH-001',
name: '鼎晟酒行',
address: '浙江省杭州市',
phone: '0571-88886666',
managerName: '王经理');
List<Override> _overrides() => [
authStateProvider.overrideWith((ref) => _FakeAuth()),
shopInfoProvider.overrideWith((ref) => _shop),
licenseProvider.overrideWith(() => _FakeLicense()),
updateProvider.overrideWith(() => _FakeUpdate()),
connectivityProvider
.overrideWith((ref) => ConnectivityNotifier(skipInit: true)),
sessionHeartbeatProvider.overrideWith((ref) => SessionHeartbeat(ref)),
appVersionProvider.overrideWith((ref) => 'v1.0.72'),
isReadonlyProvider.overrideWithValue(false),
];
StatefulShellBranch _branch(String path) => StatefulShellBranch(routes: [
GoRoute(path: path, builder: (_, __) => const SizedBox.expand()),
]);
GoRouter _router() => GoRouter(
initialLocation: '/inventory',
routes: [
StatefulShellRoute.indexedStack(
builder: (ctx, state, shell) =>
AppShell(navigationShell: shell, location: state.matchedLocation),
branches: [
_branch('/stock-in'),
_branch('/stock-out'),
_branch('/inventory'),
_branch('/finance'),
_branch('/partners'),
_branch('/products'),
_branch('/devices'),
_branch('/settings'),
_branch('/about'),
_branch('/me'),
],
),
],
);
void main() {
TestWidgetsFlutterBinding.ensureInitialized();
SharedPreferences.setMockInitialValues({});
AppStatusBar.clock = () => DateTime(2026, 7, 13, 9, 30, 15);
AppStatusBar.ticking = false;
for (final theme in const ['a', 'b', 'c']) {
testWidgets('app shell mobile · theme $theme', (tester) async {
await ensureGoldenFonts();
tester.view.physicalSize = const Size(780, 1688); // 390×844 @2x
tester.view.devicePixelRatio = 2.0;
addTearDown(tester.view.resetPhysicalSize);
addTearDown(tester.view.resetDevicePixelRatio);
await tester.pumpWidget(ProviderScope(
overrides: _overrides(),
child: MaterialApp.router(
debugShowCheckedModeBanner: false,
theme: withGoldenFont(buildTheme(theme)),
routerConfig: _router(),
),
));
await tester.pumpAndSettle();
await expectLater(
find.byType(MaterialApp),
matchesGoldenFile('goldens/app_shell_mobile_$theme.png'),
);
});
}
}
Binary file not shown.

After

Width:  |  Height:  |  Size: 26 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 26 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 72 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 73 KiB

+51
View File
@@ -0,0 +1,51 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter/material.dart';
import 'package:jiu_client/core/auth/auth_state.dart';
import 'package:jiu_client/models/shop.dart';
import 'package:jiu_client/providers/shop_provider.dart';
import 'package:jiu_client/screens/me/me_screen.dart';
import '../support/golden_harness.dart';
/// 「我的」hub golden × 三主题(390×844 @2x):用户头卡(渐变头像 + 角色徽章)
/// + 经营管理组 3 项 + 系统组 6 项 + 退出登录——对齐原型 m-me.html。
/// 更新基准:flutter test --update-goldens test/golden/me_golden_test.dart
class _FakeAuth extends AuthNotifier {
_FakeAuth() {
state = const AuthState(
user: AuthUser(
accessToken: 't',
refreshToken: 'r',
id: 1,
username: '13800138000',
realName: '王经理',
shopNo: 'DSJH-001',
shopId: 1,
role: 'admin'),
);
}
}
const _shop = ShopInfo(
id: 1,
code: 'DSJH-001',
name: '鼎晟酒行',
address: '浙江省杭州市',
phone: '0571-88886666',
managerName: '王经理');
void main() {
TestWidgetsFlutterBinding.ensureInitialized();
goldenAcrossThemes(
'me screen',
child: () => const MeScreen(),
goldenPrefix: 'me',
logical: const Size(390, 844),
overrides: () => [
authStateProvider.overrideWith((ref) => _FakeAuth()),
shopInfoProvider.overrideWith((ref) => _shop),
],
);
}
+2 -1
View File
@@ -79,7 +79,8 @@ GoRouter _router(String initialPath, WidgetBuilder screen) => GoRouter(
initialLocation: initialPath,
routes: [
StatefulShellRoute.indexedStack(
builder: (ctx, state, shell) => AppShell(navigationShell: shell),
builder: (ctx, state, shell) =>
AppShell(navigationShell: shell, location: state.matchedLocation),
branches: [
for (final p in const [
'/stock-in',
+2 -1
View File
@@ -55,7 +55,8 @@ GoRouter _router() => GoRouter(
initialLocation: '/inventory',
routes: [
StatefulShellRoute.indexedStack(
builder: (ctx, state, shell) => AppShell(navigationShell: shell),
builder: (ctx, state, shell) =>
AppShell(navigationShell: shell, location: state.matchedLocation),
branches: [
for (final p in const [
'/stock-in',