已集成懒猫OIDC登录。 ## 功能特性 - 酒窖藏酒管理：维护酒名、酒庄、年份、产区、评分、酒体、酸度、配餐、价格和个人备注，并保留瓶数库存。 - 酒款资料库复用：已录入过的酒款会沉淀到本地资料库，后续可一键再次加入库存，减少重复录入。 - 条码与远程资料补全：登录后可用 Open Food Facts + WineAPI 自动补齐条码信息、酒标图片和部分风味字段。 - 游客酒单 kiosk：`/kiosk` 提供只读展示页，可按类型筛选、搜索，并显示按杯售卖价格、地图入口和品牌信息。 - 盘点与加减库存：支持 Inventory Mode（盘点模式）和扫码快速加库存，零库存酒款可在退出盘点时自动清理。 - 品牌与展示配置：管理员可修改标题、副标题、主色、深色模式、Logo、kiosk 标题、副标题、地图按钮和页脚显示。 ### 日常使用方式 1. 藏酒录入： 点击右下角“+”，在 `Add Wine（添加酒款）` 弹窗中填写酒名、酒庄、年份、产区、评分和酒体。 2. 资料库复用： 通过 `Library（资料库）` 查找历史录入过的酒款，把常备酒一键重新加入库存。 3. 库存盘点： 开启 `Inventory Mode（盘点模式）` 后使用 `+ / -` 调整瓶数，退出盘点时会自动移除零库存酒款。 4. 备份与恢复： 打开 `Backup & Import（备份与导入）` 面板。 `Export JSON` / `Export CSV` 和 `Choose file & import（选择文件并导入）` 都会先弹出来源选择； 注意：选择存储到懒猫网盘时，文件名名称需要带上对应的文件名后缀，如“kellerlog.json"或“kellerlog.csv"。从懒猫网盘导入时，请确保对应格式的文件存在。 5. 品牌配置： 在 `Branding（品牌设置）` 面板调整标题、Logo、主色和深色模式。 #### 可选配置： `WINEAPI_KEY`，可在应用详情里的环境变量里进行填写，见附图位置。 - 用于远程酒款搜索和条码补全；不配置时应用仍能正常管理本地酒单，只是远程自动补全会降级。 - 获取方式：访问 [wineapi.io](https://wineapi.io/)，注册后从账号侧获取 API Key。官方当前提供 `Free` 免费层，可用于酒款搜索与详情查询，但只有 `100 requests/day`，且标注为 `Personal use only`；如果你的场景是门店、会所或其他商用部署，建议直接升级到带 `Business use license` 的付费层。