wangjia/jiu
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases 128 Wiki Activity
530 Commits 2 Branches 174 Tags
b740cc6edf5eed687b4dee5f8e5cd2b4ca5f46f5
Commit Graph

246 Commits

Author SHA1 Message Date
wangjia b740cc6edf feat(client): iOS 上架合规——首启隐私同意弹窗 + 注销账号入口 
个保法/审核 5.1.1：移动端首启全屏隐私同意（链接隐私政策/用户协议，
同意持久化；不同意 Android 退出、iOS 留提示）；我的页 iOS 形态新增
「注销账号」（sheet 说明 + 预填 mailto 至 support@51yanmei.com）。
关于页隐私政策/服务条款链接已有，桌面/Web 零改动。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-05 08:56:26 +08:00
wangjia dddf402d92 feat(client): iOS App Store 合规——授权页隐藏外部购买 UI，补中性联系客服卡 
苹果 3.1.1：iOS 包不渲染在线购买卡与套餐价格链接；兑换券保留（3.1.3(b)），
新增「联系客服」卡（mailto:support@51yanmei.com，无购买引导字样）。
其余平台零改动；开关 hideExternalPurchaseUi 供设备上限弹窗等复用。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-05 07:27:31 +08:00
wangjia c49ee3b1df feat(client): 库存抽屉打印标签 + 修本地构建版本号不对 
- 商品编辑抽屉头部「预览」旁加「打印标签」（同入库管理：QR+品牌型号版本+
  门店信息 → LabelPreviewDialog；移动端无打印不渲染）
- 修版本号 bug：appVersionProvider/更新检查改为优先 APP_VERSION dart-define
  （本地与 iOS 手工构建不改 pubspec，PackageInfo 恒为旧值 1.0.52，App 内
  显示错且误弹更新横幅）；版本比较容忍 -dev/+build 后缀（每段取前导数字）
- local_test.sh：版本标记 -dev（如 v1.1.4-dev）明确区分本地包；新增 --ios
  模式（开发签名构建 + devicectl 装 USB iPhone），双端同一版本注入链路

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 23:57:37 +08:00
wangjia c9217601a1 feat(client): 全列表下拉刷新 + 库存移动工具行移除 
- DsTable 窄屏卡片流支持 onRefresh（RefreshIndicator，空态也可下拉）——
  等价桌面工具栏「刷新」；库存/入库/出库/往来/财务流水/用户/基础数据
  全 tab 接线（基础数据下拉一并重拉五个 tab 数据源）
- 库存移动端「盘点/表格视图/导出/列设置/刷新」工具行移除（2026-07-04
  拍板：刷新改下拉手势、盘点入口在「我的」、其余桌面专属），
  库存移动 golden 随更新

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 23:52:06 +08:00
wangjia 99ceaa87bb fix(client): 通知铃菜单贴顶栏弹出（收回 40px 悬空偏移，修手机端漂移） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 23:05:34 +08:00
wangjia 86611dc9ee feat(client): 在线购买完成后选择页默认落到 高级版·年付 
支付成功即把套餐 tab 置为高级版、周期置为年付（特惠单同时本地置灰
「已享受」）——继续购买/复购时直接主推年付高级档

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 22:46:36 +08:00
wangjia a773a33779 feat: App→网页免登录（一次性换票 SSO）——移动/桌面点链接直达已登录官网 
- backend：POST /auth/web-ticket（需登录，签 60s 单次票据，每用户限频）+
  POST /auth/web-ticket/exchange（公开，原子即焚兑换正常登录态，响应同
  /auth/login 另带 shop_code）；web_tickets 新表 + user_sessions.kind 列
  （sso 会话：web 平台、refresh 12h 硬到期、不占设备并发配额、设备管理可见
  可踢）；清理任务顺带清过期票据；schema.sql/AutoMigrate/testutil 同步
- web：/sso 落地页——兑票写入与 Web 版共享的 localStorage 后跳 redirect；
  redirect 白名单只收本站相对路径（防 open redirect），票据即时从地址栏抹除
- client：launchAuthedWebPath(ref, path) 封装（签票→拼 /sso URL→launchUrl，
  失败降级未登录直开；桌面/移动同一套）；授权面板「查看套餐价格」接入

