jiu/CHANGELOG-client.md

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.1.4] - 2026-07-05

### 新功能
- 手机端全面改版：底部「库存 / 入库 / 出库 / 财务 / 我的」五个标签页替代抽屉菜单，
  「我的」汇总往来、基础数据、盘点、用户、授权、设备、设置、关于等入口。
- 手机端所有列表按移动风格重排：指标卡可点击筛选，卡片流带状态图标徽章，
  详情、筛选、表单全部改为底部弹层，单手操作更顺。
- 手机端横滑手势：首页左右滑切换标签页（带滑动动画），二级页面右滑返回，
  弹层打开时右滑关闭弹层。
- 所有列表支持下拉刷新。
- 库存商品编辑抽屉新增「打印标签」按钮，与入库管理打印标签一致。
- 从 App 内点击官网链接（如查看套餐价格）自动免登录，无需再输一遍账号密码。
- 手机购买套餐直接拉起支付宝 App 付款，不再停留在扫码页。

### 改进
- 日期选择全面统一：点开为扁平下拉面板（不再弹窗冻结页面），支持直接键入日期，
  也可三列滚轮选择；日期范围为起止双窗格并排，输入与滚轮双向联动。
- 抽屉内点击操作按钮后原地刷新，不再自动收起抽屉；仅点击抽屉外区域才关闭。
- 在线购买完成后套餐页默认停在「高级版·年付」。
- 关于页「检查更新」按钮与反馈按钮同规格对齐。

### 修复
- 手机端通知铃菜单不再悬空漂移，紧贴顶栏弹出。
- 本地测试构建的版本号显示不正确（含 iOS），并会误弹更新提示。

## [1.1.3] - 2026-07-04

### 新功能
- 授权管理页改版为四张卡片：授权信息（状态/到期日/剩余天数，自「关于我们」迁入）、
  在线购买/续费、兑换券、到期后降级规则，信息一目了然。
- 在线购买从弹窗改为设置页内嵌卡片，左侧菜单「授权兑换券」更名「授权管理」；
  首月特惠默认选中，已享受过特惠的门店自动切换到高级版年付。
- 年付优惠明示：套餐价格旁标注划线原价与「年付立省 X 元，相当于免费用 2 个月」。

### 改进
- 关于页页脚新增 ICP 备案号并可点击跳转工信部查询；版本号不再显示 build 号。

## [1.1.2] - 2026-07-03

### 新功能
- 系统设置 → 授权管理新增「在线购买 / 续费」：管理员可直接跳转支付宝付款，
  支付成功后自动到账续期（时长在现有到期时间上叠加）。
- 购买弹窗新增「🔥 首月特惠 ¥1」套餐（新店专享，30 天标准版全部功能，每店限购一次），
  已享受过的门店自动置灰。

## [1.1.1] - 2026-07-03

### 新功能
- 入库/出库管理各新增「草稿单数」卡片（审核卡片之后，点击直接筛选草稿单）。
- 出库单详情明细在售价后新增「总售价」列。
- 新建出库单从库存选择商品后，数量自动填入可用数量、售价自动填入入库时的参考售价。
- 商品公开预览页支持返回（从 App 内进入时显示返回按钮）。

### 改进
- 出库/入库详情明细：行内价格去掉 ¥ 符号并缩小一号，不再折行拥挤；列宽重排。
- 入库明细列名更清晰：进价（单瓶）/ 总价；库存列表「单价」列改为「总价」（库存×成本）；
  商品编辑抽屉改为 成本价（单瓶）/ 总成本价。

## [1.1.0] - 2026-07-03

> 定价与利润模型里程碑版（内容与 1.0.88 相同，版本号升为 1.1.0，与 server-v1.1.0 配套）。

### 新功能
- 出库单详情全新明细：成本价、售价、利润三列一目了然，底部同时显示合计金额与合计利润（仅管理员可见成本与利润）。
- 新建出库单：明细行实时显示每行利润（原「金额」列升级），底栏新增合计利润；商品名称下方直接展示商品编码。

### 改进
- 入库单明细列头更清晰：进价（单瓶）、参考售价、总进价。
- 退单窗口金额改按售价显示，与应收冲账口径一致。

## [1.0.87] - 2026-07-03

