# yao

**Repository Path**: umaruFE/yao

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-18
- **Last Updated**: 2026-01-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 供应链与零售一体化新零售系统 v2.2

基于Yao低代码平台构建的供应链与零售一体化新零售系统。

## 系统架构

本系统采用**"统一SaaS平台，多级权限"**架构，包含以下模块：

### 1. 总部管理后台 (I - SaaS管理端)
供应商/总部使用的核心管理系统，负责管控供应链、管理下级门店（客户）、统一财务与配送。

**核心功能模块：**
- **组织与权限管理**：连锁超市管理、门店账号配置
- **资料管理**：商品管理、客户管理、供应商管理
- **采购管理**：采购订单、采购退货单
- **销售管理**：销售订单(B2B)、销售退货单、商城订单(B2C)监管
- **仓库管理**：仓库与货架、库存作业、调货单、报损单
- **财务管理**：应收明细报表、应付明细报表
- **配送管理**：送货派车单、车辆登记表
- **数据看板**：全局数据看板、经营下钻

### 2. 门店管理后台 (II - 门店端)
单店/连锁门店店长及店员使用，核心逻辑包括商品上架与定价、B2B补货、C端订单履约、本地库存管理。

**核心功能模块：**
- **商品管理**：商品选品库、本店在售商品
- **采购管理**：采购补货单、采购收货、采购退货单
- **订单管理**：商城订单、线下订单、售后/退款
- **库存管理**：库存查询、报损/报溢、库存盘点
- **营销管理**：优惠券管理、促销活动
- **财务管理**：资金对账、门店营收日报
- **员工与设置**：员工管理、设备管理
- **会员管理**：会员列表

### 3. 司机配送APP (IV - B2B)
执行B2B（总仓到门店）配送的移动端应用。

**核心功能：**
- 任务中心：接收总部后台指派的送货派车单任务
- 任务详情：显示配送门店地址、联系人、订单明细
- 签收回执：门店管理员扫码或电子签名确认收货

### 4. POS收银端 (VI - 门店终端)
门店线下收银的终端应用。

**核心功能：**
- 基础收银：扫码、称重、挂单/取单
- 支付与结算：聚合支付、会员余额支付
- 数据同步：交易实时上传门店后台，扣减本地库存

## 项目结构

```
scm-yao/
├── models/              # 数据模型
│   ├── organization/    # 组织模型（连锁、门店）
│   ├── product/        # 商品模型（类别、品牌、单位、商品）
│   ├── supplier/        # 供应商模型
│   ├── warehouse/       # 仓库模型（仓库、货架、库存、调货、报损）
│   ├── purchase/        # 采购模型（订单、退货）
│   ├── sales/           # 销售模型（订单、退货）
│   ├── finance/         # 财务模型（应收、应付）
│   ├── delivery/        # 配送模型（车辆、派车单）
│   ├── store/           # 门店模型（商品、订单、库存、员工、POS交易）
│   └── member/          # 会员模型
├── forms/               # 表单定义
│   ├── organization/    # 组织表单
│   ├── product/         # 商品表单
│   ├── supplier/        # 供应商表单
│   ├── warehouse/       # 仓库表单
│   ├── purchase/        # 采购表单
│   ├── sales/           # 销售表单
│   ├── delivery/        # 配送表单
│   ├── store/           # 门店表单
│   └── member/          # 会员表单
├── tables/              # 表格定义
│   ├── organization/    # 组织表格
│   ├── product/         # 商品表格
│   ├── supplier/        # 供应商表格
│   ├── warehouse/       # 仓库表格
│   ├── purchase/        # 采购表格
│   ├── sales/           # 销售表格
│   ├── finance/         # 财务表格
│   ├── delivery/        # 配送表格
│   ├── store/           # 门店表格
│   └── member/          # 会员表格
├── flows/               # 流程定义
│   └── menu.flow.yao    # 菜单流程
├── scripts/             # 业务脚本
│   └── business/        # 业务处理脚本
│       ├── order.ts     # 订单处理
│       └── inventory.ts # 库存处理
└── app.yao              # 应用配置
```

## 核心业务流程

### 1. 门店入驻与商品上架流程
1. 总部(I) 创建客户档案（门店）及账号
2. 总部(I) 在资料管理-商品资料中维护商品，并授权给门店
3. 店长(II) 登录后台，在商品选品库中看到授权商品
4. 店长(II) 一键上架并设置"本地售价"，商品同步至商城和POS

### 2. 门店补货 (B2B) 流程
1. A-1店(II) 在采购管理中发起补货申请
2. 总部(I) 生成销售订单，审核通过（检查信用额度）
3. 总部(I) 生成送货派车单，指派车辆和司机
4. 司机(IV) 提货配送，店长(II) 在采购收货模块扫码入库
5. 总部(I) 财务管理-应收报表与门店(II) 财务-资金对账同步生成账单

### 3. 线上/线下销售流程
- **POS销售**：收银员扫码 -> 拉取本店价格 -> 支付 -> 扣减本地库存 -> 上传流水 -> 生成线下订单记录
- **商城销售**：顾客下单 -> 扣减/占用本地库存 -> 门店接单 -> 配送/自提核销 -> 完成

## 核心数据流转

- **组织与商品**：总部(创建/授权) -> 门店(选品/定价) -> 商城/POS(销售)
- **B2B订单**：门店(补货单) -> 总部(销售订单/派车单) -> 司机 -> 门店(收货入库)
- **库存流**：总仓(采购入库) -> 在途(配送) -> 门店本地库存(收货) -> 销售出库(POS/商城)
- **资金流**：
  - 总部 <-> 供应商：采购订单 -> 应付账款
  - 总部 <-> 门店：销售订单 -> 应收账款

## 使用说明

1. **初始化数据库**：运行 `yao migrate` 创建数据表
2. **启动服务**：运行 `yao start` 启动服务
3. **访问系统**：访问 `http://localhost:5099/admin` 进入管理后台

## 注意事项

- 本系统基于Yao低代码平台开发，需要先安装Yao环境
- 部分业务逻辑脚本需要根据实际需求完善
- 司机配送APP和POS收银端需要单独开发移动端应用，通过API与系统对接