# backend-system

**Repository Path**: darkcityx/backend-system

## Basic Information

- **Project Name**: backend-system
- **Description**: 后台管理系统
pnpm+monorepo+微服务+vite+vue3+ts
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2024-02-01
- **Last Updated**: 2025-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Backend System 项目结构

## 目录结构

```
backend-system/
├── apps/                           # 应用程序目录
│   └── portal-project/            # 门户主应用
│       ├── src/                   # 应用源码
│       ├── package.json           # 应用依赖配置
│       └── vite.config.ts         # 构建配置
│
├── packages/                       # 公共包目录
│   ├── ui-components/             # UI组件库
│   │   ├── src/                   # 组件源码
│   │   │   ├── LayoutPage/        # 布局页面组件
│   │   │   ├── NavMenu/           # 导航菜单组件
│   │   │   ├── TableSection/      # 表格组件
│   │   │   ├── DrawerBox/         # 抽屉组件
│   │   │   └── index.ts           # 组件库入口
│   │   └── package.json           # 组件库配置
│   │
│   └── common-utils/              # 公共工具库
│       ├── src/                   # 工具源码
│       │   ├── hooks/             # Vue Hooks
│       │   │   ├── useBoolean.ts  # 布尔值状态管理
│       │   │   ├── form.ts        # 表单相关hooks
│       │   │   └── index.ts       # hooks入口
│       │   ├── utils/             # 工具函数
│       │   │   └── modules/       # 工具模块
│       │   └── index.ts           # 工具库入口
│       └── package.json           # 工具库配置
│
├── pnpm-workspace.yaml            # pnpm工作空间配置
├── package.json                   # 根项目配置
└── PROJECT_STRUCTURE.md           # 项目结构说明（本文件）
```

## 包说明

### 应用层 (apps/)

- **portal-project**: 主要的门户应用，使用Vue 3 + TypeScript + Element Plus

### 库层 (packages/)

- **@backend-system/ui-components**: UI组件库，提供可复用的Vue组件
- **@backend-system/common-utils**: 公共工具库，提供通用的hooks和工具函数

## 工作空间配置

通过 `pnpm-workspace.yaml` 配置，支持：

- `apps/*` - 应用程序
- `packages/*` - 公共包

## 依赖关系

```
portal-project
├── @backend-system/ui-components (workspace)
└── @backend-system/common-utils (workspace)
```

## 开发命令

```bash
# 启动门户项目开发服务器
pnpm dev:portal

# 构建门户项目
pnpm build:portal

# 构建UI组件库
pnpm build:ui

# 构建工具库
pnpm build:utils

# 构建所有包
pnpm build:all
```

## 优势

1. **清晰的职责分离**: 应用和库分别管理
2. **便于维护**: 公共逻辑集中管理
3. **易于扩展**: 可以轻松添加新的应用或库
4. **版本控制**: 每个包可以独立版本管理
5. **复用性强**: 公共包可以被多个应用使用