# ERP
**Repository Path**: MerlinRong/erp
## Basic Information
- **Project Name**: ERP
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-13
- **Last Updated**: 2026-11-14
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
---
## 目录
- [项目简介](#项目简介)
- [功能模块](#功能模块)
- [技术栈](#技术栈)
- [架构设计](#架构设计)
- [快速开始](#快速开始)
- [项目结构](#项目结构)
- [质量门禁](#质量门禁)
- [文档](#文档)
- [开发约定](#开发约定)
## 项目简介
本项目是一套面向中小型制造企业的 **ERP 系统**,覆盖从**采购下单 → 收货入库 → 生产领料/工单 → 销售发货 → 财务记账**的完整业务闭环,并内建**总账凭证、成本核算、固定资产、质量管理、批次追溯**等企业级能力。
- **业务驱动财务**:销售完成、采购收货、收付款、折旧计提等业务事件,可按「科目映射配置」自动生成记账凭证(默认关闭,开关可控,异常不影响业务事务)。
- **权限精细化**:基于 RBAC 的接口级权限点,覆盖全部业务模块。
- **可移植、可验证**:整条数据库迁移链支持 SQLite 离线双向可逆校验,测试无需真实 PostgreSQL。
## 功能模块
| 领域 | 模块 | 能力概要 |
| --- | --- | --- |
| 🔐 认证与权限 | 登录鉴权、用户、角色 | JWT 登录、RBAC 权限点、重置密码、角色授权 |
| 🗂️ 基础主数据 | 物料、客户、供应商、仓库 | 主数据 CRUD 与状态维护 |
| 🛒 采购管理 | 采购订单、采购退货、报价单 | 提交/审批/驳回/收货/关闭状态机;RMA 冲减应付;报价转销售订单 |
| 💰 销售管理 | 销售订单、销售退货 | 提交/审批/驳回/发货/关闭状态机;退货入库并冲减应收 |
| 📦 库存管理 | 实时库存、调拨、盘点、批次/序列号、补货 | 出入库流水、跨仓调拨联动、盘盈盘亏调账、FEFO 建议、安全库存一键转采购 |
| 🏭 生产管理 | BOM、工单、领料、MRP、质检 | 多层 BOM 展开、工单完工成本归集+入库、MRP 净需求、IQC/FQC/OQC 质检判定 |
| 🧾 财务管理 | 结算账户、往来台账、发票、收付款 | 应收/应付台账、发票登记、收付款核销 |
| 📊 成本与资产 | 成本中心、成本报表、会计期间、固定资产、折旧 | 生产成本/毛利/估值/差异/约当报表、期末结转重开、按月批量计提折旧 |
| 📚 总账与凭证 | 会计科目、记账凭证、凭证模板、科目映射 | 凭证 CRUD/过账/反过账、科目余额表与明细账、模板套用、业务事件自动过账 |
| 🏠 系统 | 首页看板、健康检查 | 经营数据概览、服务健康探针 |
> 后端共 **36** 个接口模块、**20** 个 ORM 模型域;前端为每个模块提供对应的管理页面。
## 技术栈
### 后端
- **框架**:FastAPI + Uvicorn(ASGI)
- **ORM / 迁移**:SQLAlchemy 2.0 + Alembic
- **数据库**:PostgreSQL(psycopg2 驱动);测试与离线校验兼容 SQLite
- **校验 / 配置**:Pydantic v2 + pydantic-settings
- **安全**:python-jose(JWT)+ passlib/bcrypt(密码哈希)
- **质量**:ruff(lint)、mypy(类型检查)、pytest(测试)
### 前端
- **框架**:Vue 3.5(`