鞋店库存定位小系统（极简 + 可拍照版）

静态站点（GitHub Pages），所有数据持久化在浏览器 IndexedDB（Dexie.js）。支持手机直接拍照上传位置照片，方便快速定位鞋盒。

技术栈

• Vite + React + TypeScript
• TailwindCSS（移动端优先）
• React Router
• IndexedDB（Dexie.js）
• JSZip 导入导出

本地运行

npm install
npm run dev

构建

npm run build
npm run preview

GitHub Pages 部署

1. 推送到 main 分支。
2. 仓库 Settings → Pages，选择 “GitHub Actions”。
3. Deploy to GitHub Pages workflow 会自动构建并发布。

IndexedDB / 浏览器限制说明

• 数据仅保存在当前浏览器与当前域名下，无法跨浏览器/设备自动同步。
• 清理浏览器数据会删除库存数据。
• 移动端浏览器在长期未访问时可能会自动清理存储，请定期导出备份。
• 私密/无痕模式下 IndexedDB 可能不可用或无法持久化。

导入 / 导出说明

• 导出为单个 ZIP 文件，包含：
  • data.json（鞋盒数据与照片索引）
  • photos/xxx.jpg（压缩后的照片）
• 导入时会校验 data.json 与照片文件结构：
  • 重复编号默认“覆盖”，也可选择“跳过”。

验收清单

• 首页：搜索框 + 新增/入库 + 库存列表 + 导入/导出
• 编号模糊搜索、列表展示、详情可查看/编辑
• 新增入库支持多码数一次添加，编号+码数保持唯一
• 新增入库支持拍照上传，照片压缩后存入 IndexedDB
• 详情页可卖出 1 双、更新价格/位置/库存、管理照片
• 导入/导出 ZIP 可用
• GitHub Actions 自动部署到 GitHub Pages