### 新功能
- 登录、注册页全新改版：品牌面板 + 表单两栏布局，支持记住我（自动填入最近登录的门店和账号）、密码可见切换，右上角可直接切换主题。
- 入库 / 出库管理顶部统计卡数据补齐，支持「近 30 天」口径。
- 商品编辑中「从介绍库选择」升级为可搜索下拉，介绍条目多也能快速定位。
- 商品图片双击即可全屏查看。

### 改进
- 全局界面统一：弹窗按钮、下拉框、输入框、提示气泡（toast）、图标、等宽字体全部对齐设计规范，三套主题观感一致。
- 入库 / 出库列表版式与搜索框对齐设计稿，单号、金额、审核员列显示更清晰。
- 服务恢复域名访问（https://jiu.51yanmei.com），连接全程加密。

### 修复
- 只读模式下操作按钮不再可点，提示不再重复弹出。
- 往来单位表格错位、地址为空显示「-」的问题。
- 结清账款后财务页应收应付未即时刷新的问题。
- 供应商下拉搜索无结果时不再出现误导性的「新增」入口。
- 下拉菜单出现位置漂移的问题。

## [1.0.86] - 2026-06-27

### 修复
- 修复出库单 / 入库单打印时左侧竖线总是画满整页、与单据内容长度不一致的问题：现竖线随内容自动收缩，单据较短或跨页最后一页时只画到最后一行，不再多打一长截。

## [1.0.85] - 2026-06-27

### 改进
- 出库单 / 入库单打印改为针式打印机友好版式：全部纯黑、去除灰色底纹、表格改纯黑实线边框、字体加粗加大，针打输出更清晰、不再发淡发糊；同时优化列宽，避免单价 / 金额 / 日期等数字被换行截断。

## [1.0.84] - 2026-06-26

### 修复
- 修复出库单 / 入库单打印时，单据明细超过一页会导致程序卡死无响应的问题（新版打印版式引入的回归）。

## [1.0.83] - 2026-06-26

### 改进
- 出库单 / 入库单打印版式全面优化：公司抬头、批次号与生产日期、数字等宽对齐、单据总计独立高亮条，整体更紧凑规整，打印更清晰。

### 修复
- 修正出库单打印的「单价 / 金额」：现按售价显示（金额 = 售价 × 数量），不再误用成本价；历史单据自动兼容。

## [1.0.82] - 2026-06-26

### 新功能
- 出库单 / 入库单打印新增「打印预览」：点击打印先弹出整页预览（所见即所得），确认无误后再调用系统打印，解决部分 Windows 电脑打印对话框无法预览的问题。

## [1.0.81] - 2026-06-24

### 改进
- 出库 / 入库单详情全屏弹窗只覆盖内容区，不再遮挡左侧菜单栏、顶栏与状态栏。
- 出库 / 入库单详情标题栏改为浅色配色（浅蓝底 + 深色文字），观感更清爽。

## [1.0.80] - 2026-06-24

### 新功能
- 出库单详情新增「售价」与「利润」列，利润 = 售价 − 成本，一眼看清每笔出库的盈亏。

### 改进
- 出库 / 入库单详情改为全屏展示，内容更大更清晰，左上角返回箭头关闭。
- 出库单详情自动带出商品的生产日期与批次号（明细未单独填写时回退商品资料），去掉冗余的「数量」列。

## [1.0.79] - 2026-06-24

### 改进
- 入库单 / 出库单搜索框升级：搜索后关键词以标签形式显示在搜索框内，带一键清除（✕）按钮，输入框自动清空便于继续输入；当前仅支持单个搜索词。

## [1.0.78] - 2026-06-24

### 改进
- 维护性发布：发布与部署流程修复，应用功能无变更。

## [1.0.77] - 2026-06-24

### 新功能
- 入库 / 出库列表的搜索框支持按「酒名（商品名）」搜索（支持汉字、全拼、首字母），输入时带防抖限流，输入更顺畅。

### 改进
- 入库录入单价允许留空或填 0（待定价）：不再强制单价大于 0，便于先入库、后用「确认进价」补填真实进价。

## [1.0.76] - 2026-06-23

### 新功能
- 商品详情页：双击商品图片即可全屏查看，支持双指缩放、左右翻页
- 入库单详情新增「确认进价」：先以 0 价（待定）入库的调货单据，价格确定后可补填真实进价，系统自动回填库存成本、已出库成本与对供应商的应付，售价/应收不受影响；库存与入库明细中未定价的商品显示「待定价」

## [1.0.75] - 2026-06-22