test(backend): web_ticket_test 三用例（兑换+续期/单次即焚/过期拒绝/
sso 不占配额双向验证）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 21:30:08 +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 f9d5bc79c7 fix(client): 关于页「检查更新」按钮与反馈按钮同规格对齐（38h 通栏） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 20:48:15 +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 980e38e020 feat(client): 库存/出入库移动卡片与详情 sheet 逐一对齐原型结构 
- 新增 MCard（原型 .m-card 双栏：mc-main 标题+副行 mono | mc-right 徽章行+
  金额 mono | › | mc-foot ⓘ脚注）+ DsIconBadge(.badge.ico 22px 纯图标)/
  DsTextIconBadge(.badge.bi 图标+文字) + statusToneOf 状态词配色表——
  替换原 MobileListCard「标签:值」布局与各屏本地 _icoBadge/_statusColors
- 出入库卡：单号 + 供应商/客户·N 项 + 状态/退单/待定价图标徽章 + 合计金额 +
  日期·经手人·审核 脚注；库存卡：品名 + 编码·规格 + 状态徽章 + 数量(缺货红/
  预警黄)；移动卡不再有行内操作（对齐原型，操作统一在详情 sheet；打标签=
  打印，移动端裁剪）
- DsTable 窄屏卡片流去外层大卡容器（卡直接铺页面底色，对齐原型 m-scroll）——
  往来/基础数据等全部卡片流屏同步受益
- 出入库详情窄屏改 sheet 专属布局（原型 openOrder）：drow 字段行 + 明细
  pe-card（头行 图标+「明细 · N 项」+ 行=品名+系列·×数量 | 金额/待定价徽章）+
  合计 drow + 等分按钮行（无组标签）；桌面右滑抽屉布局不变
- 相关移动 golden 全量重生成（出入库/库存/往来/基础数据 ×3 主题），
  桌面 golden 零漂移；283 测试全绿

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 19:30:40 +08:00
wangjia cd477ce81a fix(client): 抽屉内操作不再收抽屉（原地刷新）+ 日期输入框垂直居中 
- 出入库详情抽屉：通过/拒绝/撤回/提交/结清/退单/确认定价/打印 全部不收抽屉，
  操作完成后原地重拉单据刷新内容（StatefulBuilder+refresh）；仅 遮罩/X/
  修改·删除（离开语义）关闭——对齐拍板「点抽屉外才收回」
- 往来抽屉「编辑」、财务往来抽屉「登记收款/付款」（完成后流水原地刷新）、
  商品编辑抽屉「保存」同规则；「取消」保持关闭语义
- 日期组件输入框 forceStrutHeight 锁行盒：修等宽字体 ascent/descent 不对称
  导致的文字垂直偏移

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 18:09:21 +08:00
wangjia fb236018f3 refactor(client): 日期选择统一为扁平组件——输入框+滚轮同宽居中入面板，桌面/移动全覆盖 
- wheel_date_picker.dart 重构为统一组件：单日期 showDsDateDropdown（面板=
  可输入框+三列滚轮+今天/确定）、范围 showDateRangeDropdown（起始|结束双窗格
  并排+共用底栏）；桌面锚定下拉（透明遮罩不冻结窗口）、窄屏底部 sheet 同内容
  （范围纵排）——同一套窗格两端复用
- 扁平化：输入框与滚轮同宽 248、文字水平垂直居中(mono)、去掉全部阴影/立体
  效果（滚轮外框仅 1px 边框，中心高亮带去描边）
- DsDateCell（录单日期格）与 DatePickerField（登记收支）改为触发器：点选/
  回车打开统一面板，键入在面板内完成；出库工具栏时间 chip 补切到新组件
- 旧 showWheelDatePicker/showWheelDateRange 两步弹窗删除；组件测试改写为
  新契约（触发器+面板键入+词法归一），表单 golden 随形态更新

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 17:49:17 +08:00
wangjia 06dc68245a feat(client): 日期范围改锚定下拉——起止并排双滚轮 + 可键入，不再冻结窗口 
- 新增 showDateRangeDropdown：锚定触发控件下方（透明遮罩点外关闭，形态同
  DsMenu 下拉），起始/结束两列并排，各带可输入框（键入/回车/失焦归一
  yyyy-MM-dd）与滚轮，输入↔滚轮双向联动；共用底栏显示当前范围 + 确定，
  起止倒置自动交换；窄屏回落既有两步滚轮弹窗
