wangjia/jiu
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases 130 Wiki Activity
637 Commits 2 Branches 177 Tags
main
Commit Graph

43 Commits

Author SHA1 Message Date
wangjia 22e07613a1 feat(client): 授权管理独立一级屏——授权/购买续费/订单管理三 tab（桌面+移动） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-11 00:24:59 +08:00
wangjia 11413df3db fix(client): 底部 sheet 打开时横滑改为关 sheet，不再切 tab 
- showMSheet 登记「打开中 sheet」关闭器栈（任何方式关闭都注销）
- 壳层横滑手势先查栈：有 sheet 开着 → 从左往右滑关顶层 sheet，
  任何方向都不切 tab / 不退二级屏；无 sheet 才走原 tab 切换/返回逻辑

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 20:55:31 +08:00
wangjia 02cffcb9ba feat(client): 切页滑动过渡 + 二级屏返回手势方向修正 + 授权三格横排 
- 窄屏切页加方向感知滑入过渡（240ms easeOutCubic + 渐显）：tab 间按左右
  次序、进二级屏从右滑入、返回从左滑入；桌面无动画。控制器在 initState
  创建（惰性 late 到 dispose 才求值会在已卸载树上找 Ticker 崩溃）
- 二级屏返回手势方向修正：从左往右滑=退出（iOS 返回习惯），向左滑无响应
- 授权信息三格（状态/到期日/剩余天数）窄屏改横排：间距收窄 + FittedBox
  缩放值文本防溢出，桌面不变

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 20:39:31 +08:00
wangjia 9efd1177b7 feat(client): 移动端横滑手势——tab 根左右滑切 tab、二级屏左滑退出 
- tab 根（库存/入库/出库/财务/我的）：左滑下一个 tab、右滑上一个（不循环）
- 二级屏：左滑返回（同顶栏返回箭头语义），右滑无响应
- 仅窄屏生效；内容区横向滚动（分段 tab/表格横滚）在手势竞技场优先，不冲突

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 20:31:33 +08:00
wangjia be9afcf68d 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>
 2026-07-04 11:56:04 +08:00
wangjia 6238b86dcb feat(client): 登录/注册页照原型重建，ds 真相源组件族统一全部屏 
- 登录/注册（login.html/register.html 1:1）：两栏卡片+品牌渐变面板+主题小衣服
  pill（onSurface 变体）+记住我（记录并预填最近账号）+原型式 toast 校验；
  登录 fidelity 1.4–2.1% 三主题全绿；注册暂不入闸（少 门店编号/兑换券 字段，
  已记 CONTRACT，screens.mjs 留存根）
- ds 原子补齐：DsToast（.toast 单例）/DsCheck（.check/.agree）/DsButton lg 档/
  DsSelect 替换全部旧 DropdownButton/DsField label 在上/DsInput 后缀与密码形态
- 全屏统一：对话框按钮全 DsButton、盒式输入主题钉死（visualDensity.standard、
  h38、InputDecorationTheme 渗漏修复）、图标全 lucide、JetBrains Mono 三端同源、
  BrandMark 真相源 logo、只读模式写操作全量守卫（WriteGuard+DsToast）
- 出入库列表：版式对齐原型（卡片对齐+搜索框居中）、KPI 近30天滚动、结清后
  失效财务应收应付表；商品编辑抽屉介绍库改搜索下拉、图片双击全屏预览
- 删除旧 UI 死代码：DataTableCard/FormDialog/PageScaffold/SearchChip/
  SelectProductDialog/tabStateProvider
- golden/fidelity：stock-in/out 补注册（9%）、login 入册（8%）、goldens 全量重打；
  修复 pubspec flutter_web_plugins 非法声明（CI pub get 阻断）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
 2026-07-03 09:58:14 +08:00
wangjia 0b8c4618d6 feat(tools): 代码端真相源闸 check_ds_code + 外壳硬编码颜色清零 
把原型 check-ds 的「单一真源」纪律延伸到 Flutter 代码：
- client/tool/check_ds_code.mjs：扫 lib/(排除.g.dart) 硬编码 Color(0x..)/Colors.具名色，
  --strict/--changed 报错挡提交，合理特例须显式 // ds-ignore: 理由
- tokens.css(单源,client+原型同步) 加 chrome 前景色 --brand-dot/--on-accent/--on-accent-faint，
  codegen 进 AppChrome；外壳 14 处硬编码(白字/品牌点/grace橙)全部改走 token
