# xinghuierp

**Repository Path**: deathbug/xinghuierp

## Basic Information

- **Project Name**: xinghuierp
- **Description**: xinghui erp 2026 v3
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-15
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 康涞医药办公系统 - 前端项目 (Phase 3)

## 技术栈

| 组件 | 技术选型 | 版本 |
|------|----------|------|
| 框架 | Vue 3 + TypeScript | 3.4+ |
| 构建工具 | Vite | 5.x |
| UI 框架 | Element Plus | 2.x |
| 状态管理 | Pinia | 2.x |
| 路由 | Vue Router | 4.x |
| HTTP | Axios | 1.x |

## 项目结构

```
phase3-frontend/
├── src/
│   ├── api/              # API 封装
│   │   ├── request.ts    # Axios 实例和拦截器
│   │   ├── auth.ts       # 认证 API
│   │   ├── users.ts      # 用户 API
│   │   └── products.ts   # 产品 API
│   ├── views/            # 页面组件
│   │   ├── Login.vue     # 登录页
│   │   ├── Dashboard.vue # 首页
│   │   ├── Users.vue     # 用户管理
│   │   ├── Products.vue  # 产品管理
│   │   ├── Departments.vue # 部门管理
│   │   ├── Warehouses.vue  # 仓库管理
│   │   └── NotFound.vue  # 404 页
│   ├── components/       # 公共组件
│   ├── stores/           # Pinia 状态管理
│   │   └── auth.ts       # 认证状态
│   ├── router/           # 路由配置
│   │   └── index.ts
│   ├── types/            # TypeScript 类型定义
│   │   └── index.ts
│   ├── App.vue           # 根组件
│   └── main.ts           # 入口文件
├── package.json
├── vite.config.ts        # Vite 配置
├── tsconfig.json         # TypeScript 配置
└── README.md
```

## 快速开始

### 安装依赖

```bash
npm install
```

### 启动开发服务器

```bash
npm run dev
```

访问 http://localhost:3000

### 构建生产版本

```bash
npm run build
```

### 预览生产构建

```bash
npm run preview
```

## API 配置

开发环境下，Vite 代理会转发 `/api` 请求到后端服务：

- **开发环境**: `http://localhost:3000/api` → `http://localhost:8080/api`
- **生产环境**: 需要配置实际后端 API 地址

## 页面路由

| 页面 | 路由 | 说明 |
|------|------|------|
| 登录页 | `/login` | 用户登录 |
| 首页 | `/` | 仪表盘 |
| 用户管理 | `/users` | 用户 CRUD |
| 产品管理 | `/products` | 产品 CRUD |
| 部门管理 | `/departments` | 部门列表 |
| 仓库管理 | `/warehouses` | 仓库列表 |
| 404 页 | `*` | 未找到页面 |

## 认证流程

1. 用户在登录页输入用户名和密码
2. 调用 `POST /api/auth/login` 获取 Token
3. Token 存储在 localStorage 和 Pinia store 中
4. 后续请求自动携带 `Authorization: Bearer <token>`
5. 401 响应自动跳转到登录页

## 开发规范

- 使用 TypeScript 严格模式
- 组件使用 `<script setup>` 语法
- API 调用统一封装在 `src/api/` 目录
- 状态管理使用 Pinia
- UI 组件统一使用 Element Plus

## 待办事项

- [ ] 对接后端 API 进行完整测试
- [ ] 完善部门和仓库管理页面
- [ ] 添加更多业务模块
- [ ] 单元测试
- [ ] E2E 测试

---

**创建时间**: 2026-03-15  
**负责人**: 前端开发