# lqerp

**Repository Path**: reayun/lqerp

## Basic Information

- **Project Name**: lqerp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-18
- **Last Updated**: 2025-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Lq 企业管理系统

基于ABP Framework的企业级低代码/无代码平台。

## 项目结构

```
lqerp/
├── backend/                          # 后端项目
│   ├── Lq.Domain/                   # 领域层
│   ├── Lq.Application.Contracts/    # 应用契约层
│   ├── Lq.Application/              # 应用层
│   ├── Lq.EntityFrameworkCore/       # EF Core数据访问层
│   ├── Lq.DbMigrator/               # 数据库迁移工具
│   └── Lq.Api/                      # API层
├── frontend/                         # 前端项目
│   └── lq-web/                      # Vue 3前端应用
└── docs/                            # 文档
```

## 技术栈

### 后端
- **.NET**: 10.0
- **ABP Framework**: 10.0.1
- **Entity Framework Core**: 10.0.0
- **主要依赖包**:
  - Volo.Abp.* (10.0.1) - ABP Framework 核心模块
  - System.Linq.Dynamic.Core (1.6.7) - 动态 LINQ 查询
  - Microsoft.CodeAnalysis.CSharp.Scripting (4.8.0) - C# 脚本编译
  - Serilog (4.1.0) - 结构化日志
  - Swashbuckle.AspNetCore (9.0.4) - Swagger/OpenAPI
- **数据库支持**: SQL Server、MySQL、PostgreSQL

### 前端
- **Vue**: 3.4.0 (Composition API)
- **TypeScript**: 5.3.3
- **构建工具**: Vite 5.0.8
- **UI框架**: Element Plus 2.4.4
- **状态管理**: Pinia 2.1.7
- **路由**: Vue Router 4.2.5
- **HTTP客户端**: Axios 1.6.2
- **其他**: VueDraggable 4.1.0 (拖拽排序)

## 快速开始

### 后端

1. 还原NuGet包：
```bash
dotnet restore lqerp.sln
```

2. 更新数据库：
```bash
cd backend/Lq.DbMigrator
dotnet run
```

3. 运行API：
```bash
cd backend/Lq.Api
dotnet run
```

API将在 `https://localhost:5001` 运行，Swagger文档在 `https://localhost:5001/swagger`

### 前端

1. 安装依赖：
```bash
cd frontend/lq-web
npm install
```

2. 运行开发服务器：
```bash
npm run dev
```

前端将在 `http://localhost:5173` 运行

## 核心功能

### 已实现 ✅

#### 基础设施
- ✅ ABP Framework 10.0.1 集成
- ✅ .NET 10.0 升级
- ✅ 项目结构搭建（DDD分层架构）
- ✅ 多数据库支持（SQL Server、MySQL、PostgreSQL）

#### 权限系统
- ✅ 权限规则实体（PermissionRule）
- ✅ 动态群组实体（DynamicGroup）
- ✅ 权限决策引擎完整实现
  - ✅ ABP 权限系统集成（功能权限）
  - ✅ ABAC 权限检查（数据权限）
  - ✅ 字段级权限检查
  - ✅ 数据过滤条件生成
- ✅ 规则编译器基础框架
- ✅ 用户上下文辅助类

#### 组织管理模块
- ✅ 组织实体（支持无限层级）
- ✅ 组织路径优化（Path字段，快速查询上级/下级）
- ✅ 组织应用服务（CRUD、树查询、用户管理）
- ✅ 组织树辅助类（OrganizationTreeHelper）
- ✅ 组织 API（RESTful接口）

### 待实现 ⏳

#### 权限系统完善
- ⏳ 权限缓存服务
- ⏳ 规则编译器完整实现
- ⏳ ABP Identity 集成（用户角色）

#### 表单系统
- ⏳ FormRender 集成
- ⏳ 表单定义实体和管理
- ⏳ 表单设计器
- ⏳ 表单数据管理

#### 消息通知模块
- ⏳ 消息实体和服务
- ⏳ 多渠道发送（站内信、邮件、微信、SMS）
- ⏳ 消息模板引擎

#### 动态业务功能
- ⏳ 动态表结构生成
- ⏳ 业务功能定义和执行

#### 前端功能
- ⏳ SPA/非SPA模式切换
- ⏳ UI框架适配层
- ⏳ 组织管理页面
- ⏳ 权限管理页面
- ⏳ 表单管理页面

#### 工作流模块（后续集成）
- ⏳ 工作流引擎实现
- ⏳ 工作流前端页面

详细进度请参考：[项目进度总结](docs/项目进度总结.md)

## 数据库配置

在 `backend/Lq.Api/appsettings.json` 中配置数据库连接字符串和提供程序：

```json
{
  "ConnectionStrings": {
    "Default": "Server=localhost;Database=lq;UID=sa;PWD=P@ssw0rd;..."
  },
  "Database": {
    "Provider": "SqlServer"  // 可选值: SqlServer, MySql, PostgreSQL
  }
}
```

### 数据库提供程序配置示例

**SQL Server:**
```json
{
  "ConnectionStrings": {
    "Default": "Server=localhost;Database=lq;UID=sa;PWD=P@ssw0rd;MultipleActiveResultSets=true;TrustServerCertificate=True;"
  },
  "Database": {
    "Provider": "SqlServer"
  }
}
```

**MySQL:**
```json
{
  "ConnectionStrings": {
    "Default": "Server=localhost;Database=lq;Uid=root;Pwd=password;"
  },
  "Database": {
    "Provider": "MySql"
  }
}
```

**PostgreSQL:**
```json
{
  "ConnectionStrings": {
    "Default": "Host=localhost;Database=lq;Username=postgres;Password=password;"
  },
  "Database": {
    "Provider": "PostgreSQL"
  }
}
```

## 开发指南

### 架构文档

- **系统架构文档**: [docs/系统架构文档.md](docs/系统架构文档.md) - 完整的系统架构、包依赖、项目结构说明
- **项目进度**: [docs/项目进度总结.md](docs/项目进度总结.md) - 已完成和待完成功能清单
- **数据库脚本生成**: [docs/数据库脚本生成操作指南.md](docs/数据库脚本生成操作指南.md) - 数据库迁移和脚本生成指南

## 许可证

待定