- 外壳+3 新 widget 现 0 违规；全量存量 172→158（其余屏后续逐步清）

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TSKEiHsvauyxYUW2itzUXX
 2026-07-01 20:46:53 +08:00
wangjia cb549ff0b4 fix(client): 账号菜单弹按钮正上方不遮挡 + side-user hover 变色 
对照原型修两点：
1. 菜单原先 over 盖住 side-user 按钮；改为按「菜单估高」把菜单完整弹到按钮上方
   留 8px 间隙，触发器始终可见（对齐原型）
2. side-user 抽成 _SideUserTile，加 hover 变色（t.sideHover，与左侧 nav 一致）
- user_menu_width_test 增断言：菜单末项底 ≤ 触发器顶（不遮挡）

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TSKEiHsvauyxYUW2itzUXX
 2026-07-01 20:46:53 +08:00
wangjia 36ace8a1a0 fix(client): 账号菜单改 showMenu 等宽触发器 + 向上弹（修菜单溢出盖内容） 
上一版用 PopupMenuButton width:218 + offset:-12 反而把菜单外扩、右缘越过侧栏
盖住内容区。改为 GestureDetector + showMenu，菜单宽度 = 用户区实测宽度（自动与
侧栏内容等宽、绝不溢出），底部空间不足 showMenu 自动向上弹、不遮触发器。
加 user_menu_width_test：点开后断言菜单宽≈194、右缘≤218（弹出态回归）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TSKEiHsvauyxYUW2itzUXX
 2026-07-01 20:46:53 +08:00
wangjia 4bfb79becd fix(client): 外壳两处对齐修正（顶栏右组靠右 + 用户菜单与侧栏等宽） 
- 顶栏：左组（品牌+门店）改 Expanded 占满，主题器+通知铃挤到最右；
  原 Flexible(flex1) 与 Spacer(flex1) 平分剩余空间导致右组浮在中右
- 侧栏底部用户菜单：constraints 固定 218 宽 + offset 左对齐侧栏左缘，与侧栏等宽
- 状态栏操作员显示 realName（王经理）而非 username

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TSKEiHsvauyxYUW2itzUXX
 2026-07-01 20:46:53 +08:00
wangjia 3f178f6a98 refactor(client): Phase 1 照原型重建 app 外壳（顶栏两级品牌 + 主题器 + 通知铃 + 分组侧栏 + 状态栏） 
照 shell.js/statusbar.js/atoms.css 把外壳从「旧单品牌+换色」彻底重建为原型样式：
- 顶栏：岩美酒库(线描山形 mark CustomPaint，软件品牌) │分隔│ 鼎晟酒行(门店字标+店名)；
  右侧 ThemePickerPill(主题器，从系统设置迁来，A/B/C 切换) + NotificationBell(通知)
- 侧栏(218w)：分组 单据/经营/系统(nav-label) + nav(active 高亮) + 底部 side-user(头像/姓名/店·角色→菜单)
- 状态栏：AppStatusBar(原型 .statusbar，AppChrome 主题无关色)：店号/操作员/登录/当前(走字) · 连接/版本/授权
- 保留全部既有行为：更新/强制更新/授权横幅与弹窗、离线横幅、心跳、apiMessage、窄屏 Drawer
- 新增 widgets/theme_picker_pill.dart · notification_bell.dart · app_status_bar.dart
- golden：加载真实 MaterialIcons 字体（消图标豆腐块，全 golden 受益）；
  app_shell golden 用 9 分支+冻结时钟(可测试缝)确定化，对齐原型数据(鼎晟酒行/王经理/库存激活)
- fidelity：外壳 vs 原型 diff 3.5% ≤ 阈，montage 目检 chrome 与原型一致

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TSKEiHsvauyxYUW2itzUXX
 2026-07-01 20:46:53 +08:00
wangjia dfe9796ae8 refactor(client): 裸色字面量 F0F6FF/F0F4FF 迁移到 token 
入库选填区/退单提示条 F0F6FF → infoSoft；表格列头 F0F4FF → thBg；
登录历史项/外壳用户菜单 hover → rowHover、菜单文字 → text。
深色主题 B / 暖色主题 C 下这些 chrome 现可正确随主题换色。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TSKEiHsvauyxYUW2itzUXX
 2026-07-01 20:46:51 +08:00
