ocean_project_manager/docs/产品设计文档.md

# 项目信息管理系统 - 产品设计文档

## 1. 项目概述

### 1.1 项目背景
开发一个基于BS架构的项目信息管理系统，用于管理电力工程项目的合同、编号、名称、预算、付款等信息。系统支持多部门协作，市场部用户可以新建项目，其他部门用户可以填写和更新项目信息。

### 1.2 产品目标
- 实现工程项目信息的集中管理
- 支持多部门协同工作
- 提供完善的数据统计和分析功能
- 确保数据的准确性和安全性

### 1.3 产品特点
- 轻量级架构，适合小并发场景
- 无需复杂配置，降低使用门槛
- 基于角色的权限控制（RBAC）
- 简单易用的用户界面
- 数据初始化在部署时完成，无需手动导入

## 2. 功能需求

### 2.1 用户管理

#### 2.1.1 登录功能
- 用户名/密码登录
- 记住密码功能
- 用户登出功能

#### 2.1.2 用户管理（管理员）
- 创建新用户：设置用户名、密码、部门、角色
- 编辑用户信息
- 删除用户
- 重置用户密码
- 查看用户列表

#### 2.1.3 用户角色
- **管理员**：拥有所有权限
- **市场部用户**：创建项目、查看项目、编辑自己的项目
- **其他部门用户**：查看项目、编辑项目信息（如付款、成本、进度等）

### 2.2 项目管理

#### 2.2.1 市场部权限
- **创建项目**：填写项目基本信息
- **查看项目**：浏览所有项目列表和详情
- **编辑项目**：修改自己创建的项目

#### 2.2.2 其他部门权限
- **查看项目**：浏览所有项目列表和详情
- **更新项目**：填写和更新项目信息（成本、财务、进度等）

#### 2.2.3 项目信息分类

**基本信息：**
- 合同编号
- 供电局项目合同编号
- 项目名称
- 子项信息（个数、编码）
- 投资和合同金额
- 工程类别（基建/业扩/客户/营销/检修）
- 业主信息（单位、联系人）
- 中标形式

**项目时间：**
- 签订日期
- 开工日期
- 计划竣工日期
- 实际竣工日期

**成本管理：**
- 总体成本控制
- 人工成本（控制、计划、实付）
- 材料成本（控制、应付、实际、实付）
- 其他费用（控制、应付、实际）

**合同和财务：**
- 合同金额
- 质保金（金额、比例、到期日、退还日期）
- 结算金额
- 税金
- 利润（计划、实际）

**收款和付款：**
- 项目进度
- 应收款和开票
- 实际收款和收款完成率
- 应付款和实际付款
- 未收款和付款完成率

**结算信息：**
- 成本结算金额
- 各类费用结算（人工、材料、其他）
- 到期结算项目统计

**项目管理：**
- 所属项目部
- 项目负责人
- 工程款拨付方式
- 存在的问题
- 建议措施
- 备注

#### 2.2.4 工程类别
- 基建工程
- 业扩工程
- 客户工程
- 营销工程
- 检修、技改、应急抢修项目

#### 2.2.5 项目状态说明
项目数据本身反映了项目的真实状态：
- 未开工：没有开工日期
- 进行中：已开工但未竣工
- 已完成：有实际竣工日期
- 已结算：有结算金额
- 质保期中：质保期未到期
- 已退质保金：已退还质保金

### 2.3 数据查询和统计

#### 2.3.1 项目列表查询
- 分页浏览项目列表
- 按合同编号搜索
- 按工程类别筛选
- 按所属项目部筛选
- 按签订日期范围筛选
- 按合同金额范围筛选
- 按关键词搜索（项目名称、业主单位）
- 排序功能（按签订日期、合同金额等）

#### 2.3.2 项目统计
- **基础统计**：
  - 项目总数
  - 总投资金额
  - 总合同金额
  - 总收款金额
  - 总付款金额
  - 平均收款完成率
  - 平均付款完成率
  - 平均项目进度

- **分组统计**：
  - 按工程类别统计（每个类别的项目数量和金额）
  - 按所属项目部分组统计

- **时间维度统计**：
  - 按日统计项目数量和金额
  - 按月统计项目数量和金额
  - 按年统计项目数量和金额

### 2.4 权限控制

#### 2.4.1 角色权限矩阵

| 功能 | 管理员 | 市场部 | 其他部门 |
|------|--------|--------|---------|
| 登录系统 | ✓ | ✓ | ✓ |
| 创建用户 | ✓ | ✗ | ✗ |
| 编辑用户信息 | ✓ | ✗ | ✗ |
| 删除用户 | ✓ | ✗ | ✗ |
| 查看用户列表 | ✓ | ✗ | ✗ |
| 重置用户密码 | ✓ | ✗ | ✗ |
| 创建项目 | ✓ | ✓ | ✗ |
| 编辑项目 | ✓ | ✓ | 部分 |
| 删除项目 | ✓ | 部分 | ✗ |
| 查看所有项目 | ✓ | ✓ | ✓ |
| 查看项目详情 | ✓ | ✓ | ✓ |
| 查看项目统计 | ✓ | ✓ | ✓ |

**注**：
- "部分"表示只能编辑自己创建的项目
- 其他部门用户只能编辑项目的财务、成本、进度等字段，不能修改基础信息

#### 2.4.2 字段级权限
- **市场部用户**：可以编辑自己创建项目的所有字段
- **其他部门用户**：只能编辑以下字段：
  - 成本管理相关字段
  - 收款和付款相关字段
  - 结算信息相关字段
  - 项目管理相关字段
  - 不能修改：合同编号、项目名称、工程类别、业主信息等基础字段

