# replenish-system 

**Repository Path**: sharpguo/replenish-system

## Basic Information

- **Project Name**: replenish-system 
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-22
- **Last Updated**: 2026-05-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 零食补货管理系统

微信小程序零食/商品补货管理系统，支持库存管理、销量录入、智能补货建议生成，适配手机/Pad/PC 三端。

## 功能模块

| 页面 | 功能 |
|------|------|
| 首页 | 今日销量概览、低库存预警、快捷入口、近期补货记录 |
| 库存 | 商品库存浏览、分类筛选、库存盘点修正、售罄状态标记 |
| 录入 | 按日期录入各商品销量、清空重置、一键保存 |
| 补货 | 基于日均销量 + 安全库存算法自动生成补货建议单 |

## 技术栈

- **框架**：微信小程序原生（WXML / WXSS / JS）
- **数据层**：`utils/replenish.js` 统一数据访问（Storage 存储）
- **宽屏适配**：rpx 响应式 + 媒体查询 `@media (min-width: 768px)` 三端自适应
- **导航方案**：宽屏下隐藏原生 TabBar，使用自定义 top-nav 组件；手机端保持原生 TabBar

## 项目结构

```
miniprogram/
├── app.js / app.json / app.wxss     # 全局配置与样式
├── behaviors/
│   └── wideBehavior.js              # 宽屏适配公共 Behavior
├── components/
│   └── top-nav/                     # 顶部导航组件
├── pages/
│   ├── index/                       # 首页
│   ├── inventory/                   # 库存管理
│   ├── sales/                       # 销量录入
│   └── replenish/                   # 补货单生成
└── utils/
    ├── replenish.js                 # 核心数据层
    └── mockData.js                  # 初始化示例数据
```

## 核心算法

补货建议 = `日均销量 × 覆盖天数 + 安全库存 - 当前库存`

- 日均销量基于历史 30 天销量数据计算
- 安全库存 = 日均销量 × 2 天
- 计算结果分两组：需要补货 / 库存充足

## 开发生注意事项

- 宽屏组件（top-nav）使用 px 固定单位，避免 rpx 在平板上等比放大
- 所有数据写入统一通过 `utils/replenish.js` 的函数（`setStock` / `updateStock` / `recordSale`）
- 页面 JS 统一引入 `wideBehavior`，由 Behavior 管理 `isWide` / TabBar 显隐 / 窗口尺寸监听