wangjia 9afe0dcf6e refactor(client): 设置/外壳颜色迁移到 context.tokens 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-01 20:46:51 +08:00
wangjia a76724b385 feat(client): 录单表单优化 + 可搜索下拉支持新建 + 日期选择器组件 
新增 DatePickerField 日期选择器与 date_util；可搜索下拉 SearchableOptionField
支持内联新建选项；入库/出库录单表单、商品页、财务页、app_shell 导航相应调整。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-20 07:05:22 +08:00
wangjia 32bd64d676 feat(client): 实时授权状态与会话失效处理 
- 心跳读取 /auth/ping 回带的授权概况，直接刷新横幅/状态栏/只读门禁，省去单独轮询 /license/info
- 账号被停用/删除（401 USER_DISABLED）即强制重新登录
- 令牌持久化经串行队列 + 会话代号守卫，杜绝续期写入与登出交叉把失效 token 写回
- 写操作门禁（write_guard）+ 授权文案（license_copy）按 grace/readonly/locked 分阶段降级

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-19 07:34:07 +08:00
wangjia a8e29a641a feat(client): 退出登录归入用户名下拉菜单 
侧栏底部用户名行改为可点击的 PopupMenuButton，点击弹出账号菜单，
退出登录移入其中；移除原用户名行直接打开门店信息面板的入口。
设备管理保持在侧栏导航不变。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Y2Wdwo7SmgBJU37cBrkhPK
 2026-06-18 08:57:30 +08:00
wangjia 90f318e246 chore: release client-v1.0.57
Deploy Client / build-windows (push) Failing after 21s
Details
Deploy Client / build-client-web (push) Successful in 42s
Details
Deploy Client / build-macos (push) Successful in 2m8s
Details
Deploy Client / build-android (push) Successful in 1m25s
Details
Deploy Client / build-ios (push) Successful in 2m47s
Details
Deploy Client / release-deploy-client (push) Has been skipped
Details 
设备/状态管理屏（查看本店在线设备/会话，管理员可强制下线）、登录携带设备信息、
会话心跳（/auth/ping）、被踢下线/会话失效提示、顶栏精简 + 用户名移至左侧栏底部。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-17 23:13:05 +08:00
wangjia dfa1920dda feat(client): 列表屏搜索前置/显示字段记忆/移动端表格切换与工具栏瘦身/退出登录归位 
- 库存查询搜索框移到工具栏最前（桌面）/独占首行（移动端）
- 修复入库/出库/财务「显示字段」失效：移除 minWidth 运行时强制隐藏，
  用户勾选权威、minWidth 仅作首次默认；新增 ColumnPrefs 持久化记忆（四屏独立）
- 移动端库存支持表格/卡片列表切换
- 移动端三个列表屏工具栏改 Wrap 紧凑布局、导出/显示字段图标化
- 退出登录统一到左侧导航：删系统设置内与桌面右上角下拉，桌面左侧栏底部新增

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-17 18:33:31 +08:00
wangjia f15692bbd5 refactor(client): 只读判断统一走 WriteGuard 控件 
将各屏内联的 ref.watch(isReadonlyProvider) 只读判断统一改为
WriteGuard(child:) 或 WriteGuard.isReadonly(ref)，全项目只读逻辑
单一入口（仅 write_guard.dart 内部保留 provider 读取）。行为不变。

121 测试通过，analyze 无 error。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-17 00:56:31 +08:00
wangjia 196901b6d3 feat(client): 只读角色隐藏所有写按钮（WriteGuard 统一控件 + 顶栏只读标识） 
- 新增 isReadonlyProvider（role == 'readonly'）+ WriteGuard 控件，统一隐藏写控件
- 入库/出库/库存/商品/基础数据/往来单位/财务/设置 各屏：只读时隐藏
  新增/编辑/删除/审核/提交/驳回/结清/盘点/导入/激活/用户管理 等写操作
- 顶栏显示「只读」标识，让只读用户明确当前权限
- 后端 middleware.ReadOnly() 仍兜底 403，UI 隐藏 + 后端拦截双保险

修正：此前误判为后端漏洞/部署 bug，实为前端写按钮未对只读隐藏。
后端经验证正确拦截只读写操作（线上 stock-in/product-options 均 403）。