- WheelDatePanel 加 showFooter/onChanged（滚动即回调），供范围面板复用
- 出入库列表 6 处调用切换：工具栏时间 chip「自定义…」、桌面详搜弹窗、
  窄屏详搜 sheet 的日期区间字段均锚定在各自控件下方

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 17:29:21 +08:00
wangjia 0425939d7e feat(client): 录单日期格支持直接键入（DsDateCell 可输入 + 滚轮并存） 
- DsDateCell 由纯点选改为可键入：支持 2024 / 2024-5-12 / 20240512 等，
  失焦或回车归一为 yyyy-MM-dd；回车提交并推进下一格（键盘流保留 Tab/Esc）；
  日历图标仍打开滚轮面板，滚轮确定回填输入框
- 归一词法抽为共享 normalizeYmd（core/utils/date_util.dart），
  DatePickerField 改为复用同一实现（登记收支等处词法一致）
- 出入库表单 golden 基准随日期格形态更新（桌面+移动 ×3 主题）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 17:20:03 +08:00
wangjia 9445042cb4 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>
 2026-07-04 12:19:15 +08:00
wangjia dde87a32b6 feat(client): 库存/盘点/财务窄屏对齐移动原型（KPI 网格/卡片流/图标徽章/sheet） 
- 库存列表：窄屏隐藏页内大标题头；KPI 2×2 MKpiGrid（缺货卡 warn+点击筛选）；
  MSearchRow（详搜钮开筛选 sheet：状态/规格/系列）；卡片徽章换图标变体
- 库存盘点：窄屏卡片流（单号/范围·项数/进行中徽章带图标/差异/日期）+
  详情 sheet（drow 键值行）+ 底部操作条；DateTime.now→appNow 可注入时钟
- 财务：窄屏隐藏大标题头；KPI 2×2（收入 up 绿/支出 down 红/应收 warn）；
  DsSeg 应收/应付/流水三分段 + 卡片流（类型徽章带图标、金额正负色）
- golden：新增 m_inventory / m_inventory_check / m_finance 三屏×三主题
  （390×844@2x）；重生成既有 inventory_list_mobile / finance_mobile 基准
  （桌面 golden 零改动）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 12:18:17 +08:00
wangjia ff7b4194ec feat(client): 出入库列表窄屏对齐移动原型（KPI 筛选/搜索行/状态与详搜 sheet/图标徽章） 
- 窄屏隐藏页内大标题头与新增/导出/打印入口（移动端无建单与打印——拍板）
- KPI 改 MKpiGrid 2×2：待审核/草稿卡可点切换状态筛选（再点取消，selected 联动）
- 工具栏改 MSearchRow：搜索（provider 内置防抖）+ 纯文字状态钮 + 图标详搜钮
- 状态筛选/详细搜索改 showMSheet 底部 sheet（详搜字段与桌面完全同集，重置/应用在 actions）
- 卡片流徽章换图标变体（含派生态待定价/部分退单/已退单）+ › 箭头，行内操作收进详情 sheet
- 确认进价/确认售价窄屏走 showMSheet；窄屏详情操作组不出打印
- 新增 390×844 三主题 golden（m_stock_in_list/m_stock_out_list）；重生成既有 390×1300 移动 golden 基准（桌面 golden 零漂移）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 12:17:31 +08:00
wangjia 4287f5a876 feat(client): 往来/基础数据/商品详情窄屏对齐移动原型（卡片流/图标徽章/sheet 表单） 
- 往来单位：窄屏隐藏页内大标题（标题在壳顶栏）；MSearchRow 搜索行；
  类型 pills 全部/供应商/客户/两者（两者=客户端过滤，服务端 FIND_IN_SET 无独立值）；
  卡片流类型+状态徽章换图标变体、mc-sub mono 编码
- 基础数据：窄屏隐藏大标题；各 tab 搜索行换 MSearchRow（清空 × 并入，重置钮撤）；
  档案/字典卡片副行 mono 编码；系列/规格/仓库 新增编辑窄屏走 showMSheet 底部 sheet 轻表单
- 商品详情：窄屏 padding 收紧 sp4；信息卡 Wrap→单列；图片缩略图行窄屏横滚防溢出；
  二维码弹窗宽度走 context.dialogWidth
- golden：新增 m_partners / m_products / m_products_series（390×844 @2x 三主题）；
  重生成既有 partners_mobile / products_archive_mobile 基准（桌面 golden 零漂移）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 12:13:38 +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 f3cfdcadca feat: 购买下单透传终端类型，手机端收银台拉起支付宝 App（契约 v1.1.0） 
根因：pay 判手机/PC 用下单请求 UA，而下单由 jiu 后端 Go client 发出，
恒被判 PC 扫码页——手机用户拿不到 wap 拉起页。

