# 跨平台ERP系统架构设计 ## 1. 技术栈选择 ### 1.1 前端技术栈 - **框架**: React + TypeScript - **PWA实现**: Workbox + Service Worker - **状态管理**: Redux Toolkit - **UI组件库**: Ant Design - **路由**: React Router - **HTTP客户端**: Axios - **表单处理**: Formik + Yup - **图表库**: ECharts - **国际化**: i18next ### 1.2 后端技术栈 - **语言**: Node.js (TypeScript) - **框架**: NestJS - **ORM**: TypeORM - **认证**: JWT + Passport - **缓存**: Redis - **日志**: Winston - **API文档**: Swagger ### 1.3 数据库 - **主数据库**: PostgreSQL - **缓存数据库**: Redis ### 1.4 部署与DevOps - **容器化**: Docker + Docker Compose - **CI/CD**: GitHub Actions - **监控**: Prometheus + Grafana ## 2. 系统架构设计 ### 2.1 前端架构 #### 2.1.1 PWA架构 - **核心特性**: - 离线访问能力 - 可安装到主屏幕 - 推送通知 - 响应式设计 #### 2.1.2 前端目录结构 ``` /src /assets # 静态资源 /components # 通用组件 /pages # 页面组件 /services # API服务 /store # Redux状态管理 /utils # 工具函数 /hooks # 自定义Hooks /types # TypeScript类型定义 /workers # Web Workers /config # 配置文件 App.tsx # 应用入口 main.tsx # 主渲染文件 service-worker.js # Service Worker manifest.json # PWA配置 ``` ### 2.2 后端架构 #### 2.2.1 分层架构 - **API层**: 处理HTTP请求和响应 - **业务逻辑层**: 实现核心业务逻辑 - **数据访问层**: 与数据库交互 - **基础设施层**: 提供通用功能 #### 2.2.2 后端目录结构 ``` /src /modules /auth # 认证模块 /users # 用户模块 /customers # 客户模块 /suppliers # 供应商模块 /subcontractors # 分包商模块 /projects # 项目模块 /finance # 财务模块 /construction # 施工模块 /exchange # 汇率模块 /products # 商品模块 /quotations # 预算报价模块 /common /filters # 数据过滤器 /guards # 守卫 /interceptors # 拦截器 /pipes # 管道 /decorators # 装饰器 /config # 配置文件 /utils # 工具函数 /database # 数据库配置 main.ts # 应用入口 app.module.ts # 根模块 ``` ### 2.3 数据库设计 #### 2.3.1 核心数据模型 **用户表 (users)** - id: UUID (主键) - username: string (用户名) - password: string (密码哈希) - name: string (姓名) - email: string (邮箱) - role: string (角色) - created_at: timestamp - updated_at: timestamp **角色表 (roles)** - id: UUID (主键) - name: string (角色名称) - description: string (角色描述) - created_at: timestamp - updated_at: timestamp **权限表 (permissions)** - id: UUID (主键) - name: string (权限名称) - description: string (权限描述) - created_at: timestamp - updated_at: timestamp **角色权限关联表 (role_permissions)** - role_id: UUID (外键) - permission_id: UUID (外键) **客户表 (customers)** - id: UUID (主键) - name: string (客户名称) - contact_person: string (联系人) - phone: string (电话) - email: string (邮箱) - address: string (地址) - created_at: timestamp - updated_at: timestamp **供应商表 (suppliers)** - id: UUID (主键) - name: string (供应商名称) - contact_person: string (联系人) - phone: string (电话) - email: string (邮箱) - address: string (地址) - type: string (类型: 本地/中国) - created_at: timestamp - updated_at: timestamp **分包商表 (subcontractors)** - id: UUID (主键) - name: string (分包商名称) - contact_person: string (联系人) - phone: string (电话) - email: string (邮箱) - address: string (地址) - created_at: timestamp - updated_at: timestamp **项目表 (projects)** - id: UUID (主键) - name: string (项目名称) - customer_id: UUID (外键) - contract_number: string (合同编号) - contract_amount: decimal (合同金额) - currency: string (币种) - start_date: date (开始日期) - end_date: date (结束日期) - status: string (状态) - payment_terms: jsonb (付款节点) - created_at: timestamp - updated_at: timestamp **分包表 (subcontracts)** - id: UUID (主键) - project_id: UUID (外键) - subcontractor_id: UUID (外键) - contract_number: string (合同编号) - contract_amount: decimal (合同金额) - currency: string (币种) - payment_terms: jsonb (付款节点) - status: string (状态) - created_at: timestamp - updated_at: timestamp **采购表 (purchases)** - id: UUID (主键) - project_id: UUID (外键) - supplier_id: UUID (外键) - contract_number: string (合同编号) - total_amount: decimal (总金额) - currency: string (币种) - expected_delivery_date: date (预计发货日期) - payment_terms: jsonb (付款节点) - status: string (状态) - created_at: timestamp - updated_at: timestamp **采购商品表 (purchase_items)** - id: UUID (主键) - purchase_id: UUID (外键) - product_id: UUID (外键) - quantity: decimal (数量) - unit_price: decimal (单价) - total_price: decimal (总价) **财务记录表 (financial_records)** - id: UUID (主键) - type: string (类型: 收入/支出) - amount: decimal (金额) - currency: string (币种) - rmb_equivalent: decimal (人民币等价金额) - project_id: UUID (外键, 可为空) - related_id: UUID (外键, 关联具体业务) - related_type: string (关联类型) - status: string (状态) - created_at: timestamp - updated_at: timestamp **汇率表 (exchange_rates)** - id: UUID (主键) - currency: string (币种) - rate: decimal (汇率) - reverse_rate: decimal (反向汇率) - effective_date: date (生效日期) - created_at: timestamp - updated_at: timestamp **商品表 (products)** - id: UUID (主键) - name: string (商品名称) - category_id: UUID (外键) - unit: string (单位) - cost_price: decimal (成本价) - created_at: timestamp - updated_at: timestamp **商品分类表 (product_categories)** - id: UUID (主键) - name: string (分类名称) - parent_id: UUID (外键, 可为空) - created_at: timestamp - updated_at: timestamp **预算报价表 (quotations)** - id: UUID (主键) - customer_id: UUID (外键) - project_name: string (项目名称) - total_amount: decimal (总金额) - currency: string (币种) - status: string (状态) - created_at: timestamp - updated_at: timestamp **预算报价项目表 (quotation_items)** - id: UUID (主键) - quotation_id: UUID (外键) - product_id: UUID (外键) - quantity: decimal (数量) - unit_price: decimal (单价) - total_price: decimal (总价) ### 2.4 安全架构 #### 2.4.1 认证系统 - **JWT认证**: 使用JSON Web Token进行身份验证 - **密码加密**: 使用bcrypt进行密码哈希 - **会话管理**: 基于Token的无状态会话 #### 2.4.2 授权系统 - **基于角色的访问控制 (RBAC)**: 角色分配权限，用户分配角色 - **权限粒度**: 模块级和操作级权限控制 - **动态权限管理**: 支持后台配置权限和流程节点 ## 3. API接口规范 ### 3.1 RESTful API设计 - **基础URL**: `/api/v1` - **HTTP方法**: GET, POST, PUT, PATCH, DELETE - **资源命名**: 复数形式，使用小写字母和连字符 - **版本控制**: 通过URL路径进行版本控制 ### 3.2 响应格式 ```json { "success": true, "data": {}, "message": "操作成功", "errors": [] } ``` ### 3.3 错误处理 - **400 Bad Request**: 请求参数错误 - **401 Unauthorized**: 未授权 - **403 Forbidden**: 禁止访问 - **404 Not Found**: 资源不存在 - **500 Internal Server Error**: 服务器内部错误 ### 3.4 分页规范 ```json { "success": true, "data": { "items": [], "pagination": { "total": 100, "page": 1, "pageSize": 10, "totalPages": 10 } } } ``` ## 4. 财务串通管理设计 ### 4.1 核心功能 - **统一财务视图**: 所有收入支出既能从单个项目查看，又能从公司总账目中查看 - **数据一致性**: 确保财务数据在不同视图中的一致性 - **多币种支持**: 支持人民币、老挝基普、泰铢、美元的汇率换算 - **财务流程**: 预支、报销、核销流程的完整实现 ### 4.2 实现方案 - **财务记录中心化**: 所有财务交易通过统一的财务记录表进行管理 - **关联关系**: 通过related_id和related_type字段关联具体业务 - **项目维度**: 通过project_id字段实现项目级财务视图 - **公司维度**: 不设置project_id的记录为公司级财务 - **汇率换算**: 实时根据汇率表进行币种换算 ## 5. 权限管理功能设计 ### 5.1 角色设计 - **超级管理员**: 拥有所有权限 - **管理员**: 拥有大部分管理权限 - **财务人员**: 拥有财务管理权限 - **项目经理**: 拥有项目管理权限 - **采购人员**: 拥有采购管理权限 - **施工人员**: 拥有施工管理权限 ### 5.2 权限设计 - **用户管理**: 创建、编辑、删除用户 - **角色管理**: 创建、编辑、删除角色 - **权限管理**: 分配和管理权限 - **客户管理**: 创建、编辑、删除客户 - **供应商管理**: 创建、编辑、删除供应商 - **分包商管理**: 创建、编辑、删除分包商 - **项目管理**: 创建、编辑、删除项目 - **财务管理**: 处理财务流程 - **施工管理**: 管理施工过程 - **汇率管理**: 设置和管理汇率 - **商品管理**: 创建、编辑、删除商品 - **预算报价管理**: 创建、编辑、删除预算报价 ### 5.3 流程节点管理 - **可配置流程**: 支持在后台配置审批流程节点 - **流程状态**: 待审批、审批中、已批准、已拒绝 - **通知机制**: 流程状态变更时发送通知 ## 6. 系统集成与扩展性 ### 6.1 预留接口 - **小工具接口**: 支持集成电工计算器等小工具 - **进销存系统接口**: 预留与后续进销存系统的集成接口 - **第三方服务接口**: 支持集成支付、物流等第三方服务 ### 6.2 扩展性设计 - **模块化架构**: 各功能模块独立设计，便于扩展 - **插件机制**: 支持插件式功能扩展 - **API版本控制**: 确保接口变更的向后兼容性 ## 7. 性能优化策略 ### 7.1 前端优化 - **代码分割**: 按需加载模块 - **缓存策略**: 合理使用浏览器缓存 - **图片优化**: 压缩和懒加载图片 - **PWA缓存**: 使用Service Worker缓存静态资源 ### 7.2 后端优化 - **数据库索引**: 合理创建数据库索引 - **查询优化**: 优化SQL查询 - **缓存机制**: 使用Redis缓存热点数据 - **异步处理**: 非关键操作使用异步处理 ### 7.3 系统监控 - **性能监控**: 监控系统响应时间和资源使用 - **错误监控**: 实时捕获和分析错误 - **日志管理**: 集中管理系统日志 ## 8. 部署方案 ### 8.1 本地开发环境 - **Docker Compose**: 快速搭建开发环境 - **热重载**: 支持代码修改实时预览 ### 8.2 生产环境 - **容器化部署**: 使用Docker容器部署 - **负载均衡**: 支持多实例部署 - **HTTPS**: 启用HTTPS加密 - **自动备份**: 定期备份数据库 ## 9. 总结 本架构设计采用了现代化的技术栈和设计理念，实现了一个跨平台的ERP系统，支持财务串通管理和权限管理功能。系统具有良好的扩展性和可维护性，能够满足企业的业务需求，并为后续功能扩展预留了接口。 通过PWA技术，系统可以在Web端和移动端提供一致的用户体验，支持离线访问和安装到主屏幕。后端采用NestJS框架，提供了强大的API服务和业务逻辑处理能力。数据库使用PostgreSQL，确保数据的可靠性和一致性。 系统的财务串通管理功能确保了所有收入支出既能从单个项目查看，又能从公司总账目中查看，实现了财务数据的完整性和一致性。权限管理功能支持基于角色的访问控制和动态权限配置，满足不同用户的权限需求。 本架构设计为跨平台ERP系统的开发提供了清晰的指导，确保系统能够按时、按质完成，并满足用户的需求。