121 测试通过，analyze 无 error。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-17 00:42:40 +08:00
wangjia e8bdb19195 feat(client): 抽屉+设置页加退出登录入口；酒行信息显示微信号 
- 左侧抽屉底部、系统设置页底部各加「退出登录」按钮（窄屏顶栏菜单
  不便时也能退出；登出后路由 redirect 自动跳 /login）
- 酒行信息 tab 补显示「微信号」行（模型/编辑弹窗早已支持 wechat_id，
  仅只读展示遗漏）

121 测试通过。todo #54 #55。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-16 22:26:17 +08:00
wangjia cd672e500f fix(client): iOS 顶栏避开状态栏，修复菜单按钮被遮挡退不出登录 
顶栏 Container 原从 y=0 起绘，iOS 状态栏盖住左上角菜单按钮，窄屏无法
打开抽屉菜单/退出登录。顶栏高度加上 MediaQuery.padding.top，内容下移
一个状态栏高度，蓝色仍铺满到屏幕顶。桌面/Web 状态栏高度为 0 不受影响。

todo #53。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-16 22:20:07 +08:00
wangjia 018180de8c feat(client): 网络请求重试 + 离线提示可感知重试按钮 
修复①请求级重试：新增 RetryInterceptor，网络层失败重试 3 次间隔递增
1s→2s→4s；GET 全重试，写操作仅在连接未建立时重试以防重复提交。
connectTimeout 5s→8s。

修复②连通性：启动首检改退避重试 4s→8s→12s，根治跨境冷启动假离线；
新增检测中状态 + retry()；登录页/全局离线提示加 NetworkRetryButton，
重试中转圈、结果 SnackBar 反馈。

121 个测试通过，analyze 无 error。todo #52。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-16 14:42:23 +08:00
wangjia 1a0a7bd5ef fix(client): 将 _buildLicenseBanner/_showLicenseExpiryDialog 移回 _AppShellState 
两个方法误放入 _StatusItem 类，导致 Windows CI 编译报错：
- _buildLicenseBanner/showLicenseExpiryDialog 对 _AppShellState 未定义
- _StatusItem 内 context.go() 调用找不到 context getter

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-10 23:50:55 +08:00
wangjia 97ebb18fd7 feat(client): 授权 Tab 激活 UI + 到期横幅/弹窗 (21F+21G) 
21F — 激活与设备管理 UI:
- settings_screen: 重构授权 Tab，按 phase 展示色阶状态
  (normal=绿/grace=橙/readonly|locked=红)
- 新增「激活授权码」卡片：文本框 + 激活按钮，调用 LicenseRepository.activate
- 显示设备上限字段 (maxDevices)

21G — gating 横幅 + 到期弹窗:
- app_shell: 引入 licenseProvider，needsAttention 时展示顶部横幅
  (grace=深橙/readonly=深红/locked=红)，横幅含「去激活」快捷入口
- 每 session 首次进入时弹出到期提醒 dialog（postFrameCallback 模式）
  内容随 phase 调整文案，提供「稍后处理」/「立即前往设置」两个按钮

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-10 07:08:35 +08:00
wangjia daa83bd408 chore: release v1.0.27
Deploy / build-windows (push) Successful in 1m56s
Details
Deploy / build-android (push) Has been cancelled
Details
Deploy / build-ios (push) Has been cancelled
Details
Deploy / release-deploy (push) Has been cancelled
Details
Deploy / build-linux-web (push) Successful in 53s
Details
Deploy / build-macos (push) Failing after 1m16s
Details 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-09 00:15:46 +08:00
wangjia 480ce836bb chore: release v1.0.18
Deploy / build-linux-web (push) Successful in 53s
Details
Deploy / build-windows (push) Successful in 1m48s
Details
Deploy / build-macos (push) Successful in 1m17s
Details
Deploy / build-android (push) Successful in 4m13s
Details
Deploy / build-ios (push) Successful in 9s
Details
Deploy / release-deploy (push) Successful in 1m37s
Details 
移动端响应式适配（抽屉导航/列表卡片/弹窗自适应）、Android 正式签名与 APK 发布、
iOS(TestFlight) 工程与 CI、多平台构建流水线、相关文档同步。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-07 07:55:33 +08:00
wangjia dd09f1a526 feat(client): 关于→关于我们，移到左侧菜单独立页面 
- 新增 screens/about/about_screen.dart（版本信息/授权信息/关于我们/意见反馈）
- 左侧导航新增「关于我们」(/about)，从系统设置移除原「关于」Tab（7→6）
- 迁移并清理 settings 中仅关于页使用的 widget/弹窗/import

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-05 20:05:12 +08:00
wangjia c98a90472b feat(client): 更新提示加引导文案，强制更新弹窗文案统一 
- banner: 发现新版本 vX，建议立即更新以获得最新功能与修复
- 强制更新弹窗: 去掉 release notes，统一为「需更新后才能继续使用，
  更新以获得最新功能与修复」

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-05 09:25:43 +08:00
wangjia 207a9a8343 feat(client): 更新 banner 去掉更新内容 + 安装程序中文化 
- 顶部更新 banner 只显示「发现新版本 vX」，不再附带 release notes
- Inno Setup 安装向导改中文：随仓库带 ChineseSimplified.isl（加 UTF-8 BOM），
  .iss 用相对路径引用，compile-windows.sh 把它和 .iss 一起拷到构建目录，
  不依赖 runner 上 Inno Setup 是否自带简中