- backend：/license/purchase 请求体加可选 client_type（oneof=pc mobile），
  缺省按本请求 UA 兜底（官网浏览器购买自动受益）；CreatePurchase 透传给 pay；
  单测断言透传 + 既有用例补参
- client：createPurchase 支持 clientType；PurchaseCard 按平台声明
  （iOS/Android=mobile，桌面=pc，Web 不传走 UA），kIsWeb 先于 dart:io；
  launchUrl 外部浏览器不变，wap 收银台自动拉起支付宝
- 配套：pay-contract v1.1.0（744725b）+ pay 侧 resolveIsMobile（dbdadd1）已各自提交

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
 2026-07-04 10:31:49 +08:00
wangjia 24afb3b5fd refactor(client): 授权信息卡从「关于我们」迁至 设置→授权管理，替换授权到期时间卡 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
 2026-07-03 23:57:17 +08:00
wangjia cd6621d733 feat(client): 购买卡年付明示省 2 个月（tab 标注+划线原价+省钱说明行） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
 2026-07-03 23:50:20 +08:00
wangjia c3455ce7a7 feat(client): 授权管理拆四卡，首月特惠默认选中，关于页备案号加链接 
- 授权管理面板拆四张卡：授权到期时间 / 在线购买续费 / 兑换券 / 到期降级规则；
  非管理员在购买卡位显示「联系管理员 + 查看套餐价格」引导
- 购买卡套餐 tab 首月特惠放第一位并默认选中；已享受过特惠则默认高级版年付
- 关于页页脚备案号可点击跳转工信部备案查询

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
 2026-07-03 23:46:40 +08:00
wangjia 2a5fea2647 fix(client): 关于页版本号不再显示 build 号，页脚版权加 ICP 备案号 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
 2026-07-03 23:39:18 +08:00
wangjia 02db118f61 feat(client): 在线购买改为设置页内联卡片，左侧菜单改「授权管理」 
- purchase_dialog.dart → purchase_card.dart：弹窗改 PurchaseCard 内联卡片，
  三阶段（选套餐/待支付/成功）操作按钮改卡片内右对齐，新增「重新选择」回退
- 设置授权面板拆两张卡：授权管理（到期统计+兑换券+降级说明）+
  在线购买/续费（仅管理员可见，PurchaseCard 内联）
- 移除统计条与移动端的弹窗入口按钮

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
 2026-07-03 23:39:12 +08:00
wangjia 15ed05dc1e feat(client): 设置授权卡重排——在线购买/续费升为主 CTA 
卡片改名「授权管理」，购买按钮升 primary 并排进到期统计条（窄屏通栏在统计条下方），
不再藏在「没有兑换券？」后面；兑换券降为次要入口；非管理员显示联系管理员+官网价格链接。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
 2026-07-03 23:21:34 +08:00
wangjia b3c9d98eae feat: ¥1 首月特惠套餐（新店专享，每店限购一次，官网+App 同步上线） 
- 后端：payPlans 新增 promo_first_month（¥1/30 天/标准版权益）；下单强校验每店限购一次（仅 paid 计数，弃单可重下），已享用返回 409；新增 GET /license/promo-status 供前端置灰
- 官网：checkout 套餐段第二位插「🔥 首月特惠 ¥1」+ 推广横幅 + 划线原价 ¥299；首页价格区第二位插特惠卡（5 列）；已享用自动置灰
- App：购买弹窗套餐段改三档（标准/特惠/高级），特惠选中显示推广横幅与划线价，已享用置灰并禁用提交
- 实付金额以 pay 侧为准，pay 需 seed promo_first_month 产品后生效

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
 2026-07-03 22:25:07 +08:00
wangjia 24123eb93c feat(client): App 内在线购买/续费授权（管理员支付宝下单+到账轮询） 
- 新增套餐目录 license_plans.dart（标准/高级 × 月付/年付，与官网 checkout 一致）
- license 模型/仓库新增 PurchaseOrder/PurchaseStatusInfo 与下单、查单接口
- 系统设置授权面板：管理员显示「在线购买 / 续费」按钮，弹窗选套餐→
  外部浏览器打开支付宝收银台→3s 轮询到账→自动刷新授权并展示新到期日
- 用户手册（docs.md + user-manual.html）同步补充在线购买入口说明

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
 2026-07-03 21:57:03 +08:00
