# 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 企业资源计划系统 **开箱即用的中小型制造企业 ERP —— 采购 · 销售 · 库存 · 生产 · 财务一体化**

Python FastAPI SQLAlchemy Vue TypeScript PostgreSQL Tests

前后端分离 · 单体仓库(Monorepo) · RBAC 权限 · 自动凭证过账

--- ## 目录 - [项目简介](#项目简介) - [功能模块](#功能模块) - [技术栈](#技术栈) - [架构设计](#架构设计) - [快速开始](#快速开始) - [项目结构](#项目结构) - [质量门禁](#质量门禁) - [文档](#文档) - [开发约定](#开发约定) ## 项目简介 本项目是一套面向中小型制造企业的 **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(`