# CJR

**Repository Path**: calvin207/cjr

## Basic Information

- **Project Name**: CJR
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-27
- **Last Updated**: 2026-01-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 从简商品管理系统 v1.0

一套以数据驱动为核心的快时尚商品流转系统，聚焦智能配货、智能补货与调拨归并的业务闭环。

## 项目结构

```
CJR/
├── backend/          # Django 后端项目
│   ├── apps/         # 应用模块
│   │   ├── users/    # 用户认证系统
│   │   ├── stores/   # 门店管理
│   │   ├── products/ # 商品管理
│   │   ├── inventory/# 库存管理
│   │   └── allocation/# 智能配货
│   ├── congjian/     # 项目配置
│   ├── requirements.txt
│   └── .env.example
├── frontend/         # Vue 3 Web 前端
│   ├── src/
│   │   ├── views/    # 页面组件
│   │   ├── router/   # 路由配置
│   │   ├── store/    # 状态管理
│   │   ├── api/      # API 接口
│   │   └── components/# 公共组件
│   └── package.json
└── h5/              # uni-app 移动端
    ├── pages/       # 页面文件
    ├── manifest.json
    └── pages.json
```

## 技术栈

### 后端
- Python 3.x
- Django 4.2
- Django REST Framework
- JWT 认证 (SimpleJWT)
- PostgreSQL

### 前端
- Vue 3
- Vite
- Element Plus
- Pinia (状态管理)
- Vue Router
- Axios

### H5 移动端
- uni-app
- Vue 3

## 快速开始

### 1. 后端启动

```bash
# 进入后端目录
cd backend

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，配置数据库等信息

# 创建数据库（PostgreSQL）
createdb congjian_db

# 运行迁移
python manage.py makemigrations
python manage.py migrate

# 创建超级用户
python manage.py createsuperuser

# 启动开发服务器
python manage.py runserver
```

后端服务将运行在 http://localhost:8000

### 2. 前端启动

```bash
# 进入前端目录
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

前端服务将运行在 http://localhost:5173

### 3. H5 移动端启动

```bash
# 进入 H5 目录
cd h5

# 安装依赖
npm install

# 启动 H5 开发服务器
npm run dev:h5

# 或启动微信小程序开发
npm run dev:mp-weixin
```

## 核心功能模块

### 1. 用户认证系统
- JWT 登录认证
- 用户角色管理（总部/直营店/联营店）
- 权限控制

### 2. 门店管理
- 门店信息管理
- 门店聚类（气候带、商圈类型、价格敏感度、陈列容量）
- 财务信息管理（联营店）

### 3. 商品管理
- 商品（SPU）管理
- SKU 管理
- 商品类别管理
- 生命周期管理

### 4. 库存管理
- 实时库存查询
- 库存交易记录
- 销售数据统计
- DOS（Days of Supply）计算

### 5. 智能配货
- 三种配货算法
  - 绝对值配货
  - 属性对标配货
  - 最小陈列+销售能力加权
- 尺码组模板
- 配货计划管理
- 联营店确认流程

## API 接口

所有 API 接口以 `/api/` 为前缀：

- `/api/auth/` - 用户认证相关
- `/api/stores/` - 门店管理
- `/api/products/` - 商品管理
- `/api/inventory/` - 库存管理
- `/api/allocation/` - 配货管理

详细 API 文档可访问：http://localhost:8000/admin

## 开发说明

### 后端开发
- 所有应用统一放置在 `backend/apps/` 目录下
- 遵循 Django REST Framework 最佳实践
- 使用 JWT 进行身份认证
- 数据库使用 PostgreSQL

### 前端开发
- 使用 Vue 3 Composition API
- 状态管理使用 Pinia
- UI 组件库使用 Element Plus
- API 请求统一通过 axios 封装

### H5 开发
- 使用 uni-app 框架
- 支持编译到 H5 和微信小程序
- 页面路由配置在 pages.json

## 注意事项

1. 首次运行前请确保已安装 PostgreSQL 并创建数据库
2. 修改 `.env` 文件配置数据库连接信息
3. 后端和前端需要同时运行才能正常使用
4. 联营店用户需要进行资金校验才能执行配货/补货操作

## 后续开发计划

- [ ] 实现智能补货算法（DOS 和 Min/Max）
- [ ] 实现调拨/归并系统
- [ ] 完善配货算法的具体实现
- [ ] 添加数据可视化图表
- [ ] 实现实时库存同步
- [ ] 添加单元测试

## 许可证

MIT License