# PMP_1

**Repository Path**: obslight/pmp_1

## Basic Information

- **Project Name**: PMP_1
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-07
- **Last Updated**: 2026-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SPARK PMP — 数智化项目管理系统

**知进度 · 控成本 · 防风险 · 提质量**

SPARK PMP 是一套面向中大型组织的全生命周期数智化项目管理系统，帮助组织统一管理项目「人员、任务、进度、合同、收支、文档」等信息，让项目中的各类事项井然有序。

## 核心能力

| 模块 | 能力 |
|------|------|
| 项目看板 | 项目全维度信息统一看板，支持表格/卡片/甘特图/思维导图多视图 |
| 计划任务 | 任务编制、甘特计划、看板协同、依赖关系、任务审批与催办 |
| 项目成本 | 预算编制管控、工时核算、费用报销归集、成本利润实时核算 |
| 风险质量 | 风险库、风险识别预警、问题处置闭环、整改全周期记录 |
| 项目文件 | 文档归集、分类、分享、电子签署与电子归档 |
| AI 智能助手 | 智能填报、方案编制、任务自动生成、周报撰写、智能问答、风险监控 |
| 客户管理 | 客户库、联系人、联系记录、查重、公海、监控、统计 |
| 周报日报 | 工作报告提交、审批、评论、统计与监控 |
| 流程引擎 | 审批流程驱动项目业务联动 |
| 统计分析 | 多维度数据统计、可视化报表、趋势分析 |
| 移动适配 | PC / 移动 / H5 多端一体化 |

## 技术栈

- **Vue 3.5** + **TypeScript** + **Vite 6**
- **Element Plus** + **Vxe Table** — UI 组件
- **ECharts** — 数据可视化
- **Frappe Gantt** — 甘特图
- **Simple Mind Map** — 思维导图
- **Vue Router 4** — 路由

## 快速开始

```bash
pnpm install
pnpm run dev
```

本地访问：http://127.0.0.1:6180/

官网门户首页：`/official/home`；业务工作台首页：`/home`；项目库：`/projects/list/mine`。

## 构建与验证

```bash
pnpm run verify       # 设计 token 生成与校验 + 类型检查 + lint + 测试
pnpm run build        # 完整验证通过后执行生产构建
pnpm run preview      # 本地预览构建产物
pnpm run type-check   # 仅类型检查
pnpm run lint         # 仅 lint 检查
pnpm run test         # 当前执行视觉回归测试
```

## 架构

```
src/
├── app/             # 应用入口、路由、全局样式
├── domains/         # 按业务域划分（project/task/crm/portal/...）
│   └── <domain>/    # views、services、catalog、data、types
└── shared/          # 跨域 API、组件、导航、类型与 mock 基础设施
```

### 分层设计

1. **domains/*/data/** — 各业务域 mock 数据与 catalog
2. **domains/*/services/*Backend.ts** — mock 后端实现
3. **domains/*/services/*Api.ts** — 对外 API 接口，带模拟延迟
4. **domains/*/adapters.ts** — 响应数据 → ViewModel 转换
5. **domains/*/views/** — 只消费 ViewModel，不依赖后端原始字段

后端替换时只需修改各域 `services/` 层，adapter 和 view 保持不变。

## 业务模块

| 应用 | 路由 | 说明 |
|------|------|------|
| 项目管理 | `/projects/list/:scope` | 项目列表（我的/下属/全部/关注/共享/进行中/已结束） |
| 项目甘特图 | `/projects/ganttchart` | 项目任务甘特图 |
| 项目思维导图 | `/projects/mindmap` | 项目-任务树形思维导图 |
| 项目统计 | `/projects/statistics/:scope` | 项目统计报表与图表 |
| 项目成本 | `/projects/cost` | 预算、工时、报销、利润核算 |
| 项目风险 | `/projects/risk` | 风险库、预警、处置闭环 |
| 项目文件 | `/projects/files` | 文档归集与电子归档 |
| AI 助手 | `/projects/assistant` | 智能问答、任务生成、周报撰写 |
| 任务管理 | `/tasks/list/:scope` | 任务列表与模块 |
| 计划报告 | `/plan/:scope` | 周报/月报管理 |
| 日报 | `/blog/:scope` | 日报动态流与统计 |
| 客户管理 | `/crm/customers?scope=:scope` | 客户 CRM |
| 流程/日程/表单/统计/联系人 | `/:moduleKey/:scope` | 全局应用 |

## 验证

```bash
pnpm run verify      # 日常完整质量门
pnpm run build       # 完整质量门 + 生产构建
pnpm run type-check  # 仅类型检查
pnpm run test        # 当前执行视觉回归测试
```

`verify` 通过即视为日常验证通过；发布前执行 `build`。后续可在 `test` 入口下继续接入单元测试或端到端验收脚本。