- （检查更新无更新时的提示已在上个提交加好）

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-05 09:20:50 +08:00
wangjia d8c0bd74d2 feat(client): 应用内更新（Windows/macOS 下载安装，Web 刷新） 
- 新增 lib/core/update/：app_updater(入口+进度对话框) + io/web 条件实现
  - Windows: Dio 下载 setup.exe(无 MOTW) -> 启动安装包 -> 退出，规避浏览器
    SmartScreen 下载页与运行时拦截
  - macOS: 下载 zip -> ditto 解压 -> 后台脚本等退出后替换 /Applications 内
    app 并重启（权限失败回退访达高亮）
  - Web: 刷新页面；其它平台回退浏览器下载
- app_shell 更新 banner/强制更新弹窗、设置页「立即更新」改走应用内更新
- 设置页「检查更新」加反馈（正在检查/已是最新/发现新版本/失败）
- jiu-installer.iss 加 CloseApplications=yes 便于覆盖

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-05 09:04:26 +08:00
wangjia a05f9bd4ec feat(shop): 门店 logo 上传 + 侧边栏品牌替换
Deploy / deploy (push) Failing after 8s
Details 
- shops 表新增 logo_url 字段，AutoMigrate 自动建列
- 后端新增 POST /api/v1/shop/logo 接口（管理员），图片裁剪为 256×256 JPEG 存储
- UpdateInfo 支持传入 logo_url
- 侧边栏「岩美」替换为门店真实名称 + 自定义 logo
- 无 logo 时显示店名首字文字头像（深蓝底白字）
- 设置页「酒行信息」展示 logo 预览，编辑弹窗新增「更换 Logo」上传按钮
- 修复库存导入计数逻辑：total/imported/updated/errors 四项分别统计
- 库存导入去重改为双路索引（编号 + 名称|系列|规格），避免 key 不一致误判新增
- settings 页导入结果统一显示「重复 X 条」，兼容 skipped 和 updated 两个字段

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-05-24 20:03:43 +08:00
wangjia 30a8e791a3 feat: 扫码商品详情页重设计 + 宣传主页 + nginx 路由完善 
- public_product_screen: 1:1 复刻设计稿，新增商品介绍、批次防伪（自定义圆形印章）、完整商品参数表、门店营业时间、页脚链接
- app_theme: 完整品牌色系（brand/gray/accent/semantic）
- shop model: 新增 business_hours 字段，public 接口同步返回
- nginx: 新增 /product/ → Flutter app 扫码入口，修复 /docs /download html 后缀兼容
- web/: 新增宣传主页、功能页、文档页、扫码 HTML 及设计资源
- app_shell: 界面优化

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-05-23 18:58:04 +08:00
wangjia c1ed81dfab 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>
 2026-05-23 14:05:41 +08:00
wangjia 393e227de5 feat: 商品详情页、XLS导入修复、分页选择器、导出功能 
后端：
- 新增 product_images 表，支持每商品最多5张图（服务端压缩至1200px/JPEG85%）
- products 表新增 public_id(UUID)、description 字段
- 新增商品详情接口、二维码接口、公开商品接口（无鉴权）
- 修复 XLS 导入：OLE2 magic bytes 检测 + 临时文件解析，兼容 extrame/xls
- 修复商品/名称/系列/规格三张表导入数据为0（LastCol()=0 bug）
- 所有导入接口返回 total/imported/skipped 统计
- config 新增 StorageConfig，支持 STORAGE_* 环境变量覆盖
- 种子数据修复：products 补 public_id、新增 product_images TRUNCATE、schema.sql 表名修正