## 3. 用户界面

### 3.1 界面设计原则
- 简洁易用，操作直观
- 符合用户使用习惯
- 信息展示清晰
- 响应式设计，支持不同屏幕尺寸

### 3.2 主要页面

#### 3.2.1 登录页
- 简洁的登录表单
- 用户名和密码输入框
- 记住密码选项
- 错误提示

#### 3.2.2 主布局
- 顶部导航栏
  - Logo
  - 用户信息显示
  - 登出按钮
- 侧边栏菜单
  - 仪表盘
  - 项目管理
  - 用户管理（仅管理员）
  - 项目统计

#### 3.2.3 仪表盘
- 项目统计卡片
  - 项目总数
  - 进行中项目数
  - 已完成项目数
  - 总合同金额
  - 总收款金额
  - 总付款金额
- 最近项目列表
- 快速操作入口
- 项目图表展示

#### 3.2.4 用户管理页（仅管理员）
- 用户列表表格
- 创建新用户按钮
- 编辑用户信息
- 删除用户
- 重置用户密码
- 搜索和筛选功能
- 分页功能

#### 3.2.5 项目列表页
- 项目列表表格
- 多条件筛选（工程类别、项目部、日期范围、金额范围）
- 关键词搜索
- 排序功能
- 创建新项目按钮
- 分页功能

#### 3.2.6 项目详情页
- 项目基本信息展示
- 成本管理信息
- 财务信息
- 收款和付款信息
- 结算信息
- 项目管理信息
- 编辑按钮（有权限时显示）
- 删除按钮（有权限时显示）

#### 3.2.7 项目表单页
- 分组显示表单字段
- 必填字段标记
- 表单验证
- 保存和取消按钮
- 自动保存功能（可选）

#### 3.2.8 项目统计页
- 基础统计展示
- 分组统计图表
- 时间维度统计图表
- 导出统计报表

### 3.3 界面风格
- 使用企业级UI组件
- 简洁、专业的设计风格
- 统一的色彩搭配
- 清晰的视觉层次

## 4. 数据安全和隐私

### 4.1 用户隐私
- 用户密码加密存储
- 敏感信息（如密码）在传输过程中加密
- 用户信息只能由授权人员查看
- 提供密码重置功能

### 4.2 数据安全
- 防止数据泄露
- 定期数据备份
- 数据访问控制
- 操作日志记录

### 4.3 使用规范
- 定期修改密码
- 不泄露账号密码
- 遵守数据使用规范
- 及时报告安全问题

## 5. 系统性能

### 5.1 响应速度
- 页面加载快速（< 3秒）
- 查询结果及时显示（< 2秒）
- 表单保存流畅（< 1秒）

### 5.2 系统稳定性
- 系统稳定运行
- 偶发错误能够恢复
- 数据不会丢失

### 5.3 并发支持
- 支持多个用户同时使用
- 不会因为用户增多而卡顿

## 6. 使用帮助

### 6.1 快速入门
1. 使用用户名和密码登录系统
2. 查看仪表盘了解项目概况
3. 点击"项目管理"查看项目列表
4. 根据权限创建或编辑项目
5. 使用筛选和搜索功能查找项目

### 6.2 常见问题

**Q: 忘记密码怎么办？**
A: 联系管理员重置密码。

**Q: 如何导出项目数据？**
A: 在项目列表页面使用"导出"功能。

**Q: 能否同时编辑多个项目？**
A: 目前系统不支持批量编辑，请逐个编辑。

**Q: 项目创建后能否修改工程类别？**
A: 可以，但有权限限制，请联系管理员。

### 6.3 联系支持
- 技术支持：提供技术帮助和问题解答
- 系统管理员：负责用户管理和权限分配
- 产品经理：负责产品需求收集和反馈

## 7. 数据来源

### 7.1 初始数据
系统初始数据在部署时直接写入数据库，包括：
- 默认管理员账号
- 基础项目分类信息
- 示例项目数据（可选）

部署完成后，用户可以直接使用系统，无需手动导入数据。

### 7.2 工程分类
根据业务需求，工程项目分为以下类别：
- 基建工程：基础设施建设相关的工程
- 业扩工程：业务扩展相关的工程
- 客户工程：客户委托的工程项目
- 营销工程：市场推广相关的工程
- 检修工程：设备检修、技改、应急抢修项目

## 8. 未来扩展

### 8.1 功能扩展
- 项目附件上传（文件、图片）
- 操作日志记录
- 消息通知功能
- 移动端支持
- 报表定制功能

### 8.2 用户体验优化
- 表单自动保存
- 批量操作功能
- 快捷操作入口
- 个性化设置

### 8.3 数据分析增强
- 更多的统计图表
- 数据趋势分析
- 预警功能
- 智能推荐

## 9. 相关文档

### 9.1 产品文档
- [UI设计规范](ui-design-spec.md) - 界面设计规范
- [团队协作规范](TEAM-COLLABORATION.md) - 团队协作流程

### 9.2 技术文档
- [技术架构文档](技术架构文档.md) - 系统技术实现
- [后端架构设计](后端架构设计.md) - 后端技术详情
- [API文档](api.md) - 接口文档

**注**: 以上技术文档供开发人员参考，普通用户无需了解。

---

**文档维护**: 产品经理、技术总监
**文档类型**: 产品设计文档（PRD）
**最后更新**: 2026-01-25