wangjia 2bf5b98ba2 feat(client): 草稿 KPI 卡（暗黄）+ 出库详情总售价列 + 明细去¥缩号 + 建单默认值 + 若干列名 
- 出入库列表加草稿 KPI 卡（DsKpiTone.warn 新档，审核卡后，点击筛选草稿）
- 出库详情 7 列：售价后加总售价；明细行内价格去 ¥ 且缩一号（合计保留 ¥）；
  5/7 列宽重排（系列/数量左移、进价（单瓶）不折行）
- 出库建单：数量默认=可用数量、售价默认=参考售价（product.sale_price）
- 入库详情列名：进价（单瓶）/总价；库存列表「单价」→「总价」（库存×成本）；
  商品抽屉：成本价（单瓶）/总成本价
- 公开商品预览页加返回按钮（仅 App 内 canPop 时显示，扫码直达保持纯净）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
 2026-07-03 14:31:50 +08:00
wangjia 979ca3c83b feat(client): 出库明细成本/售价/利润三列重设计 + 建单利润列 + 入库列头统一 
- 出库详情抽屉（管理员）：数量/成本价/售价/利润 + 合计金额/合计利润 双行；
  operator 见 售价/小计（服务端抹零+前端隐藏双保险）；利润负数 danger
- 出库建单：商品名称下带编码（字体同系列列）；金额列→利润列（实时）；
  底栏合计利润（仅管理员）；进价列仅管理员；提交发新 key（cost_price/sale_price）
- 入库建单列头：进价（单瓶）/ 参考售价 / 总进价
- 退单弹窗金额改售价口径（与冲应收一致）；打印保留待定价回退成本兼容
- models 字段随后端消歧改名；golden 重打；新增抽屉双形态 widget 测试

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
 2026-07-03 12:44:22 +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 9099c4af99 feat(backend): 出入库编码搜索双路匹配+建单填快照；finance 趋势/日期区间；partner/product 拼音搜索 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
 2026-07-02 22:27:13 +08:00
wangjia a3a722689e feat(client): 出入库列表按原型重建（KPI/详情抽屉/详细搜索/工具栏/选中复制/窗口尺寸） 
- 列表重建：KPI 卡、状态+时间列、操作改眼睛开右侧详情抽屉、重置右置
- 详情抽屉(order_detail_drawer) 100% 还原原型 + SelectionArea 可选中复制
- 详细搜索弹窗：ComboSearchField/滚轮日期、字段重构、白底盒子按钮
- 工具栏：搜索框×清除+占位精简、供应商/客户下拉取全部、状态菜单收窄
- 加载不白屏(半透明遮罩)、输入框与下拉等高、windows/macOS 默认窗口尺寸调大

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-02 08:48:01 +08:00
wangjia 2c2bb7ccb3 fix(client): rebase 到 main 后适配打印线与 token 体系 
main 的打印代码引用了分支已删除的 AppTheme（app_theme.dart）。按「冲突以 main 逻辑为准」
保留 main 的打印预览流程，把三处 AppTheme.* 颜色迁移到分支 token 体系：
- stock_in/out_list 单据详情顶栏：brand50/border/primaryDark → context.tokens.*
- order_print_preview_dialog：import 换 context_tokens，primary/textSecondary → tokens.primary/muted
form 屏改用 main 的 showStock{In,Out}OrderPrint 打印预览入口，随之刷新 12 张 form golden 基线。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-01 20:54:54 +08:00
wangjia 8a8043573c refactor(client): 库存屏移除预警/流水死 tab 及关联死代码 
build() 只渲染库存视图（预警并入 KPI 缺货卡点击筛选、流水移到商品详情），
_buildWarningTab/_buildLogTab/_warningCard/_logCard/_DirectionBadge 已成死代码，
连同未用的 data_table_card/tab_state_provider/page_scaffold import 一并移除（约 -290 行）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-01 20:46:53 +08:00
wangjia ce18ed3fc9 fix(client): 状态下拉对照原型 .menu（白底圆角 + 选中蓝勾蓝字） 
实现原是 Material 默认下拉（灰底 + 灰高亮块），改为对照原型 .menu/.menu-item：
白底圆角描边、选中项 lucide check 蓝勾 + 蓝字 fw600、去掉 initialValue 灰高亮。

注：此菜单样式多处复用（主题器/用户/列设置），下一步抽成 DsMenu 统一。

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 0f1a66f160 feat(client): KPI 图标改用 lucide（与原型同源图形库） 
原型图标源自 lucide-static（icons.js）。引入 lucide_icons_flutter 包，
库存屏 KPI 图标改 LucideIcons.box/database/box/triangleAlert，与原型一模一样
（不再用 Material 凑近似）。golden_harness 加载 Lucide package 字体（family 带
packages/ 前缀），golden 正确渲染。flutter test 242 通过。

