# 柠煦供应链系统

**Repository Path**: elfbobo_admin_admin/NingxuSCM

## Basic Information

- **Project Name**: 柠煦供应链系统
- **Description**: 柠煦供应链系统
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-11-08
- **Last Updated**: 2026-11-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 柠煦供应链系统

全渠道智能供应链管理平台，支持淘宝/京东/拼多多/抖音等12+电商平台对接，AI驱动智能决策。

## 快速启动

```bash
# 1. 启动基础设施 (PostgreSQL + Redis)
docker-compose up -d postgres redis

# 2. 初始化数据库
psql -h localhost -U postgres -d ningxu_scm -f backend/migrations/001_init.sql

# 3. 启动后端
cd backend && go mod tidy && go run ./cmd/server

# 4. 启动前端管理后台 (新窗口)
cd frontend-admin && npm install && npm run dev

# 5. 启动小程序 (微信开发者工具打开 mini-program/)
```

## 技术栈

| 层 | 技术 | 说明 |
|----|------|------|
| 后端主框架 | Go 1.22 + Gin + GORM | 高并发API服务 |
| 高性能引擎 | Rust (CGO桥接) | 库存并发/价格计算/图像生成 |
| 数据库 | PostgreSQL 16 + Redis 7 | 主库+缓存 |
| 搜索引擎 | Elasticsearch 8 | 商品全文检索 |
| Web管理后台 | Vue 3 + TypeScript + Element Plus | 完整CRUD+图表 |
| 小程序 | 微信小程序原生 (WXML/WXSS/TS) | 扫码/PDA操作 |
| APP | Flutter 3.x + Dart 3 | iOS+Android一套代码 |
| AI | OpenAI/国内大模型 | 对话查询/内容生成/预测 |
| 电商平台 | 适配器模式对接12+平台 | 淘宝/京东/拼多多/抖音/Amazon... |

## 已对接/规划平台 (12个)

淘宝/天猫、京东、拼多多、抖音小店、快手、小红书、视频号、有赞、微盟、Shopify、Amazon、eBay、AliExpress

## 项目结构

```
NingxuSCM/
├── backend/              Go后端 (Handler/Service/Repository三层架构)
│   ├── rust_lib/         Rust高性能引擎 (库存/价格/图像)
│   └── pkg/adapter/      电商平台适配器层
├── frontend-admin/       Vue3管理后台 (完整业务页面)
├── flutter-app/          Flutter App (iOS+Android)
├── mini-program/         微信小程序原生
├── docs/API.md           API接口文档
├── docker-compose.yml    开发环境一键启动
└── docker-compose.prod.yml  生产环境编排
```

## 核心API

```
# 认证
POST   /api/v1/auth/login         登录(返回JWT)
GET    /api/v1/auth/captcha       验证码
POST   /api/v1/auth/logout        登出
GET    /api/v1/auth/me            当前用户

# 商品
GET    /api/v1/products           商品列表
POST   /api/v1/products           创建商品
GET    /api/v1/products/:id       商品详情
PUT    /api/v1/products/:id       更新商品
DELETE /api/v1/products/:id       删除商品

# 供应商
GET    /api/v1/suppliers          供应商列表
POST   /api/v1/suppliers          新建供应商

# 采购
GET    /api/v1/purchase/requests  采购申请列表
POST   /api/v1/purchase/requests  新建申请
PUT    /api/v1/purchase/requests/:id/status/:status  审批

# 仓储
GET    /api/v1/warehouse/inventory     库存列表
GET    /api/v1/warehouse/inventory/alerts  库存预警
POST   /api/v1/warehouse/inventory/deduct  扣减库存
GET    /api/v1/warehouse/inbounds      入库记录
POST   /api/v1/warehouse/inbounds      新建入库

# 销售
GET    /api/v1/sales/orders           销售订单列表
POST   /api/v1/sales/orders           新建订单
PUT    /api/v1/sales/orders/:id/status/:status  更新状态

# 财务
GET    /api/v1/finance/receivables    应收列表
GET    /api/v1/finance/payables       应付列表

# AI
POST   /api/v1/ai/query               AI对话查询
POST   /api/v1/ai/products/describe   AI生成商品描述
POST   /api/v1/ai/posters/generate    AI生成海报
POST   /api/v1/ai/predict/sales       AI销量预测
GET    /api/v1/ai/smart-replenish     AI智能补货

# 平台对接
GET    /api/v1/platforms              平台状态
POST   /api/v1/platforms/:code/sync   触发同步

# 消息通知
GET    /api/v1/notifications          通知列表
GET    /api/v1/notifications/unread-count  未读数量
PUT    /api/v1/notifications/:id/read  标记已读
POST   /api/v1/notifications/read-all  全部已读

# 消息
GET    /api/v1/messages               消息列表
POST   /api/v1/messages               发送消息

# 统计分析
GET    /api/v1/analytics/dashboard    工作台数据
GET    /api/v1/reports/daily          日报
GET    /api/v1/reports/monthly        月报
```

## 文档

- [完整开发方案](ARCHITECTURE.md) - 1200+行技术架构与市场分析
- [API文档](docs/API.md) - 接口规范