# koyoo_stock

**Repository Path**: Matthew_Chen/koyoo_stock

## Basic Information

- **Project Name**: koyoo_stock
- **Description**: 基于微信云开发（CloudBase）的餐饮多门店库存采购管理系统，手机端操作、界面简洁，支持： 采购申请/店长审核 → 采购执行 → 待到货 → 前厅/后厨入库 → 出库/报损 → 库存看板/预警 → 月度盘点/盘盈盘亏调整， 全套基础档案（门店/分类/单位/存放位置/食材/员工权限）支持 Excel 批量导入初始化， 支持导出 Excel 台账，数据按门店隔离、按角色与食材分类授权。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-10
- **Last Updated**: 2026-10-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 烤右·澳洲和牛烧肉 — 多门店进销存小程序（微信云开发版）

基于**微信云开发（CloudBase）**的餐饮多门店库存采购管理系统，手机端操作、界面简洁，支持：
采购申请/店长审核 → 采购执行 → 待到货 → 前厅/后厨入库 → 出库/报损 → 库存看板/预警 → 月度盘点/盘盈盘亏调整，
全套基础档案（门店/分类/单位/存放位置/食材/员工权限）支持 **Excel 批量导入初始化**，
支持**导出 Excel 台账**，数据按门店隔离、按角色与食材分类授权。

## 📦 项目结构

```
kaoyou-stock/
├── project.config.json      # 开发者工具项目配置（需替换 AppID）
├── app.js / app.json / app.wxss / sitemap.json
├── cloudfunctions/          # 8 个云函数（权限校验 + 业务逻辑全部在云端）
│   ├── login        # 登录 / 首次自动创建老板账号 / 初始化数据库
│   ├── archive      # 6 类基础档案增删改查（老板可写）
│   ├── employee     # 员工权限 / 微信账号绑定（姓名+邀请码）
│   ├── purchase     # 采购申请单状态流（待审核→待采购→待到货→入库）
│   ├── stock        # 入库 / 出库 / 报损（自动增减门店库存 + 流水）
│   ├── inventory    # 首页看板 / 库存查询 / 详情流水与历史采购价
│   ├── count        # 月度盘点录入 / 店长确认调整
│   └── importExport # Excel 模板下载 / 批量导入 / 台账导出
├── components/
│   ├── store-switcher/   # 门店切换下拉框（仅显示已授权门店）
│   └── food-picker/      # 食材选择弹层（多单据复用）
├── utils/                 # 云函数调用封装 / 常量 / 档案字段配置
├── pages/                 # 20 个页面
├── docs/                  # 完整文档 + Excel 模板
│   ├── 01-数据表结构.md
│   ├── 02-部署步骤.md
│   ├── 03-微信开发者工具导入教程.md
│   ├── 04-角色权限说明.md
│   ├── 05-日常操作流程.md
│   ├── 06-Excel批量导入教程.md
│   ├── 07-导出Excel台账.md
│   ├── 08-后续扩展说明.md
│   ├── 09-常见问题FAQ.md
│   ├── 10-备用方案-飞书多维表格版.md
│   └── templates/        # 6 类基础档案导入模板（.xlsx）
└── generate_templates.py  # 模板生成脚本（可选）
```

## ⚡ 快速上手（详细步骤见 docs/02、docs/03）

1. **准备**：注册小程序（需正式 AppID，云开发不支持游客模式），开通云开发并创建环境
2. **导入项目**：微信开发者工具 → 导入 `kaoyou-stock` 目录 → 填入 AppID
3. **改配置**：把 `app.js` 中 `globalData.env` 替换为你的云环境 ID
4. **部署云函数**：云开发控制台 → 云函数 → 逐个右键「上传并部署：云端安装依赖」
   （`importExport` 依赖 node-xlsx，务必选"云端安装依赖"）
5. **初始化**：打开小程序 → 首个账号自动成为**老板** → 「我的」→「初始化数据库」
6. **配基础档案**：用 `docs/templates/` 里的模板填好后，在「档案」→ 对应档案 → 批量导入；
   或直接单条新增
7. **加员工**：老板在「档案 → 员工权限」新增员工（角色 + 分配门店 + 负责分类），
   员工打开小程序在登录页输入**姓名 + 邀请码**完成微信绑定（邀请码在员工权限列表复制）
8. **开始使用**：新建采购申请 → 店长审核（待采购）→ 采购执行（待到货）→ 前厅/后厨入库 → 库存自动更新 → 月度盘点

## 🔐 权限速览

| 功能 | 老板 | 店长 | 前厅/后厨 | 采购 |
|------|:---:|:---:|:---:|:---:|
| 全局基础档案 增删改 / 批量导入 | ✅ | 只读 | 只读 | 只读 |
| 采购申请 新建/修改 | ✅ | ✅ | ✅ | ✅ |
| 采购申请 审核 | ✅ | ✅(本店) | ❌ | ❌ |
| 采购执行（待采购→待到货） | ✅ | ✅ | ❌ | ✅ |
| 入库（待到货/部分入库申请） | ✅ | ✅ | ✅(本店) | ❌ |
| 出库 / 报损 | ✅ | ✅ | ✅(本店) | ❌ |
| 盘点录入 | ✅ | ✅ | ✅(本店) | ❌ |
| 盘点确认调整 | ✅ | ✅(本店) | ❌ | ❌ |
| 库存查看 / 台账导出 | ✅ | ✅ | ✅ | ✅ |
| 员工权限管理 / 初始化 | ✅ | ❌ | ❌ | ❌ |

> 数据按门店隔离：所有业务单据带 `storeId`，页面顶部可切换门店，只显示已授权门店的数据；
> 按**负责食材分类**隔离：前厅/后厨/采购只看到自己负责分类的食材、库存与单据。

## 🧩 核心数据集合（云数据库）

`stores` 门店 ｜ `food_categories` 食材分类 ｜ `units` 单位 ｜ `storage_locations` 存放位置 ｜
`foods` 食材 ｜ `employees` 员工权限 ｜ `purchase_requests` 采购申请 ｜
`inbound_orders` 入库单 ｜ `outbound_orders` 出库单 ｜
`wastage_orders` 报损单 ｜ `inventory` 门店库存 ｜ `stock_flows` 出入库流水 ｜
`stock_counts` 盘点单 ｜ `counters` 单号流水号 ｜ `user_profiles` 权限快照

详细字段定义见 `docs/01-数据表结构.md`。

## ⚠️ 注意事项

- 云开发数据库集合权限：档案类设**仅创建者可读写**；业务单据类用**应急方案**（所有用户可读，仅创建者及管理员可写）或升级为自定义安全规则；`counters` 单号计数器必须**所有用户可读写**（见 docs/02）
- 所有业务单据**不可删除，仅可作废**（作废后保留存档）
- 本版本为轻量化 MVP，未对接收银系统；预留了菜品 BOM 与销售扣库存扩展点（见 docs/08）