后续：侧栏/顶栏/状态栏图标也逐步换 lucide（对照 shell.js）。

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 6d20359482 fix(client): 补提交 ds_table.dart（库存屏依赖）+ 库存移动端 golden 
ds_table.dart 在 ds 地基提交后新建、库存屏提交时漏 add，补回避免仓库缺文件。

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 348d118bb9 refactor(client): 库存屏改用 ds 组件库重写（屏内零内联样式） 
按「屏只组合组件、不写样式」用 widgets/ds/ 重写库存屏：
- KPI: KpiCard → DsKpi（4 卡，ic 右上 + mono 数字 + 缺货 accent）
- 表格: DataTableCard → DsTable（列头漏斗 header + 状态 DsBadge 圆点 + 库存 accent 染色 + 分页）
- 工具栏: TextField → DsSearchBox；状态内联 chip → DsChip；重置/导出 → DsButton
- _buildInventoryCell 改返回 Widget（供 DsRow.cells），状态走 _dsStatusBadge(DsBadge)
- 颜色全走 token（闸 0 违规），analyze 0 error，flutter test 242 通过

旧 DataTableCard/KpiCard/StatusPill 依赖仅剩未用的预警/流水 tab，下一步清理。

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 76f1b13eb4 feat(client): ds 组件库地基（镜像 atoms.css 原子，屏重写前置） 
按「先建单一组件源、屏只组合不重写样式」重立组件层：
- 新建 widgets/ds/：DsButton(.btn ghost/primary/danger/sm) · DsBadge(.badge+圆点) ·
  DsChip(.chip 状态筹码) · DsSearchBox(.searchbox) · DsKpi(.kpi 含 .ic 右上块+环比 .d)
- 每个组件一对一对照 atoms.css 尺寸/间距/圆角/字号，颜色/尺寸全引 token（0 硬编码，颜色闸过）
- 现有 KpiCard/StatusPill 等逐步迁入 ds/ 废弃

下一步：建 DsTable（表格+列头漏斗+分页+状态徽章用 DsBadge）→ 用 ds 组件重写库存屏。

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 dea46115cf fix(client): 真机字体改回系统默认(PingFang，对齐原型) + 原型去新增入库 
- themes.dart 不再全局强制 NotoSansSC：真机用系统字体(macOS/iOS=PingFang SC，
  与原型 --font 一致)，消除真机字体偏离原型；Noto 仅 golden 测试加载(CI 无中文字体)
- 原型 inventory.html 同步去掉「新增入库」按钮，与代码保持一致

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 8d3f902f3b feat(client): Phase 2 库存屏照原型重建（去tab/KPI货值/库存·成本价·单价列） 
照原型 inventory.html 把库存屏从「3 tab」重排为单视图：
- 去 3 tab（库存查询/预警/流水）→ 单视图；预警并入 KPI 缺货卡点击筛选；流水移商品详情
- 头部：库存管理 + 共 N 个 SKU·数据实时 + 列设置/导出（盘点/新增入库去掉，走专门菜单）
- KPI 4 卡走全店汇总接口：SKU总数/库存货值(Σqty×进价)/在库数量/缺货预警(可点筛选)
- 表格 12 列：加 库存(低库存染色)/成本价(进价)/单价(售价)；操作列只「查看详情」；状态圆点
- 仓库/备注默认隐藏；工具栏 搜索+状态筛选+重置
- 后端 GET /inventory/summary 全店汇总（守 shop_id）；前端 model/repository/provider 配套
- golden_harness：monospace 指向 Noto（消等宽数字黑块，全 golden 受益）；库存屏存量 grey 清零

后端编译/库存测试通过；前端 analyze 0 error，flutter test 242 通过；代码端颜色闸 0 违规。

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 ff45100eed feat(backend): 库存接口带出售价 sale_price（库存屏成本价/单价两列地基） 
照原型库存表「成本价(进价)+单价(售价)」两列：
- 库存查询 SELECT 加 p.sale_price AS sale_price；成本价 unit_price 补 p.purchase_price 兜底
- inventoryRow 加 SalePrice；前端 Inventory model 加 salePrice
- 多租户隔离不变（baseWhere 仍 inv.shop_id）；库存测试通过

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 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