feat(client): 设置/用户/设备/关于窄屏对齐移动原型(hub 形态/卡片流/sheet/无打印)

- 系统设置窄屏改 hub 三组(门店/偏好/数据):门店信息/编号规则/默认仓库走
  底部 sheet,主题外观接 showThemeSheet,?tab= 深链窄屏忽略;桌面 subnav 不动
- 用户管理窄屏:m-section + 头像卡片流 + 角色图标徽章 + FAB 新增;
  点卡开详情 sheet(drow + 重置密码/启停/编辑),表单复用为 sheet 形态
- 设备管理窄屏:会话卡流(本机标注/在线图标徽章)+ 外设卡流(mc-foot 脚注),
  「+ 添加设备」在区块标题行右侧(m-pill 选择 sheet),打印模板窄屏不渲染
- 关于我们窄屏:品牌 hero + hub 链接组 + 产品信息 drow 卡 + 时间线 pill 标签
  + 意见反馈 sheet(类型 pill/描述/联系方式);授权信息不显示(已迁 /me/license)
- golden:四屏窄屏基准独立成 *_mobile_golden_test.dart(390×844 @2x 三主题),
  桌面 golden 零漂移

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
wangjia
2026-07-04 12:19:15 +08:00
parent dde87a32b6
commit 9445042cb4
24 changed files with 1975 additions and 311 deletions
+1 -10
View File
@@ -8,13 +8,13 @@ import 'package:jiu_client/providers/changelog_provider.dart';
import 'package:jiu_client/providers/license_provider.dart';
import 'package:jiu_client/screens/about/about_screen.dart';
import '../support/golden_harness.dart';
import '../support/shell_harness.dart';
/// design-distill 阶段4:关于我们 golden × 三主题(回归闸 + 保真基准)。
/// Hero/产品信息/授权信息/更新日志 数据照抄原型 screens/about.html
/// (授权 2027-03-15 · CHANGELOG 4 条,默认 2 条展示):
/// node tools/fidelity.mjs about
/// 窄屏 hero+hub 形态另见 about_mobile_golden_test.dart。
/// 更新基准:flutter test --update-goldens test/golden/about_golden_test.dart
class _FakeLicense extends LicenseNotifier {
@@ -104,13 +104,4 @@ void main() {
overrides: _overrides,
logical: const Size(1280, 900),
);
// 移动:窄屏单列
goldenAcrossThemes(
'about 整屏(移动)',
goldenPrefix: 'about_mobile',
child: () => const Scaffold(body: AboutScreen()),
overrides: _overrides,
logical: const Size(390, 1600),
);
}
@@ -0,0 +1,75 @@
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:package_info_plus/package_info_plus.dart';
import 'package:shared_preferences/shared_preferences.dart';
import 'package:jiu_client/core/utils/clock.dart';
import 'package:jiu_client/providers/changelog_provider.dart';
import 'package:jiu_client/screens/about/about_screen.dart';
import '../support/golden_harness.dart';
/// 关于我们窄屏 golden × 三主题(390×844 @2x):品牌 hero(图标+名+版本+
/// 检查更新+反馈双按钮)+ hub 链接组 + 产品信息卡 + 更新日志时间线 + 页脚,
/// 授权信息不显示(已迁 /me/license)——对齐原型 m-about.html。
/// 更新基准:flutter test --update-goldens test/golden/about_mobile_golden_test.dart
const _changelog = [
ChangelogEntry(version: '1.0.72', date: '2026-06-22', sections: [
(
type: 'feat',
items: [
'用户管理新增四级角色:超级管理员 / 管理员 / 操作员 / 只读',
'商品公开页编辑器:图片、品鉴笔记、适饮建议可视化编辑并实时预览',
]
),
(
type: 'impr',
items: [
'顶栏 / 侧栏 / 状态栏统一为单一来源,全局一处生效',
'金额卡片改用「万」单位展示,更符合阅读习惯',
]
),
]),
ChangelogEntry(version: '1.0.66', date: '2026-06-18', sections: [
(
type: 'feat',
items: [
'入库 / 出库列表新增搜索框,支持单号、商品、往来单位关键字检索',
'入库 / 出库 / 库存页新增一键刷新',
]
),
(
type: 'fix',
items: [
'入库审核库存沿用明细真实快照名',
'库存列表过滤软删商品,修复历史导入占位顶替',
]
),
]),
];
List<Override> _overrides() => [
changelogProvider.overrideWith((ref) async => _changelog),
];
void main() {
TestWidgetsFlutterBinding.ensureInitialized();
SharedPreferences.setMockInitialValues({});
PackageInfo.setMockInitialValues(
appName: 'jiu',
packageName: 'com.yanmei.jiu',
version: '1.0.72',
buildNumber: '72',
buildSignature: '',
);
appClock = () => DateTime(2026, 7, 13, 9, 30, 15);
goldenAcrossThemes(
'about 整屏(移动)',
goldenPrefix: 'about_mobile',
child: () => const Scaffold(body: AboutScreen()),
overrides: _overrides,
logical: const Size(390, 844),
);
}
@@ -9,13 +9,13 @@ import 'package:jiu_client/providers/session_provider.dart';
import 'package:jiu_client/providers/shop_provider.dart';
import 'package:jiu_client/screens/devices/device_management_screen.dart';
import '../support/golden_harness.dart';
import '../support/shell_harness.dart';
/// design-distill 阶段4:设备管理 golden × 三主题(回归闸 + 保真基准)。
/// 桌面版挂进真 AppShell,数据照抄原型 screens/devices.html 的
/// SESSIONS4 行会话)与 DEVICES5 台外设 → 店级 custom_fields.peripherals):
/// node tools/fidelity.mjs devices
/// 窄屏卡片流另见 device_management_mobile_golden_test.dart。
/// 更新基准:flutter test --update-goldens test/golden/device_management_golden_test.dart
// 原型 SESSIONS 4 行(时间 MM-DD HH:mm
@@ -155,13 +155,4 @@ void main() {
overrides: _overrides,
logical: const Size(1280, 900),
);
// 移动:窄屏卡片流
goldenAcrossThemes(
'devices 整屏(移动)',
goldenPrefix: 'device_management_mobile',
child: () => const Scaffold(body: DeviceManagementScreen()),
overrides: _overrides,
logical: const Size(390, 1400),
);
}
@@ -0,0 +1,124 @@
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:shared_preferences/shared_preferences.dart';
import 'package:jiu_client/core/auth/auth_state.dart';
import 'package:jiu_client/models/session.dart';
import 'package:jiu_client/models/shop.dart';
import 'package:jiu_client/providers/session_provider.dart';
import 'package:jiu_client/providers/shop_provider.dart';
import 'package:jiu_client/screens/devices/device_management_screen.dart';
import '../support/golden_harness.dart';
/// 设备管理窄屏 golden × 三主题(390×844 @2x):m-section 两区块——
/// 登录设备会话卡流(用户·平台+本机 / 设备·IP / 在线徽章+时间 / ›)
/// + 外设卡流(名称 / 型号·类型·连接 / 状态徽章 / 最近活动脚注),
/// 「+ 添加设备」在区块标题行右侧,打印模板不渲染——对齐原型 m-devices.html。
/// 更新基准:flutter test --update-goldens test/golden/device_management_mobile_golden_test.dart
final _sessions = [
DeviceSession(
id: 1,
userId: 1,
username: '王经理',
realName: '王经理',
platform: 'macos',
platformClass: 'desktop',
deviceName: 'macos',
ip: '192.168.1.20',
createdAt: DateTime(2026, 6, 20, 11, 23),
lastSeenAt: DateTime(2026, 6, 22, 17, 40),
online: true,
isCurrent: true),
DeviceSession(
id: 2,
userId: 1,
username: '王经理',
realName: '王经理',
platform: 'windows',
platformClass: 'desktop',
deviceName: 'windows',
ip: '192.168.1.21',
createdAt: DateTime(2026, 6, 20, 10, 47),
lastSeenAt: DateTime(2026, 6, 22, 17, 40),
online: true,
isCurrent: false),
DeviceSession(
id: 3,
userId: 2,
username: '李采购',
realName: '李采购',
platform: 'windows',
platformClass: 'desktop',
deviceName: 'windows',
ip: '192.168.1.35',
createdAt: DateTime(2026, 6, 20, 9, 13),
lastSeenAt: DateTime(2026, 6, 22, 17, 11),
online: false,
isCurrent: false),
];
const _peripherals = [
{
'name': '前台标签打印机',
'kind': '标签打印机',
'status': '在线',
'model': 'Zebra GK888t',
'conn': 'USB',
'last': '2 分钟前'
},
{
'name': '收银台小票机',
'kind': '小票打印机',
'status': '在线',
'model': '佳博 GP-58MB',
'conn': '蓝牙',
'last': '刚刚'
},
{
'name': '入库扫码枪',
'kind': '扫码枪',
'status': '离线',
'model': 'Honeywell 1900',
'conn': 'USB',
'last': '5 分钟前'
},
];
const _shopWithPeripherals = ShopInfo(
id: 1,
code: 'DSJH-001',
name: '鼎晟酒行',
address: '浙江省杭州市拱墅区运河路 168 号 1 幢',
phone: '0571-8888 6666',
managerName: '王经理',
wechatId: 'dingsheng-wine',
customFields: {'peripherals': _peripherals},
);
class _FakeSessionNotifier extends SessionListNotifier {
@override
Future<List<DeviceSession>> build() async => _sessions;
@override
Future<void> reload() async {}
}
List<Override> _overrides() => [
sessionListProvider.overrideWith(() => _FakeSessionNotifier()),
shopInfoProvider.overrideWith((ref) => _shopWithPeripherals),
isReadonlyProvider.overrideWithValue(false),
];
void main() {
TestWidgetsFlutterBinding.ensureInitialized();
SharedPreferences.setMockInitialValues({});
goldenAcrossThemes(
'devices 卡片流 整屏(移动)',
goldenPrefix: 'device_management_mobile',
child: () => const Scaffold(body: DeviceManagementScreen()),
overrides: _overrides,
logical: const Size(390, 844),
);
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 378 KiB

After

Width:  |  Height:  |  Size: 122 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 379 KiB

After

Width:  |  Height:  |  Size: 120 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 408 KiB

After

Width:  |  Height:  |  Size: 123 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 180 KiB

After

Width:  |  Height:  |  Size: 136 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 183 KiB

After

Width:  |  Height:  |  Size: 133 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 182 KiB

After

Width:  |  Height:  |  Size: 136 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 89 KiB

After

Width:  |  Height:  |  Size: 57 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 88 KiB

After

Width:  |  Height:  |  Size: 57 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 89 KiB

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 116 KiB

After

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 117 KiB

After

Width:  |  Height:  |  Size: 65 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 118 KiB

After

Width:  |  Height:  |  Size: 68 KiB

+1 -10
View File
@@ -7,13 +7,13 @@ import 'package:jiu_client/models/shop.dart';
import 'package:jiu_client/providers/shop_provider.dart';
import 'package:jiu_client/screens/settings/settings_screen.dart';
import '../support/golden_harness.dart';
import '../support/shell_harness.dart';
/// design-distill 阶段4:系统设置 golden × 三主题(回归闸 + 保真基准)。
/// 桌面版挂进真 AppShell,默认「门店信息」面板,门店数据照抄原型
/// screens/settings.html(鼎晟酒行 / DSJH-001 / 拱墅区运河路…):
/// node tools/fidelity.mjs settings
/// 窄屏 hub 形态另见 settings_mobile_golden_test.dart。
/// 更新基准:flutter test --update-goldens test/golden/settings_golden_test.dart
const _shop = ShopInfo(
@@ -44,13 +44,4 @@ void main() {
overrides: _overrides,
logical: const Size(1280, 900),
);
// 移动:seg 横滚 + 单列面板
goldenAcrossThemes(
'settings 门店信息 整屏(移动)',
goldenPrefix: 'settings_mobile',
child: () => const Scaffold(body: SettingsScreen()),
overrides: _overrides,
logical: const Size(390, 1200),
);
}
@@ -0,0 +1,43 @@
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:shared_preferences/shared_preferences.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/settings/settings_screen.dart';
import '../support/golden_harness.dart';
/// 系统设置窄屏 golden × 三主题(390×844 @2x):hub 形态三组
/// 门店(门店信息/用户与角色/编号规则)+ 偏好(主题外观/默认仓库/设备管理)
/// + 数据(数据备份/关于与版本)——对齐原型 m-settings.html。
/// 更新基准:flutter test --update-goldens test/golden/settings_mobile_golden_test.dart
const _shop = ShopInfo(
id: 1,
code: 'DSJH-001',
name: '鼎晟酒行',
address: '浙江省杭州市拱墅区运河路 168 号 1 幢',
phone: '0571-8888 6666',
managerName: '王经理',
wechatId: 'dingsheng-wine',
);
List<Override> _overrides() => [
shopInfoProvider.overrideWith((ref) => _shop),
isReadonlyProvider.overrideWithValue(false),
];
void main() {
TestWidgetsFlutterBinding.ensureInitialized();
SharedPreferences.setMockInitialValues({});
goldenAcrossThemes(
'settings hub 整屏(移动)',
goldenPrefix: 'settings_mobile',
child: () => const Scaffold(body: SettingsScreen()),
overrides: _overrides,
logical: const Size(390, 844),
);
}
+1 -10
View File
@@ -8,13 +8,13 @@ import 'package:jiu_client/models/user.dart';
import 'package:jiu_client/providers/user_provider.dart';
import 'package:jiu_client/screens/settings/users_screen.dart';
import '../support/golden_harness.dart';
import '../support/shell_harness.dart';
/// design-distill 阶段4:用户管理独立页 golden × 三主题(回归闸 + 保真基准)。
/// 数据照抄原型 screens/users.html 的 USERS5 人,四级角色),
/// 相对时间(今天/昨天)用可注入时钟 appClock 冻结在 2026-07-13 09:30
/// node tools/fidelity.mjs users
/// 窄屏卡片流另见 users_mobile_golden_test.dart。
/// 更新基准:flutter test --update-goldens test/golden/users_golden_test.dart
// 原型 USERS 5 行;最近登录 今天09:12 / 今天08:50 / 昨天18:40 / 06-19 / 06-10
@@ -83,13 +83,4 @@ void main() {
overrides: _overrides,
logical: const Size(1280, 900),
);
// 移动:窄屏卡片流
goldenAcrossThemes(
'users 整屏(移动)',
goldenPrefix: 'users_mobile',
child: () => const Scaffold(body: UsersScreen()),
overrides: _overrides,
logical: const Size(390, 1400),
);
}
@@ -0,0 +1,81 @@
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:shared_preferences/shared_preferences.dart';
import 'package:jiu_client/core/auth/auth_state.dart';
import 'package:jiu_client/core/utils/clock.dart';
import 'package:jiu_client/models/user.dart';
import 'package:jiu_client/providers/user_provider.dart';
import 'package:jiu_client/screens/settings/users_screen.dart';
import '../support/golden_harness.dart';
/// 用户管理窄屏 golden × 三主题(390×844 @2x):m-section「成员 · 共 N」+
/// 头像卡片流(40 圆标 + 姓名 + 账号 + 角色图标徽章)+ FAB 新增——
/// 对齐原型 m-users.html。数据与桌面 golden 同源(5 人四级角色)。
/// 更新基准:flutter test --update-goldens test/golden/users_mobile_golden_test.dart
const _users = [
AppUser(
id: 1,
username: 'wang',
realName: '王经理',
role: 'superadmin',
isActive: true,
lastLoginAt: '2026-07-13T09:12:00'),
AppUser(
id: 2,
username: 'zhang',
realName: '张主管',
role: 'admin',
isActive: true,
lastLoginAt: '2026-07-13T08:50:00'),
AppUser(
id: 3,
username: 'li',
realName: '李采购',
role: 'operator',
isActive: true,
lastLoginAt: '2026-07-12T18:40:00'),
AppUser(
id: 4,
username: 'zhao',
realName: '赵会计',
role: 'readonly',
isActive: true,
lastLoginAt: '2026-06-19T10:05:00'),
AppUser(
id: 5,
username: 'qian',
realName: '钱仓管',
role: 'operator',
isActive: false,
lastLoginAt: '2026-06-10T14:22:00'),
];
class _FakeUserList extends UserListNotifier {
@override
Future<List<AppUser>> build() async => _users;
@override
Future<void> reload() async {}
}
List<Override> _overrides() => [
userListProvider.overrideWith(() => _FakeUserList()),
isReadonlyProvider.overrideWithValue(false),
];
void main() {
TestWidgetsFlutterBinding.ensureInitialized();
SharedPreferences.setMockInitialValues({});
// 冻结相对日期基准(详情 sheet 的最近登录)
appClock = () => DateTime(2026, 7, 13, 9, 30, 15);
goldenAcrossThemes(
'users 卡片流 整屏(移动)',
goldenPrefix: 'users_mobile',
child: () => const UsersScreen(),
overrides: _overrides,
logical: const Size(390, 844),
);
}