# ServicePilot

ServicePilot 是“智能客户工单与 SLA 履约管理平台”综合测试实践项目，包含 PRD、测试计划、测试报告、前端 Angular 应用和后端 Node.js/TypeScript/Express 服务。

## 1. 项目结构

```text
ServicePilot/
├─ docs/                  # PRD、测试计划、测试报告、Parse Schema 文档
├─ project/
│  ├─ backend/            # Node.js + TypeScript + Express
│  └─ frontend/           # Angular + GSAP + React 组件
├─ tests/                 # 测试资料目录
└─ personal_reports/      # 个人报告目录
```

## 2. 后端启动

Windows PowerShell 如遇到 `npm.ps1` 执行策略限制，请使用 `npm.cmd`。

```powershell
cd E:\软测\ServicePilot\project\backend
npm.cmd install
copy .env.example .env
npm.cmd run dev
```

后端默认地址：

```text
http://localhost:3000
```

健康检查：

```text
http://localhost:3000/api/health
```

## 3. 前端启动

```powershell
cd E:\软测\ServicePilot\project\frontend
npm.cmd install
npm.cmd start -- --host 127.0.0.1 --port 4201
```

前端访问地址：

```text
http://127.0.0.1:4201
```

常用页面：

```text
http://127.0.0.1:4201/dashboard
http://127.0.0.1:4201/login
http://127.0.0.1:4201/tickets
http://127.0.0.1:4201/sla
http://127.0.0.1:4201/knowledge
http://127.0.0.1:4201/files
http://127.0.0.1:4201/reviews
http://127.0.0.1:4201/test-plan
```

## 4. 测试与构建

后端自动化测试：

```powershell
cd E:\软测\ServicePilot\project\backend
npm.cmd test
```

后端构建：

```powershell
cd E:\软测\ServicePilot\project\backend
npm.cmd run build
```

前端构建：

```powershell
cd E:\软测\ServicePilot\project\frontend
npm.cmd run build
```

构建产物静态预览：

```powershell
cd E:\软测\ServicePilot\project\frontend
D:\nodejs\node.exe scripts\static-preview.cjs
```

静态预览地址：

```text
http://127.0.0.1:4301/dashboard
```

## 5. 文档

重点文档：

```text
docs/02_综合测试计划.md
docs/15_自动化测试分层与大厂UI对标方案.md
docs/16_综合测试执行报告.md
```

## 6. 环境说明

后端 `.env` 需要配置 Parse / Back4App 参数。仓库只提交 `.env.example`，不会提交真实密钥。

如果只是查看前端页面样式，可先启动前端；如果需要登录、工单查询、数据库 CRUD，需要先启动后端并正确配置 `.env`。