### 新功能
- 出库单列表新增「商品编码」搜索框：输入完整商品编码回车，即可精确查出包含该商品的所有出库单（与原「单号/往来单位」搜索互不影响）

### 变更
- 移除「系统设置 → 数据管理」里的数据导入入口：数据导入不再对用户开放

## [1.0.74] - 2026-06-22

### 改进
- 入库单 / 出库单详情页的商品明细表新增「生产日期」「批次号」两列，便于核对货品批次信息

## [1.0.73] - 2026-06-22

### 改进
- 出库「添加商品」选货弹窗改为分页加载：默认显示前 20 条，底部显示库存总数并支持上一页/下一页翻页；弹窗打开即加载、按编码/名称/系列搜索时即时分页，避免一次拉取过多导致加载缓慢或看不到商品

## [1.0.72] - 2026-06-22

### 新功能
- 出库单录入新增「售价」可编辑列：可按实际销售价录入，金额与单据应收按「售价 × 数量」实时计算，同时保留成本价一栏便于对比

### 改进
- 「退单」按钮改为红色实心样式，更醒目地突出该危险操作（与原型一致）
- 库存列表隐藏「库存量」列：序列号模型下每件商品独立，原数量列易受历史数据误导，故不再展示（缺货/预警逻辑不受影响）
- 出库「添加商品」可一次看到整仓商品（需配合后端 v1.0.75）

## [1.0.71] - 2026-06-21

### 新功能
- 已审核单据「退单」：入库/出库列表点红色「退单」→ 弹出退单明细窗，可逐行退或一键「全部退单」，确认框显示名称/系列/规格；已退明细以红色「已退单」醒目标注，列表状态旁显示「部分退单/已退单」徽章
- 数据导入页新增「入库单/出库单」导入（老系统单据打印格式，每个文件一张单）

## [1.0.70] - 2026-06-21

### 修复
- 修复超级管理员看不到「撤回」按钮的问题（此前仅 admin 角色显示，superadmin 被漏掉）
- 入库单批次号改为必填项，未填写会拦截提交

### 改进
- 「撤回」按钮：操作员现在也能撤回本人提交的审核中单据（管理员/超管仍可撤回任意单据）；按钮改用警示（amber）样式
- 新建入库单：生产日期列加宽，完整日期（如 2024-05-12）不再显示不全

## [1.0.69] - 2026-06-21

### 新功能
- 入库/出库审核列表：管理员可「撤回」审核中的单据，单据回到草稿，修改后重新提交审核

### 改进
- 新建入库单：批次号移到「生产日期」右侧、与各列对齐填写；生产日期输入框收窄，不再占用过宽

## [1.0.68] - 2026-06-21

### 改进
- 店铺公开商品页：每个商品卡片显示「在库 N」数量，且只展示有货商品

## [1.0.67] - 2026-06-21

### 改进
- 选择器改为服务端全量搜索：选供应商/客户时按关键词查全部往来单位（不再只在已加载的首页里找）；出库「选择商品」弹窗的搜索也改为实时查全部库存，输入即按编码/名称/系列匹配，不再漏掉未加载的商品

## [1.0.66] - 2026-06-21

### 改进
- 入库/出库列表「日期」列改名为「入库时间/出库时间」，移除恒为空的旧「审核时间」列
- 日期选择改为可直接键入的输入框 + 日历图标：能直接打年份（选老年份方便），支持只填到年或年月（自动补为月初）

## [1.0.65] - 2026-06-21

### 改进
- 入库录入改为「每行一个独立产品」：每条明细对应一个独立编号，同名同规格录多次也各自独立（配合后端 server-v1.0.69）

## [1.0.64] - 2026-06-20

### 新功能
- 入库单 / 出库单列表新增搜索框：输入单号或往来单位名称即可即时筛选，不用再翻页查找
- 入库 / 出库 / 库存三个列表均新增刷新按钮：多端并发录入后可一键同步最新数据

## [1.0.63] - 2026-06-20

### 修复
- 修复入库单 / 出库单「全部状态」筛选遗漏未审核单据的问题，状态下拉新增「待审核」选项，且筛选真正生效
- 修复「入库审核 / 出库审核」标签页只显示部分待审核单、漏掉早期单号的问题：筛选改为服务端驱动，跨分页结果完整可靠

## [1.0.62] - 2026-06-20

