# ZeroGap

**Repository Path**: chenchenpp/zero

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-24
- **Last Updated**: 2026-02-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 喜糖店管理系统需求文档（单店版本）

## 背景与目标
面向婚嫁、升学、传统节日等庆祝场景的喜糖店，经营糖果、礼盒、喜帖等商品，包含零售与批发整箱销售。店面规模较大，需精细化管理商品、库存、成本与售价，并提供微信小程序点单能力，提升效率与准确性。

目标：
- 降低库存盘点与出入库错误
- 清晰掌握成本与利润
- 提升前台下单与配货效率
- 支持零售/批发多业务场景

## 系统范围
系统分为三部分：
1. 库存管理系统（Web）
2. 客户点单系统（微信小程序）
3. 后端服务（API + 数据存储 + 权限）

## 角色与权限
- 店主/管理员：全权限，成本价可见，配置角色权限
- 仓库管理员：入库/出库/盘点
- 前台导购：创建订单、查看库存、打印小票
- 客户：微信小程序浏览/下单

## 业务场景
- 零售：散装或单件销售
- 批发：整箱批量销售
- 订制：婚礼礼盒、喜帖套装
- 节日活动：折扣、组合商品

## 功能需求

### 1. 库存管理系统（Web）
- 商品管理
  - 商品信息：名称、品牌、规格、单位、条码、分类、图片、描述
  - 价格体系：成本价、零售价、批发价、促销价
  - 上下架状态
- 库存管理
  - 入库：采购入库、退货入库
  - 出库：销售出库、报损、调拨
  - 库存预警：低于安全库存提醒
  - 库存盘点：盘点单、差异记录
- 供应商管理
  - 供应商信息、历史采购记录
- 订单管理
  - 零售订单、批发订单、退货订单
  - 订单状态：待支付/已支付/已配货/已完成/已取消（不接支付，可手动标记）
- 报表统计
  - 销售报表（日/周/月）
  - 库存报表
  - 毛利报表
- 权限管理
  - 角色权限配置
  - 操作日志

### 2. 客户点单系统（微信小程序）
- 商品浏览
  - 分类、品牌、搜索、推荐
- 购物车与下单
  - 支持零售与整箱批发
  - 备注需求（礼盒搭配、贺卡内容）
- 订单查询
  - 订单状态、历史订单
- 客户信息
  - 手机、收货地址、备注

### 3. 后端服务
- RESTful API
- 业务逻辑与权限控制
- 数据存储与缓存
- 日志与审计

## 数据模型（核心）
- 商品（Product）
- 品牌（Brand）
- 分类（Category）
- 库存（Inventory）
- 订单（Order）
- 订单项（OrderItem）
- 供应商（Supplier）
- 采购单（Purchase）
- 盘点单（StockCheck）
- 用户与角色（User/Role）

## 技术栈（明确版）

### Web（库存管理系统）
- React + Ant Design Pro
- TypeScript
- Tailwind CSS
- ESLint + Prettier（统一代码规范）

### 微信小程序
- Taro
- ESLint + Prettier（统一代码规范）

### 后端
- Java + Spring Boot
- RESTful API
- JWT 权限认证

### 数据库
- MySQL 8
- Redis（缓存/会话）

### 其他
- OSS 文件存储（图片）
- 轻量化日志记录

## 非功能需求
- 安全：权限分级、敏感字段（成本价）可控
- 性能：支持同时10-50人高频操作
- 易用性：前台操作 3 步内完成下单
- 可维护性：模块化、分层清晰

## 里程碑拆分建议
1. MVP（库存管理 + 基础下单）
2. 小程序上线（客户自助点单）
3. 报表优化 + 多角色权限