jiu/CHANGELOG-server.md

Changelog — Server（后端）

后端服务（backend/，jiu-server）的更新记录。tag 前缀 server-v*。

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.0.71] - 2026-06-21

改进

• 公开店铺商品页只展示「当前有库存」的商品，并返回每个商品的在库数量与商品编码（序列号），无货商品不再露出

[1.0.70] - 2026-06-21

改进

• 商品名称/系列/规格选择接口支持关键词搜索（按名称或编码），为客户端选择器的服务端全量搜索提供支撑

[1.0.69] - 2026-06-21

改进

• 入库录入改为「每行一个独立产品」：每条明细新建独立商品、发独立序列号（同名同规格录多次也各自独立），不再复用已有商品编号，符合"每个货品一个唯一编号"的管理方式

[1.0.68] - 2026-06-21

修复

• 根治商品编码可能重复的问题：自动编码改为按现有最大序号递增生成（不再复用已删除商品占用过的编号、并发下也不会撞号），并在数据库层为「同门店 + 编码」加唯一约束，从此重复编码无法静默产生

[1.0.67] - 2026-06-20

修复

• 历史导入单审核入库后，库存里商品显示为「历史导入占位」、按真实名搜不到的问题：审核生成库存时改用单据明细自带的真实商品名/编码/系列/规格，库存列表也不再显示已删除的占位商品名
• 库存列表按真实商品名/编码即可搜到这些历史商品

新功能

• 入库单 / 出库单列表支持关键词搜索：按单号或往来单位名称即时筛选

[1.0.66] - 2026-06-20

修复

• 入库/出库单据列表改为按业务日期（入库/出库日期）倒序排列：从旧系统迁入的历史单据按真实日期归位到列表顶部，不再因录入时间晚、被排到末尾分页而在首页遗漏

[1.0.65] - 2026-06-20

修复

• 单据列表状态筛选支持一次查询多种状态，配合客户端修复让「入库审核 / 出库审核」标签页完整列出全部待审核单据，不再因分页只显示部分

[1.0.64] - 2026-06-20

改进

• 登录设备并发限制改为「按账号统计全部平台合计」：同一账号在桌面、移动、Web 各端加起来最多同时在线 5 台设备（原先各平台分别计数）
• 达到设备上限时，新设备登录会被明确拒绝并提示「已达到登录设备上限，请提升额度或下线其他设备后重试」，不再静默把最早登录的设备顶下线——由用户自行决定下线哪台或提升额度

[1.0.63] - 2026-06-20

新功能

• 入库/出库单据明细新增商品快照字段（商品编号、名称、系列、规格，出库另含批次号、生产日期）与单据制单人记录，便于完整展示从旧系统迁入、无商品主数据关联的历史进销存单据

[1.0.62] - 2026-06-19

新功能

• 服务端新增多维限流防护：按客户端 IP、按门店分别限速，登录/注册/刷新令牌等敏感接口与公开查询接口各有独立速率上限，有效抵御恶意刷接口与流量冲击（DDoS），正常使用不受影响
• 登录暴力破解加固：除按账号锁定外，新增按来源 IP 的失败次数限制，单一 IP 连续撞库多个账号会被整体拦截

改进

• 在反向代理后正确识别真实客户端 IP，使限流与失败锁定按真实来源计数，避免误伤同一出口的正常用户
• 门店可保存录入默认值（默认系列/规格等）等轻量配置，刷新页面后依然保留

[1.0.61] - 2026-06-19

改进

• 平台侧兑换券生成工具随服务端一并发布并部署到服务器，可直接在服务器上批量生成激活码，无需每次本地编译上传；同步清理已退役的授权签名相关配置项

[1.0.60] - 2026-06-19

新功能

• 激活码升级为「时长兑换券」：每张码代表一段时长（如 +1 年 / +6 个月），兑换后叠加到当前授权之后，可购买多张累计续期；过期后兑换则从兑换当天重新起算
• 激活码改为简短易输入的形式（形如 JIUKU-XXXX-XXXX），告别此前需复制粘贴的超长字符串
• 同一张激活码只能被成功兑换一次，重复或无效的码会明确提示

改进

• 续费/兑换成功后授权状态即时刷新，无需退出重新登录
• 新门店首次使用仍自动获得 30 天试用，开箱即用

新功能

• 会话安全加固：刷新令牌每次续期自动轮换并具备盗用检测，旧令牌一旦被重放即吊销整条会话；新增失败登录记录便于审计风控

改进

• 授权状态实时生效：续费、到期或授权被调整后约 30 秒内即对写操作生效，无需退出重新登录
• 修改密码或停用账号后，该账号在所有设备上的登录会立即失效
• 自动清理超过保留期的已撤销/过期会话与失败登录记录，避免数据无限增长

修复

• 修复数据库瞬时异常时授权状态被误判为「无授权」、导致界面错误降级的问题

[1.0.58] - 2026-06-18

修复

• 修复已登录用户授权长期停留在「未激活」的问题：此前仅全新登录才会自动发放 30 天试用，靠本地令牌自动续登的老用户始终拿不到，现在续登时也会补发

[1.0.57] - 2026-06-18

新功能

• 未激活门店首次登录自动获得 30 天试用：此前手动建店或老数据无授权时既不提示也不限制，现在登录即开通试用，到期前会正常提醒并按阶段降级

[1.0.56] - 2026-06-17

新功能

• 在线设备/会话管理：服务端记录每次登录会话，支持查看本店在线设备、按平台类（桌面端 / 移动端 / 网页端）分别限制并发登录数，管理员可强制将指定设备下线
• 登录失败锁定：同一账号连续多次密码错误后自动锁定一段时间，防止暴力破解
• 记录账号最近登录时间

修复

• 修复被禁用账号仍能凭刷新令牌继续续期登录的安全漏洞：续期时校验账号状态与会话是否有效

[1.0.55] - 2026-06-17

新功能

• 后端服务独立发版流水线启用（server-v*），与客户端、官网互不影响

修复

• 库存导入改用更稳定的 Excel 解析库，按唯一编号自动去重，入库时间取自表格中的「入库日期」