### 改进
- 入库单、出库单的仓库、供应商、客户下拉框改为可搜索：点击后弹出搜索框，支持按名称、拼音首字母或编码快速筛选，选项多时无需再逐条翻找

### 修复
- 修复账号在别处登录或被管理员强制下线后、退回登录页却没有任何提示的问题，现在会弹窗明确告知「登录已失效」

## [1.0.61] - 2026-06-20

### 改进
- 全平台应用名统一为「岩美酒库」：macOS 此前窗口标题与应用名显示为 jiu_client，现与各端一致
- 应用图标更新为最新品牌图标，覆盖 Windows 桌面 / 任务栏 / 标题栏 / 快捷方式及 macOS、iOS、Android、网页各端

### 修复
- 修复设备管理中 Windows 设备「平台」显示为「未知 桌面端」的问题，更新本版本并重新登录后正确显示为 Windows

## [1.0.60] - 2026-06-20

### 新功能
- 入库/出库录单新增日期选择器，单据日期、生产日期等可直接点选，无需手动输入

### 改进
- 录单表单的商品、往来单位等可搜索下拉支持边搜边选，找不到时可内联新建选项，录单更顺手
- 从旧系统迁入的历史进销存单据，明细可正常展示商品编号、名称、系列、规格等信息

## [1.0.59] - 2026-06-19

### 新功能
- 授权到期后可在界面内直接续费：输入兑换码（形如 JIUKU-XXXX-XXXX）即可为门店叠加授权时长

### 改进
- 品牌焕新：登录页启用「岩美酒库」品牌标识，桌面 / 移动 / 网页各端应用图标统一为品牌图标
- 「激活授权」改为「兑换激活码」语义，文案与提示更贴合按时长续期的使用方式
- 授权状态实时生效：续费、到期或授权被调整后无需重新登录即可刷新；账号被停用或在其他设备登录时及时自动退出
- 「退出登录」收入右上角用户名下拉菜单，界面更聚焦

## [1.0.58] - 2026-06-18

### 修复
- 恢复 Windows 桌面版的自动构建与发布：上一版因构建环境问题未能产出 Windows 安装包，本版已修复，Windows 用户可正常下载安装

## [1.0.57] - 2026-06-17

### 新功能
- 新增「设备 / 状态管理」页面：可查看本店当前在线的设备与登录会话（用户、平台、登录时间、最近活跃、在线状态）；管理员/超级管理员可一键将指定设备强制下线

### 改进
- 顶栏精简，不再显示门店号；用户名移到左侧导航栏底部，点击可查看门店 / 账号 / 版本信息
- 账号在其他设备登录或会话失效时，自动退出并给出明确提示

## [1.0.56] - 2026-06-17

### 新功能
- 库存查询在手机上支持「表格 / 列表」两种视图，可一键切换
- 入库单、出库单、库存、财务的「显示字段」选择会被记住，下次进入自动保持

### 改进
- 库存查询搜索框移到工具栏最前，查找更顺手
- 手机端列表页工具栏重新排布，按钮不再拥挤
- 「退出登录」统一收到左侧导航栏，界面更清爽
- macOS 安装包已签名并通过 Apple 公证，安装与自动更新不再弹安全警告

### 修复
- 修复入库单 / 出库单「显示字段」勾选后部分列仍不显示的问题

## [1.0.55] - 2026-06-17

### 改进
- 客户端启用独立发版流水线（`client-v*`），版本迭代与官网、后端解耦，更新推送更及时

## [1.0.54] - 2026-06-17

### 新功能
- 只读账号自动隐藏所有写操作按钮（新增/编辑/删除/审核/提交/结清/导入等），顶栏显示「只读」标识，权限一目了然
- 左侧抽屉和系统设置页新增「退出登录」入口，窄屏也能方便退出
- 酒行信息新增「微信号」显示

### 改进
- 网络请求失败时自动重试（间隔递增），离线时提供带状态反馈的「重试」按钮
- iOS 顶栏避开状态栏，菜单按钮不再被时间/信号遮挡

### 修复
- 库存导入改用 Excel 中的「入库日期」作为入库时间（不再统一记为导入当天）；相同数据重复导入时自动跳过，仅更新有变化的字段，避免重复与误覆盖
- 修复 iOS 上顶栏被状态栏遮挡导致无法打开菜单/退出登录的问题

## [1.0.53] - 2026-06-15

