# conduit_admin

**Repository Path**: coderxslee/conduit_admin

## Basic Information

- **Project Name**: conduit_admin
- **Description**: No description available
- **Primary Language**: Dart
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Conduit Admin

## 简介

`conduit_admin` 是一套基于 **Dart (Conduit)** 后端框架与 **Vue 3 + Arco Design** 前端框架构建的全栈管理后台解决方案。该项目实现了前后端完全分离，提供了完善的权限控制、动态路由、Mock 数据模拟以及丰富的业务组件，旨在帮助开发者快速搭建企业级管理系统。

## 技术栈

### 后端 (Backend)
- **语言**: Dart
- **框架**: [Conduit](https://conduitframework.com/) (成熟的 Dart REST 框架)
- **特性**: 支持数据库 ORM、身份认证、中间件等

### 前端 (Frontend)
- **框架**: Vue 3 (Composition API + TypeScript)
- **UI 组件库**: [Arco Design Vue](https://arco.design/vue)
- **构建工具**: Vite
- **状态管理**: Pinia
- **样式方案**: Less / Scss

## 项目结构

```
conduit_admin/
├── backend/                 # 后端 API 服务
│   ├── bin/                 # 程序入口文件
│   ├── lib/                 # 核心业务逻辑代码 (Channel, Controller 等)
│   ├── test/                # 单元测试与集成测试
│   ├── config.yaml          # 应用配置 (数据库连接、端口等)
│   └── pubspec.yaml         # Dart 项目依赖配置
│
└── frontend/web/            # 前端 Web 应用
    ├── src/
    │   ├── apis/            # 接口定义与类型声明
    │   ├── components/      # 公共业务组件 (包含自定义的 Gi- 系列组件)
    │   ├── layouts/         # 页面整体布局组件
    │   ├── views/           # 页面视图 (系统管理、业务功能等)
    │   ├── stores/          # Pinia 状态数据
    │   ├── hooks/           # 通用组合式函数 (useTable, useDict 等)
    │   ├── router/          # 路由配置与守卫
    │   └── styles/          # 全局样式与 Arco Design 样式覆盖
    ├── mock/                # Mock 数据模拟
    └── public/              # 静态资源文件
```

## 快速开始

### 1. 环境准备

- **后端**: 确保已安装 [Dart SDK](https://dart.dev/get-dart)。
- **前端**: 确保已安装 [Node.js](https://nodejs.org/) (推荐 v18+) 和 [pnpm](https://pnpm.io/)。

### 2. 运行后端

```bash
# 进入后端目录
cd backend

# 安装依赖
dart pub get

# 启动服务 (默认读取 config.yaml 配置)
dart run
```
> 后端服务启动后，API 端口默认为 `8888` (具体取决于 config 配置)。

### 3. 运行前端

```bash
# 进入前端目录
cd frontend/web

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev
```
> 前端启动后，访问 `http://localhost:5173` (或终端显示的端口) 即可预览。

## 核心功能与规范

- **Gi 组件**: 前端封装了一套以 `Gi` 前缀开头的业务组件（如 `GiButton`, `GiTable`, `GiPageLayout`），结合 Arco Design 原子组件，提供更便捷的开发体验。
- **Mock 数据**: 项目内置完整的 Mock 数据（位于 `mock/` 目录），无需启动后端即可进行前端功能开发与调试。
- **RBAC 权限**: 实现了基于角色的访问控制，包含用户、角色、菜单、权限的完整管理链路。
- **代码规范**:
  - 前端代码强制遵循 TypeScript 规范。
  - 组件文件使用 `PascalCase` 命名，目录使用 `kebab-case`。
  - Vue 使用 `<script setup>` 语法糖。

## 开源协议

本项目基于 [MIT](LICENSE) 协议开源。