前端：
- 商品详情页：图片上传/删除、描述内联编辑、二维码弹窗、公开链接复制
- 公开商品页：无鉴权路由 /product/:public_id，Flutter Web SPA
- 商品详情列表（批次追踪）商品名超链接跳转详情页
- 导航「商品管理」改名「商品详情」
- 所有列表表格新增每页条数选择（10/20/50/100）
- 表格列头内嵌筛选（FilterableColumnHeader）
- 导出 Excel 功能（入库/出库/库存/财务/批次/往来单位）
- 网络恢复自动刷新 + 离线缓存展示

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-27 00:29:51 +08:00
wangjia 5dd7c07138 feat(client): 网络恢复自动刷新 + 离线嗅探 + 连通性感知登录 
网络嗅探与自动恢复：
- ConnectivityNotifier：在线时 30s 检测，离线时切换为 1min 嗅探
- 新增 networkRecoveryCountProvider：网络恢复时自增，各数据 provider
  通过 ref.watch 实现自动重新加载
- inventory/product/stock_in/stock_out/partner provider 均已接入

FutureBuilder 类屏幕：
- finance_screen + batch_tracking_screen 通过 ref.listen 监听恢复事件

修复问题 1：API 超时 10s/30s → 5s/15s，减少无网络时等待
修复问题 2：offline banner 文字由"写操作已禁用"改为实际行为描述

连通性感知：
- app 启动时（_AppBootstrap）立即 forceCheck，路由跳转前状态已就绪
- 登录页：watch connectivityProvider，离线时显示警告 banner
- 登录按钮：离线状态下直接提示，不等待超时

测试：
- login_screen_test + login_flow_test 通过 ConnectivityNotifier(skipInit: true)
  覆盖 provider，避免测试环境中 pending HTTP timer

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-18 19:52:17 +08:00
wangjia bb4f17cf7a feat: 自动更新、系统设置、安全修复 
后端：
- 新增 GET /version 版本检查端点（version.go + version.yaml）
- 新增 GET /license/info 接口，返回门店授权信息
- 修复 GenerateOrderNo 并发重复单号：事务内加 FOR UPDATE 行锁
- 修复 ApproveStockOut 超卖竞态：预检和库存更新均加 FOR UPDATE
- 修复 Product Create 并发 code 冲突：加重试逻辑，schema 加 UNIQUE KEY
- 修复 Product Update 全字段覆盖：改用 selective Updates()
- 挂载 ReadOnly 中间件（全局）+ AdminOnly（用户管理路由）
- version.go 配置缺失时返回 500 而非静默降级

前端：
- 新增自动更新检测（update_provider.dart）+ shell 更新 banner/弹窗
- 新增系统设置"关于"标签页：版本、授权、开发信息、意见反馈
- 新增离线缓存：所有 AsyncNotifierProvider 支持断网浏览历史数据
- 新增门店信息弹窗（点击左上角 logo 或右上角门店号触发）
- 提取 AppConfig 统一管理 BASE_URL，支持 --dart-define 注入
- update_provider.dart 加 kIsWeb 保护，修复 Web 平台崩溃
- dev.sh 新增 stop 命令，修复 stop 误杀前端进程问题

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-13 00:28:08 +08:00
wangjia 66e54af8c6 feat: 商品追踪页面 + 出库提交库存校验 
后端：
- feat(backend): 重命名 Batches→Products 接口，新增库存状态(在售/已卖出)和买家信息
- feat(backend): 出库单创建/提交时校验仓库库存，不足则返回明确错误信息
- fix(backend): 出库创建 status 判断逻辑修复（空值默认 draft）

前端：
- feat(client): 批次追踪改为商品追踪，新增状态列(在售/已卖出)和买家/时间列
- fix(client): 无批次号时显示"无批次"而非空
- refactor(client): BatchRecord → ProductTrackingRecord，repository 接口更新

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-10 22:26:42 +08:00
wangjia ce1cbf404c feat: 完成7项功能任务 
后端：
- fix(backend): InventoryLog 增加 Product/Warehouse 关联，Logs 接口加 Preload 修复流水记录显示"-"
- feat(backend): 新增 /inventory/batches 批次追踪接口
- feat(backend): 新增财务记录、编号规则接口（finance、number_rule handler）
- fix(backend): service/stock_test.go 修复 model.Date 类型错误