### 修复
- 修复 Windows 上点击打印无反应的问题（GBK 编码改为直接调用系统 API，不再依赖第三方插件）

## [1.0.52] - 2026-06-15

### 改进
- 热敏标签打印改用打印机内置中文点阵字体（TSS24.BF2/TSS16.BF2），文字清晰度大幅提升，彻底解决 203 DPI 下字体模糊问题

## [1.0.51] - 2026-06-15

### 改进
- 标签打印字体细化：阈值调回 128，店名改细体，商品名保持粗体

## [1.0.50] - 2026-06-15

### 改进
- 标签打印字体更清晰：采用 2× 超采样渲染，消除热敏打印时反锯齿导致的模糊笔划

## [1.0.49] - 2026-06-15

### 改进
- 二维码链接统一使用 `/app/product/` 路径，扫码后 URL 不再跳变，分享与打开同一个链接

## [1.0.48] - 2026-06-15

### 修复
- 修复分享 `/app/product/` 路径时微信爬虫拿不到 OG 标签的问题（nginx 补充该路径的代理规则）
- 分享卡片描述规格/系列与门店名分两行显示

## [1.0.47] - 2026-06-15

### 修复
- 微信分享卡片描述补充度数/系列信息，不再只显示规格

## [1.0.46] - 2026-06-15

### 修复
- 微信内打开商品页时顶部标题栏显示商品名称，不再显示"岩美"

## [1.0.45] - 2026-06-15

### 修复
- 修复微信分享卡片标题仍显示"岩美"的问题（HTML 缩进导致字符串匹配失败）
- 微信分享卡片描述去掉"扫码验真"后缀

## [1.0.44] - 2026-06-15

### 改进
- 微信分享卡片标题改为商品名称（之前仍显示"岩美"）
- 微信分享卡片描述去掉"扫码验真"后缀

## [1.0.43] - 2026-06-15

### 修复
- 修复微信/飞书分享商品链接时卡片只显示"岩美"而不显示商品名称和图片的问题

## [1.0.42] - 2026-06-15

### 修复
- 修复商品二维码扫码页报"index.html not found"的错误

## [1.0.41] - 2026-06-15

### 改进
- 标签打印布局优化：编号字体与度数/日期统一大小，内容整体下移并填满标签底部，店名适当放大
- 标签度数与规格之间加宽间距，两个字段更易区分

## [1.0.40] - 2026-06-15

### 新功能
- 商品标签打印新增编号行（显示「编号：xxxx」），位于度数上方，方便核对入库单
- 扫码分享商品链接时，微信/企业微信/飞书/钉钉等平台的分享卡片现可显示商品名、规格描述及商品图片，不再只显示「岩美」

### 改进
- 库存页表格支持横向滚动，列过多时不再截断；支持显示/隐藏列，按需定制显示内容

## [1.0.39] - 2026-06-15

### 修复
- 打印预览弹窗：打印完成后自动关闭
- 打印预览弹窗：打印机列表改为仅显示热敏打印机，无热敏打印机时显示"无打印机可用"并禁用打印按钮
- 库存列表表格行"打标签"按钮点击无反应
- Windows/macOS 单实例限制：同一台电脑不允许重复打开多个客户端窗口

## [1.0.38] - 2026-06-15

### 新功能
- 标签打印新增「打印预览」弹窗，点击打印按钮后可先预览标签内容再确认打印
- 预览弹窗支持选择打印机（下拉列表），并记住上次选择，下次自动默认
- 支持对每张标签单独设置打印份数（默认 1 份）
- 入库单「打标签」支持多张预览：左侧缩略图条可逐张勾选/取消，右侧显示当前选中张的大图

## [1.0.37] - 2026-06-15

### 新功能
- 库存查询新增「规格」和「系列」筛选，支持多选，按服务端过滤全量数据
- 库存查询新增「入库时间」列
- 入库单商品明细将「生产日期」移至主行直接可见，无需展开隐藏区域

### 改进
- 筛选弹窗重构：顶部搜索框实时过滤、选项列表可滚动、已选项以标签形式置顶显示并可单独取消
- 筛选图标改为常驻显示，无需鼠标悬停

### 修复
- 修复商品系列批量导入被截断至 100 条的问题

## [1.0.36] - 2026-06-13

### 修复
- 修复数据库初始化时 license_key 索引超长导致启动失败的问题

## [1.0.35] - 2026-06-12

