# zero-template

**Repository Path**: iamfy/zero-template

## Basic Information

- **Project Name**: zero-template
- **Description**: 模版项目
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-09
- **Last Updated**: 2026-07-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# zero-template

## 介绍

一个基于微服务架构构建的进销存管理系统模板项目。

## 软件架构

项目由三个组件组成：

### 后端服务

| 服务 | 技术 | 框架 | 端口 |
|------|------|------|------|
| zero-jasrv | Java 17 | Spring Boot 3.2.5 | 8001 |
| zero-pysrv | Python | Flask + Gunicorn | 8000 |

### 前端

| 技术 | 版本 |
|------|------|
| Vue | 3.4.x |
| TypeScript | 6.x |
| Vite | 5.x |
| Element Plus | 2.5.x |
| Pinia | 2.1.x |
| Vue Router | 4.2.x |

### 数据库

- **PostgreSQL**

### 安全

- **JWT 认证**
- **Spring Security**

## 项目结构

```
zero-template/
├── zero-jasrv/                    # Java 后端服务
│   ├── src/main/java/com/stockwise/
│   │   ├── controller/           # REST API 控制器
│   │   ├── service/              # 业务逻辑层
│   │   ├── mapper/               # MyBatis Mapper
│   │   ├── entity/               # 数据库实体
│   │   ├── dto/                  # 数据传输对象
│   │   ├── config/               # 配置类
│   │   └── common/               # 公共工具类
│   ├── src/main/resources/
│   │   └── application.yml       # 应用配置
│   └── pom.xml                   # Maven 配置
│
├── zero-pysrv/                   # Python 后端服务
│   ├── src/stock_wise/
│   │   ├── api/                  # API 路由
│   │   ├── common/               # 公共工具类
│   │   └── resources/            # 资源文件
│   ├── gunicorncfg.py            # Gunicorn 配置
│   ├── api.py                    # 应用入口
│   └── docker-compose.yml        # Docker Compose
│
├── zero-web/                     # 前端应用
│   ├── src/
│   │   ├── views/                # 页面组件
│   │   ├── api/                  # API 服务
│   │   ├── stores/               # Pinia 状态管理
│   │   ├── router/               # Vue Router
│   │   └── utils/                # 工具函数
│   ├── package.json              # npm 依赖
│   └── vite.config.ts            # Vite 配置
│
└── .gitignore
```

## 功能特性

- **商品管理**：创建、编辑和管理商品信息，支持规格和分类
- **库存管理**：库存跟踪、批次管理、调拨和调整
- **采购管理**：采购订单、供应商管理和收货单跟踪
- **销售管理**：销售订单、客户管理和发货单跟踪
- **生产管理**：生产订单和物料消耗管理
- **仓库管理**：多仓库支持和库存快照
- **用户管理**：基于角色的访问控制和 JWT 认证
- **数据看板**：实时分析和报表

## 环境要求

- **Java 17** 或更高版本
- **Python 3.9** 或更高版本
- **Node.js 18** 或更高版本
- **PostgreSQL 14** 或更高版本

## 安装教程

### 1. 克隆仓库

```bash
git clone <repository-url>
cd zero-template
```

### 2. 配置数据库

创建 PostgreSQL 数据库：

```sql
CREATE DATABASE stock_wise;
```

### 3. 启动 Java 服务 (zero-jasrv)

```bash
cd zero-jasrv
mvn spring-boot:run
```

服务将在 `http://localhost:8001` 启动

### 4. 启动 Python 服务 (zero-pysrv)

```bash
cd zero-pysrv
gunicorn -c gunicorncfg.py api:app
```

服务将在 `http://localhost:8000` 启动

### 5. 启动前端 (zero-web)

```bash
cd zero-web
npm install
npm run dev
```

前端将在 `http://localhost:3000` 启动

## API 文档

### Java 服务

访问 Swagger UI：`http://localhost:8001/swagger-ui.html`

## Docker 部署

### Python 服务

```bash
cd zero-pysrv
docker-compose up -d
```

## 配置说明

### Java 服务配置

复制 `application.yml` 模板并配置：

```yaml
server:
  port: 8001

spring:
  datasource:
    url: jdbc:postgresql://<host>:5432/stock_wise
    username: <username>
    password: <password>

jwt:
  secret: <your-secret-key>
  expiration: 86400000
```

### 前端环境变量

在 zero-web 目录创建 `.env` 文件：

```env
VITE_API_URL=http://localhost:8000
```

## 使用说明

前端应用默认通过 Vite 代理连接到 Python 服务（端口 8000）。Java 服务（端口 8001）提供额外的后端功能。

## 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

## Gitee 特色功能

1. 使用 Readme_XXX.md 来支持不同的语言，例如 Readme_en.md, Readme_zh.md
2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)