AL1S WMS v0.0.4

Home Assistant

• Inventory attention and opened items now cover the entire selected household without choosing individual items. Existing numeric summary sensors remain available.
• The bundled dashboard view is now two separate cards: custom:al1s-inventory-attention-card and custom:al1s-opened-items-card. Each card displays its data table without a title or filter control.
• Inventory alert details now stay on one line: a replenishment suggestion when needed, or location and expiry date for an expiring item. Rows with no extra detail show --. Table headings align with their data.
• The integration registers the card module automatically for storage-mode dashboards. YAML dashboards need the module resource listed in the Home Assistant guide.
• The former custom:al1s-inventory-card type has been removed. Replace existing dashboard cards with either or both of the new types.
• If v0.0.4 was already installed, redownload it through HACS and restart Home Assistant to get these changes.

Validation

• Home Assistant card resource registration tests passed.
• Card rendering and alignment checked at a 320px viewport.

AL1S WMS v0.0.3 — Home Assistant integration

Home Assistant / HACS

• 新增只读 Home Assistant 集成，可绑定一个家庭，默认提供库存、补货、临期、过期、采购与使用中物资六个汇总传感器。
• 可按需关注物资，为选中的物资创建数量传感器；汇总属性提供补货、批次到期和开封明细。
• 支持通过 HACS 自定义存储库安装，并提供中英文原生仪表盘示例。本版本首次将 custom_components/al1s_wms 包含在正式 Release 中，修复 HACS 默认选中旧版时提示仓库结构不合规的问题。

库存与使用流程

• 支持部分入库、部分移动、跨地点开封，以及地点与分类盘点和可撤销的库存操作。
• 优化物资、批次、采购和财务页面，修复移动端日期输入、树形缩进及弹窗布局问题。
• 完善 MCP 工具注解，并继续强化库存、采购与权限相关测试。

安装与升级

HACS：把 https://github.com/RicterZ/AL1S-WMS 添加为 Integration 类型的自定义存储库，安装 v0.0.3，重启 Home Assistant，再到“设备与服务”添加 AL1S WMS。若此前选中过时的 v0.0.2，请在 HACS 中刷新仓库并改选 v0.0.3。

Docker：更新代码后运行 docker compose up -d --build。

完整更新记录：v0.0.2...v0.0.3

v0.0.2 — 库存成本与损耗分析（修复单位回填）

v0.0.2 重新发布

本版本已更新至 3667de0，修复物资编辑时的单位回填问题。此前 kg 等不在预设列表中的单位会错误显示为“个”，保存时可能触发 UNIT_HAS_HISTORY。现在编辑和采购表单均保留原始单位，不会因回填而误改单位。

• 成本缺失记录默认每页 9 条，可选 9 / 27 / 54，适配三列布局。
• 已下载旧版 v0.0.2 的用户请重新获取该版本；镜像用户需重新拉取 0.0.2 并重建容器。

本版本汇总 v0.0.1 之后的更新，重点重做库存成本与损耗分析，并完善采购入库和成本补录体验。

库存成本与损耗

• 用“入库批次去向”替换原库存价值模块，按入库月份追踪原始成本、已使用、浪费与剩余库存，支持按月、季、年汇总、时间范围、统计截止日期和百分比展示。
• 区分期间出库与批次累计成本，正确处理跨月、跨年使用和报废；使用占比以原始成本为分母。
• 浪费排行支持按物资、分类、地点查看，可展开批次成本明细。
• 调整成本不再独占主表列；有差异时显示可展开标记及图表图例。
• 新增独立的缺失成本模块，按批次去重，包含已耗尽的历史批次。直接在弹窗补录整批成本，支持零元成本、单价预览，保存后刷新财务数据；全部补齐后自动隐藏。
• 明确展示入库数量与剩余数量，并说明历史库存可能合并多次入库。

采购与界面

• 支出趋势新增按日展示。
• 采购入库将含糊的“建议”改为“待采购”，根据实际数量与实付总价实时预览单价。
• 已过期物资的领用类型默认选中“过期报废”，仍可手动修改。
• 已有分页的列表统一默认每页 10 条，可选 10 / 20 / 50 / 100。
• 统一财务模块的标题、筛选控件与表格样式；压缩布局、放大表格文字，缺失成本支持响应式多列展示。
• 修复财务数据过早加载，以及补录弹窗打开及保存刷新时页面滚动跳转的问题。

部署与文档

• 新增 GHCR 多架构 Docker 镜像发布，支持 linux/amd64、linux/arm64，以及手动触发构建。
• README 快速部署统一为 docker compose up -d --build。
• 完善中英文 README、语言切换与徽章，增加与 Grocy、HomeBox 的功能对比。

升级说明

• 财务 dashboard/summary 响应不再包含旧 valuation 字段；自定义集成请迁移到 /api/v1/homes/:homeId/inventory-cost-analysis。MCP 同步提供 get_inventory_cost_analysis。
• 缺失成本列表使用新增 /api/v1/homes/:homeId/missing-costs 接口。请同步更新前后端。
• 使用源码部署时，更新代码后运行 docker compose up -d --build。

验证： 类型检查、自动化测试和生产构建通过。

完整更新记录： v0.0.1...v0.0.2

AL1S WMS v0.0.1

Full Changelog: https://github.com/RicterZ/AL1S-WMS/commits/v0.0.1