### 改进
- Debug 版本窗口标题增加 [DEBUG] 后缀，便于与正式安装版区分

## [1.0.34] - 2026-06-12

### 修复
- 修复 macOS 客户端打印时应用卡死、只能强制退出的问题

### 改进
- 「关于我们」中「打开文档」「更新日志」等链接指向新域名 jiu.51yanmei.com

## [1.0.33] - 2026-06-12

### 改进
- macOS 客户端插件集成从 CocoaPods 迁移至 Swift Package Manager，优化 macOS 构建流程

## [1.0.32] - 2026-06-11

### 修复
- 修复库存可用量检查在数据库查询失败时误报所有商品库存不足的问题
- 修复授权信息页面设备数量统计不准确的问题
- 修复对账接口在数据库查询出错时静默返回空结果、掩盖异常的问题
- 修复 license 验证缺少门店隔离过滤，提升多租户安全性
- 官网联系入口调整为微信咨询（填写微信号后自动生效），隐藏尚未申请的备案号
- 修复各接口分页大小未设上限，防止超大请求拖慢服务

### 改进
- 后端启动不再执行拼音回填，已改为独立工具（`cmd/backfill-pinyin`），避免大库存量时延长启动时间
- 数据库连接池参数（最大空闲连接数、最大打开连接数）改为配置项，支持按环境调整

## [1.0.31] - 2026-06-10

### 修复
- 修复 Windows 客户端构建失败：授权到期横幅与弹窗方法位置错误导致编译报错

## [1.0.30] - 2026-06-10

### 新功能
- 官网新增更新日志页（/changelog/）、服务条款页（/terms/）、隐私政策页（/privacy/），全站页脚同步补充链接
- 授权信息功能：新账号注册自动获得 30 天试用期；设置页「授权」Tab 支持粘贴授权码激活；到期后按宽限期 → 只读 → 锁定三阶段降级，前端对应横幅与弹窗提示
- 商品详情页展示所有字段，包括分类、库存预警线、备注、自定义字段、描述文档

### 改进
- 关于我们页「更新日志」按钮现在链接到 /changelog/ 版本历史页

### 修复
- 授权状态接口返回值补充 phase 字段，修复前端横幅与到期弹窗始终不显示的问题

## [1.0.29] - 2026-06-09

### 新功能
- Windows / macOS 桌面客户端现在限制只能运行一个实例；重复打开时弹窗提示「程序已在运行中」并自动退出

## [1.0.28] - 2026-06-09

### 修复
- macOS 客户端打包脚本路径错误导致 CI 打包失败，修正后 macOS 安装包可正常构建并发布

## [1.0.27] - 2026-06-09

### 改进
- 入库单新建表单：产地、保质期、储存方式、批次号、生产日期等选填字段默认折叠，点击「展开选填」按钮后在行内下方显示，减少初始界面信息量
- 手机端现可从屏幕左边缘向右滑动打开导航菜单，无需点击汉堡图标
- 入库单详情弹窗在手机上商品明细改为卡片式竖排布局，不再显示难以阅读的横向宽表格

### 修复
- macOS 客户端下载 zip 解压失败：打包改用 ditto，正确保留 symlink 和执行权限

## [1.0.26] - 2026-06-08

### 新功能
- 公开商品 API 新增商品编码、条码、当前库存数量字段，供扫码页及第三方集成使用
- 公开页「商品报错」「意见反馈」提交时自动携带门店编号和商品信息，方便运营追踪

### 修复
- 注册页 API 地址改为配置文件驱动，支持分离部署场景（不再依赖 window.location.origin）
- 注册成功提示的客户端导航路径由「系统设置 → 关于」修正为「系统设置」
- 公开页页脚「关于岩美」链接改为配置项，不再硬编码

## [1.0.25] - 2026-06-08

### 新功能
- 基础数据页新增「产地」「保质期」「储存方式」「描述文档」4 个字典维护 Tab，可直接在基础数据中增删改查
- 商品详情页展示产地、保质期、储存方式参数，并在介绍区上方显示建议零售价
- 入库单详情中商品列展示产地、保质期、储存方式信息
- 公开扫码页新增「商品报错」「意见反馈」功能，用户可提交反馈

## [1.0.24] - 2026-06-08

