# 流云erp

**Repository Path**: zql81199/neo-flow

## Basic Information

- **Project Name**: 流云erp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 0
- **Created**: 2026-09-11
- **Last Updated**: 2026-10-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# Neo-Flow

**面向 B2B 企业的销售-采购-财务-仓储一体化 ERP** · 开源轻量版

[![License: AGPLv3](https://img.shields.io/badge/License-AGPLv3-blue.svg)](LICENSE)
[![Java](https://img.shields.io/badge/Java-17-orange.svg)](core/)
[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3-brightgreen.svg)](core/)
[![Vue 3](https://img.shields.io/badge/Vue%203-TypeScript-42b883.svg)](webapp/)

🌐 官网 [runneoflow.com](https://runneoflow.com/) ｜ 🎮 在线演示 [runneoflow.cn](https://runneoflow.cn)

**Neo-Flow** 是面向「合同数量多、单笔金额小」业务形态的开源 ERP：快速建合同、精简流程、精简菜单，
覆盖 **线索/商机 → 报价 → 合同 → 订单 → 仓储出入库 → 应收应付/发票 → 收付款核销 → 合同变更** 的完整业务闭环。

</div>

- 🧾 **一站式业务闭环** —— 从商机到回款，销售、采购、仓储、财务、审批在同一套数据模型里流转，单据自动生成、状态互相联动。
- ⚡ **快速建合同** —— 直传产品明细（含成本价/销售价）即刻成单，报价单可选关联、明细一键带出，小单不再困于重流程。
- 🔐 **行级数据权限** —— 每张业务表登记归属锚列，按 SELF / DEPARTMENT / ALL 范围过滤；方向性原则「上游能看下游、下游不能看上游」，可见即可操作。
- ✅ **同级评审审批流** —— 合同、订单、付款、变更全走可配置审批，审批与业务状态机回调联动，任务直达工作台待办。
- 📊 **经营驾驶舱** —— 排行、转化、账龄、真实毛利多维报表，未税口径、费用计入、合同级静态毛利一目了然。

## 🖥️ 系统界面

演示数据均为虚构数据，可直接访问[在线演示](https://runneoflow.cn)体验。

| 经营分析 · 合同与订单 | 经营分析 · 真实毛利 |
|---|---|
| ![经营分析-合同与订单](docs/images/overview-contract-order.png) | ![经营分析-真实毛利](docs/images/overview-real-margin.png) |

| 销售合同列表 | 应收单详情 |
|---|---|
| ![销售合同列表](docs/images/salescontract-list.png) | ![应收单详情](docs/images/receivable-bill-detail.png) |

| 应付单详情 |
|---|
| ![应付单详情](docs/images/ap-bill-detail.png) |

## ✨ 功能矩阵

| 领域 | 模块 |
|---|---|
| 销售 | 商机、客户、企业、报价单、销售合同、销售合同变更、销售订单 |
| 采购 | 采购合同、采购合同变更、采购订单（经手人全链路：关联销售侧自动归属、下游单据直取） |
| 交付 | 交付项目、售前/售后工单、需求与缺陷 |
| 仓储资产 | 出入库申请与确认、库存、资产、产品借用 |
| 财务 | 应收/应付、发票、收款单、付款、现金银行、核销、一般费用 |
| 协同 | 同级评审（审批流）、站内信/邮件/钉钉/飞书/企业微信通知、工作台待办 |
| 分析 | 经营驾驶舱（排行/转化/账龄/毛利） |
| 支撑 | 组织与角色、行级数据权限（可见性链）、数据字典、代理授权、软件版权 |

## 🚀 快速开始

前置：MySQL 8 / Redis 6+ / MinIO（或 S3 兼容对象存储），以及 JDK 17+、Maven 3.9+、Node 20.19+（或 22.12+）。

```bash
git clone <本仓库地址> neo-flow && cd neo-flow

# 1) 建库并导入初始化脚本（结构 + 权限体系/超管）
mysql -uroot -p neo_flow < sql/schema.sql
mysql -uroot -p neo_flow < sql/init.sql

# 2) 启动后端（8002）
cd core && cp src/main/resources/env.example src/main/resources/env   # 填入三个组件的连接信息
mvn -q package -DskipTests && ../scripts/start_backend.sh

# 3) 启动前端（5174，`/v1` 已代理到 8002）
cd ../webapp && npm ci && npm run dev
```

访问 `http://localhost:5174`，超管 `admin@test.com` / `111111`（**登录后请立即修改密码**）。

- 本地开发端口：后端 `8002`、前端 `5174`；数据库初始化固定为 `sql/schema.sql` + `sql/init.sql` 两步。
- 全部配置经环境变量注入（模板与逐项说明见 `core/src/main/resources/env.example`）；`JWT_SECRET` / `JWT_REFRESH_SECRET` 为必填，未设置后端拒绝启动。
- 生产构建与部署细节、重要提醒见 **[deploy.md](deploy.md)**。

## 🏗️ 架构速览

- **后端 DDD 分层**：`domain`（resource / service / mapper / entity / enums）+ `infrastructure`；业务通知统一经通知中枢在事务提交后外推（消息可丢、不可错发）。
- **行级数据权限「可见性链」模型**：每张业务表登记归属锚列，按 SELF / DEPARTMENT / ALL 数据范围做行过滤，方向性原则为「上游能看下游、下游不能看上游」。
- **启动期结构校验**：实体字段与真实库结构逐列比对，库结构落后于代码将直接启动失败——**升级务必先执行随版本发布的结构变更脚本**。
- 模块文档：`docs/` 下 18 个模块各含 README / business / api / ui，总索引见 `docs/README.md` 与 `PROJECT_GUIDE.md`。

## 🗂️ 工程结构

```text
neo-flow/
├── core/            # 后端：Java 17 + Spring Boot 3 + MyBatis-Plus + MySQL 8 + Redis
├── webapp/          # 前端：Vue 3 + TypeScript + Arco Design Vue + Vite
├── docs/            # 模块文档（18 个模块）+ 系统界面截图
├── sql/             # 建库脚本：schema.sql（结构）+ init.sql（权限体系与超管）
├── scripts/         # 启动脚本
├── deploy.md        # 生产构建与部署手册
└── LICENSE          # GNU AGPL v3
```

## 📄 文档

| 文档 | 内容 |
|---|---|
| `PROJECT_GUIDE.md` | 项目全景：结构、模块索引、开发规范 |
| `docs/README.md` | 模块文档总索引与维护规范 |
| `deploy.md` | 生产部署、构建与环境配置逐项说明 |

## 💼 商业服务

**本仓库源码以 AGPLv3 协议开源：代码免费，服务收费。**

你可以自由地使用、研究、修改本软件；但若将其（含你的修改版）对外提供网络服务，须按 AGPLv3 第 13 条向用户开放相应源代码。如需闭源集成、免去开源义务的商业授权，或把专业的事交给专业的人：

| 服务 | 内容 | 计费 |
|---|---|---|
| 部署实施 | 环境规划、安装部署、数据初始化、上线保障 | 一次性（按环境规模） |
| 运维保障 | 故障响应、安全补丁、版本升级、数据备份巡检 | 年度订阅 |
| 二次开发 | 功能定制、第三方系统对接（OA/财务/电商平台等）、报表定制 | 项目制 / 人天 |
| 商业许可 | AGPL 以外的闭源商业授权 | 面议 |

> 商务合作请通过[官网](https://runneoflow.com/)与我们联系。

## 🤝 社区与安全

- 问题与需求：请通过仓库 Issue 提交（欢迎附复现步骤与截图）。
- 安全漏洞：请通过[官网](https://runneoflow.com/)公布的联系方式私下联系维护者，勿公开提交 Issue。

## 🗺️ Roadmap

- 精简工单流程
- 更多行业化的字段与报表模板
- 移动端配套
- 欢迎通过 Issue / PR 参与贡献

## ⚖️ 协议与商标

- 源码以 [GNU Affero General Public License v3.0](LICENSE)（AGPLv3）发布。
- 「Neo-Flow」名称及相关标识为项目维护方的商标，本许可证不授予任何商标使用权利；衍生作品不得暗示其获得官方认可。