前端：
- feat(client): 入库/出库管理 Tab 调换顺序（审核在前），审核 Tab 加新建按钮，列表 Tab 无按钮
- feat(client): 入库单/出库单增加详情弹窗，显示完整单据信息和商品明细
- feat(client): 完善出库单新建表单（StockOutFormScreen），支持选客户/仓库/商品
- fix(client): StockInItem/StockOutItem.fromJson 修复读取嵌套 product 对象而非平铺字段
- feat(client): 批次追踪页面（BatchTrackingScreen）及侧边栏入口
- feat(client): 财务管理、盘点、编号规则接入真实后端 API
- fix(client): 入库/出库审核通过后 invalidate inventoryListProvider 刷新库存

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-10 22:03:19 +08:00
wangjia d717fb3735 feat(client): 全模块 API 对接 + 修复登陆跳转 + 菜单 UI 优化 
API 对接：
- 入库/出库/库存/财务/往来单位/基础数据全部对接后端 REST API
- 新增 repositories、providers、models 层，统一分层架构
- auth 从 flutter_secure_storage 迁移到 shared_preferences

登陆跳转修复：
- 将 _RouterNotifier 提取为独立 Riverpod provider，appRouterProvider
  使用 ref.read 避免依赖链导致 router 重建后跳回 /login
- redirect 函数新增 initialized 守卫，防止 auth 未恢复时误重定向
- 添加调试日志（Router/Auth/ApiClient）定位 401 触发的 logout 链路

退出菜单 UI：
- 去掉 ListTile，改用 Row + 自定义 padding，文字左对齐
- MouseRegion + AnimatedContainer 实现 hover 高亮（普通项蓝底/退出红底）
- 菜单圆角 6px，elevation 8，分割线高度 1px

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-07 22:20:28 +08:00
wangjia 37112d6599 feat(client): 登录历史下拉、macOS 兼容修复、UI 优化 
- 替换 flutter_secure_storage 为 shared_preferences，解决 macOS Keychain 签名报错
- 登录页门店编号/用户名支持历史下拉（最多5条，LRU 淘汰），使用 Overlay + CompositedTransformFollower 实现浮层
- logout 仅删除 auth token，保留登录历史
- AppShell 时钟抽为独立 _ClockWidget，避免每秒 setState 导致 TabBarView 叠影
- ShellRoute 子路由改用 NoTransitionPage，消除切换页面时的过渡动画叠影
- 新增 auth_state_test、auth_repository_test、login_screen_test 共 14 个单元/Widget 测试

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-05 01:21:40 +08:00
wangjia cc687ae0c3 feat(client): 登录模块对接后端 API 
- auth_state: 增加 refreshToken 字段 + flutter_secure_storage 持久化
- api_client: 增加 401 自动 refresh + retry 拦截器
- auth_repository: 封装 POST /api/v1/auth/login 调用，错误信息本地化
- login_screen: 增加门店编号字段，调真实 API，行内错误展示
- main: 启动时 restore 持久化登录态，避免每次重启都要重新登录
- 修复 app_shell: hotelName → hotelNo
- 修复 widget_test: 移除失效的占位测试

测试账号：门店编号 H001 / 用户名 admin / 密码 password123

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-04 23:18:57 +08:00
wangjia 76ab19ea47 feat(client): 初版 Flutter UI 框架，仿照参考截图实现 
- 蓝色顶栏（#1565C0）+ 深蓝侧边栏（#0D47A1），含折叠/展开
- 底部状态栏：门店编号、登录用户、登录时间、实时时钟、版本号
- 登录页：居中卡片，支持密码显示/隐藏
- 入库单列表：筛选/搜索/日期选择/分页，三个 Tab（入库单/查询/审核）
- 新建入库单：基本信息 + 商品明细动态增删，实时计算合计金额
- 出库单列表：同入库单风格
- 库存查询：4 张统计卡片 + 颜色高亮缺货/预警行，库存预警 Tab
- 往来单位、财务、商品、系统设置（用户/仓库/编号规则/系统参数）
- 使用 Riverpod 状态管理 + go_router 路由 + Dio HTTP

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-04 12:51:41 +08:00