### 新功能
- 扫码商品页新增「查看本店其他商品」功能，点击即可浏览该门店全部上架商品
- 门店可在设置中填写微信号，顾客扫码后可直接查看并添加门店微信
- 商品公开页展示建议零售价（有填写时显示）
- 入库时可为商品关联产地、保质期、储存方式、描述文档，关联后扫码页自动呈现真实信息
- 扫码商品页产地、保质期、储存方式、商品介绍改读数据库真实数据，不再显示占位内容

### 改进
- 新增产地/保质期/储存方式/描述文档四类基础数据字典，支持增删改查，可在入库时按需关联商品

## [1.0.23] - 2026-06-07

### 修复
- 官网功能详情页（库存管理/审核流）导航栏现与主站完全一致，不再缺少「库存」「审核流」入口

### 改进
- 官网功能详情页接入统一模板系统，导航/页脚/版权信息改一处自动同步全站

## [1.0.22] - 2026-06-07

### 新功能
- 官网移动端适配：手机浏览器下导航折叠、首页各区块单列排版、features 详情页和页脚自适应窄屏

### 改进
- 客户端移动端布局优化：入库/出库详情页商品明细改为卡片式竖排，操作按钮收纳至溢出菜单，窄屏不再横向溢出
- 信息架构整理：仓库管理移入基础数据，系统设置新增授权 Tab 和数据管理组，关于我们补充帮助文档/法律信息/系统信息入口

### 修复
- 官网所有功能页死链修正（`/download.html` → `/download/`，`/docs.html` → `/docs/`）
- 官网删除未实现功能的虚假宣传（红冲、调拨单、库存推送通知、过期预警等），文案与实际功能对齐
- 官网客服邮箱更新为真实邮箱，移除假冒客服电话，页脚清除无目标死链
- 导航新增「库存」「审核流」功能页入口，首页模块卡加「了解更多」链接
- 下载页接口失败时按钮改为禁用态并提示，不再无响应
- 首页 iOS 平台说明改为「TestFlight 内测中」，与下载页状态一致

## [1.0.21] - 2026-06-07

### 新功能
- 商品详情页添加照片时，手机端（Android/iOS）支持直接拍照或从相册选择

## [1.0.20] - 2026-06-07

### 修复
- 修复 Android 客户端登录页提示「服务不可达」、无法连接服务器的问题（正式版安装包此前缺少联网权限）

## [1.0.19] - 2026-06-07

### 改进
- 优化 Android 构建与部署流程（CI/CD 内部调整），功能与界面无变化

## [1.0.18] - 2026-06-06

### 新功能
- 移动端（Android）界面适配：窄屏（手机）自动切换为移动布局——侧边栏改为侧滑抽屉导航，各列表（库存/出入库/财务/往来单位/基础数据）由宽表格自动切换为卡片流，弹窗与表单自适应屏宽不再溢出；宽屏（桌面/Web）布局保持不变
- Android 客户端正式上线：CI/CD 新增 Android APK 构建（正式 release 签名、versionCode 单调递增），随发版自动发布到下载页；下载页 Android 卡片已激活

### 改进
- 表单字段在手机上占满整行，便于点选；底部状态栏在手机端隐藏

## [1.0.17] - 2026-06-05

### 新功能
- 意见反馈（Bug 反馈 / 功能建议）改为应用内直接提交，支持文字 + 图片（最多 9 张），不再跳转邮件

### 改进
- 「关于」更名为「关于我们」并移至左侧菜单，成为独立页面
- 打印时默认文件名带类型与时间戳（如 标签_20260605_103000、入库单_…、出库单_…），方便「打印到 PDF」保存归档

## [1.0.16] - 2026-06-05

### 新功能
- 应用内更新：Windows/macOS 点「立即更新」直接在应用内下载并自动安装/重启（带进度条），规避浏览器 SmartScreen 下载拦截；Web 为刷新页面
- Windows 安装程序改为中文向导

### 改进
- 「检查更新」按钮增加反馈提示（正在检查 / 已是最新 / 发现新版本 / 检查失败）
- 更新提示文案优化：横幅显示「建议立即更新以获得最新功能与修复」，不再展示冗长更新内容

## [1.0.15] - 2026-06-05

### 修复
- 修复 Windows 桌面端打印卡死：打印字体由 OpenType/CFF 改为 TrueType(glyf)，dart_pdf 渲染中文不再抛错（此前点「打印」后卡死）

