# AI生成简易进销存

**Repository Path**: chcm/simple-jxc

## Basic Information

- **Project Name**: AI生成简易进销存
- **Description**: 无需敲一行代码，AI 全程包办开发 —— 这款开源进销存系统，重新定义中小企业数字化门槛！
当传统进销存还在依赖专业开发团队、耗费数月工期与高额成本时，我们用 AI 完成了从需求梳理到系统生成的全流程：输入你的行业场景（零售 / 批发 / 生产）、核心需求（库存预警 / 自动对账 / 订单追踪），AI 直接生成可部署、可迭代的完整进销存解决方案，全程零人工编码干预。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://fenxi365.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-04
- **Last Updated**: 2025-12-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 生成的零代码开源进销存系统

一个由 AI 驱动并完全开源的进销存系统，覆盖采购、销售、库存、报表与权限管理等核心场景，适合中小企业快速数字化与二次开发。

**核心亮点**
- 零代码生成：从需求到部署由 AI 自动完成，可读源码可自由改造
- 全流程覆盖：采购、销售、库存、报表、用户与角色权限一站式
- 现代技术栈：后端 Spring Boot，前端 Vue 3 + Vite + TDesign
- 易扩展：清晰的模块化结构，支持自定义字段、报表与业务流程

**主要功能**
- 采购管理：供应商、采购单、入库、对账
- 销售管理：客户、销售单、发货、退货、统计
- 库存管理：实时库存、预警、调拨、盘点、批次/有效期
- 报表中心：采购/销售汇总、库存报表、Excel 导出
- 系统设置：角色权限、用户管理、API Key、企业信息

**技术栈**
- 后端：`Spring Boot 3.5`、`Java 21`、`Gradle`
- 前端：`Vue 3`、`Vite 7`、`TDesign Vue Next`、`TailwindCSS`
- 其他：`Axios`、`Pinia`、`VXE Table`、`ECharts`
**项目截图**
<div align="center">
<img src="merchant/merchant-front/src/assets/logo.png" alt="商户端 Logo" width="220" />
 <br>
  <img src="image.png" alt="商户端" width="720" />
  <br>
  <img src="img.png" alt="商户端" width="720" />
</div>

**仓库结构**
```
simple-jxc/
├─ merchant/                     # 面向商户的业务模块
│  ├─ merchant-front/            # 商户端前端（Vue 3 + Vite）
│  ├─ merchant-api/              # 商户端接口（Spring Boot）
│  └─ merchant-service/          # 商户端业务服务
├─ admin/                        # 面向平台管理员的模块
│  ├─ admin-front/               # 管理端前端（Vue 3 + Vite）
│  ├─ admin-api/                 # 管理端接口（Spring Boot）
│  └─ admin-service/             # 管理端业务服务
├─ kernel/                       # 内核公共模块（实体/领域/服务/WEB）
│  ├─ entity/
│  ├─ domain/
│  ├─ service/
│  └─ web/
├─ docs/                         # 文档（如 OpenAPI）
├─ build.gradle                  # 根构建配置（Spring Boot/Java 21）
├─ settings.gradle               # 多模块定义
├─ libs.version.toml             # 版本目录
└─ jxc20251206.sql               # 初始化/示例数据
```

**子项目结构（示例：merchant-front）**
```
merchant/merchant-front/
├─ src/
│  ├─ api/            # 业务接口封装（如 Good/Stock/Warehouse）
│  ├─ page/           # 页面模块（基础资料、库存、报表、设置、账号）
│  ├─ components/     # 布局与通用组件
│  ├─ libs/           # 请求、工具、表格等封装
│  ├─ store/          # Pinia 存储
│  └─ style/          # 全局样式
└─ package.json       # 前端依赖与脚本
```

**快速开始**
- 后端（示例以商户端为例）：
  - `./gradlew :merchant:merchant-api:bootRun` 启动接口服务
  - `./gradlew :admin:admin-api:bootRun` 启动管理端接口
  - 所有后端模块继承根 `build.gradle` 的 Spring Boot 配置
- 前端：
  - 商户端：`cd merchant/merchant-front && npm i && npm run dev`
  - 管理端：`cd admin/admin-front && npm i && npm run dev`

**构建与发布**
- 后端可生成可执行包：`./gradlew :merchant:merchant-api:bootJar`、`./gradlew :admin:admin-api:bootJar`
- 前端打包：
  - 商户端：`cd merchant/merchant-front && npm run build`
  - 管理端：`cd admin/admin-front && npm run build`

**配置说明**
- 后端配置文件：`application.yaml`（位于各模块 `src/main/resources/`）
- 数据库与公共配置：`kernel/domain/src/main/resources/application-db.yaml`
- 前端环境变量：
  - `VITE_BASE_API` 接口前缀，默认 `api`
  - 根据部署环境调整反向代理或静态资源路径（见各 `vite.config.js`）

**前端接口配置**
- `merchant-front/src/libs/Request.js` 使用 `import.meta.env.VITE_BASE_API` 作为接口前缀，默认 `api`
- 本地开发可在 `vite.config.js` 配置代理，或通过环境变量调整后端路径

**接口文档**
- 商户端：`merchant/merchant-front/public/open-api.md` 与 `open-api.html`
- 根目录：`docs/open-api.md`

**贡献指南**
- 提交 Issue：反馈需求与问题
- 提交 PR：Fork 后提交代码改动
- 分享案例：欢迎在 Issues 中分享你的实践与建议

**许可证**
- 本项目使用 `Apache License 2.0`

**联系与支持**
- 仓库地址：`https://gitee.com/chcm/simple-jxc.git`
- 问题反馈：请在 Issues 中提交