### 改进
- 「关于我们」内容改为真实信息（服务商：岩美技术有限公司；网站：jiu.yanmei.com；邮箱：yammy2023@163.com），且统一从配置文件读取，不再硬编码
- Windows 桌面端窗口标题由 jiu_client 改为「岩美酒库」

## [1.0.13] - 2026-06-04

### 新功能
- Windows 客户端改为提供安装程序（Inno Setup 打包的 `jiu-windows-x64-setup.exe`，含安装向导、桌面/开始菜单快捷方式、卸载项），不再是解压版 zip

### 修复
- 修复客户端「无法安全下载」：下载地址从内网 HTTP Forgejo（`http://192.168.3.200:3000`，公网不可达且被浏览器拦截）改为同源 HTTPS `https://jiu.51yanmei.com/downloads/...`，Windows、macOS 均生效
- 部署时将最新安装包发布到 web 服务（`/opt/jiu/downloads/`，nginx `/downloads/` 提供），仅保留最新版本（清旧放新）

## [1.0.9] - 2026-06-04

### 修复
- 适配 nginx 容器化部署：nginx 已迁入 `pangolin-edge` 容器（host 网络），deploy 改为将 jiu.conf 写入 pangolin 挂载目录并 `docker exec pangolin-edge nginx -s reload`，不再操作已废弃的主机 nginx

## [1.0.8] - 2026-06-03

### 修复
- 修复 EC2 部署最后一步 nginx reload 失败（`invalid PID number`）：改用 `systemctl reload-or-restart nginx`（经 systemd MAINPID 发 HUP，不依赖空的 /run/nginx.pid），并 `enable nginx` 确保重启后自启

## [1.0.7] - 2026-06-03

### 修复
- 修复 Windows 构建 `PathExistsException`（errno 183）：复制 client/ 到 C:\jiu-build 后，先清除 cp 复制成真实目录的插件软链（windows/flutter/ephemeral）及 .dart_tool/build，再交给 flutter 干净重建

## [1.0.6] - 2026-06-03

### 改进
- CI 运行环境自愈预置：mac/windows runner 首次构建自动 `flutter precache` 并预热 pub/go/npm 缓存（stamp 文件按 Flutter 版本短路），后续构建不再运行时下载 engine
- 发版流水线同一 mac runner 上的任务改为串行（build-macos 依赖 build-linux-web），避免排队等待超时失败
- 暂停定时数据库备份（保留手动触发）

## [1.0.5] - 2026-06-03

### 修复
- 修复 Windows CI 构建失败：放弃脆弱的 `subst W:` 路径映射，改为将 client/ 复制到 System32 之外的干净短路径（C:\jiu-build）构建，规避 WOW64 文件系统重定向

## [1.0.4] - 2026-05-30

### 新功能
- 支持 macOS 桌面客户端下载，下载页 macOS 卡片已激活，下载 zip 解压即用

## [1.0.3] - 2026-05-28

### 新功能
- 新增用户自助注册功能，在官网 /register/ 填写门店信息即可完成注册，系统自动生成门店编码（S000001 格式）
- 注册账号默认设为超级管理员权限
- 支持 Windows 桌面客户端构建与发布

### 修复
- 修复新门店首次登录时库存、仓库、用户等列表加载崩溃的问题
- 修复库存管理页在无数据时页面崩溃（RangeError）的问题
- 商品标签打印改为横向 38mm×20mm 布局，修复标签内容错位问题
- 修复数据导入中移除不必要的"商品编码"导入项

## [1.0.2] - 2026-05-25

### 修复
- 打印入库单/出库单/商品标签时，若浏览器拦截了弹窗，现在会给出明确提示，不再静默失败

## [1.0.1] - 2026-05-25

### 改进
- 库存搜索支持拼音和拼音首字母（例：搜"mt"或"maotai"可匹配"茅台"）
- 库存搜索改为回车/点击触发，减少无效请求
- 新增异常自动上报机制，线上错误可实时追踪

## [1.0.0] - 2026-05-24

初始版本发布，完成核心库存管理功能。

### 新功能
- 商品管理：多规格商品档案、图片、公开二维码扫码展示
- 库存管理：入库审核、出库审核、库存盘点、流水记录
- 财务管理：往来账目、对账单
- 用户权限：管理员 / 成员 / 只读三级权限控制
- 多租户隔离：门店数据完全独立
- Flutter Web 管理端（支持 PC 浏览器）
- 商品扫码公开展示页
- Excel 批量导入商品与库存