# project_quadrant_tracker

**Repository Path**: alexjunqi/project_quadrant_tracker

## Basic Information

- **Project Name**: project_quadrant_tracker
- **Description**: 基于erpnext的任务扩展
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: 16.01.01
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 14
- **Created**: 2025-11-20
- **Last Updated**: 2026-08-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目进度管理 (Project Progress Management)

基于 Frappe V16 框架开发的任务管理应用，采用经典的**艾森豪威尔矩阵（Eisenhower Matrix）** 理论，帮助个人和团队高效管理项目进度。

同时，本应用还承担 **Drive / Gameplan / Wiki 三个第三方应用的中文汉化与翻译维护** 工作。

---

## 🌟 核心理念

通过**重要性**与**紧急程度**两个维度，将所有任务划分为四个象限：
- **Q1 (重要且紧急)**：立即处理。
- **Q2 (重要不紧急)**：规划执行（核心重点）。
- **Q3 (紧急不重要)**：授权委派。
- **Q4 (不重要不紧急)**：尽量减少。

---

## ✨ 主要特性

### 0.1 人员看板与一键研发周报 [V16.1 New]
个人仪表板新增 **👥 人员** 页签（研发领导/System Manager 登录后默认首屏）：
- **KPI 数字卡**：进行中任务 / 逾期未闭环 / 本周完成 / 完成率，逾期红框预警。
- **层级钻取看板（千人规模设计）**：按部门树逐级下钻（研发 → 机构/软件/电气 → 部门 → 科室），面包屑导航随时返回上级；每列聚合该节点整个子树的负荷数据。
- **成员泳道**：成员按负荷排序（🟢空闲/🔵正常/🟡繁忙/🔴超载，超载自动置顶），默认每列显示 12 人可展开全部，支持按姓名/职务搜索；点击成员卡片展开其任务明细。
- **一键导出研发周报**：主管及以上角色一键导出 PDF/Excel 周报（总体概览 + 各部门统计 + 逾期明细），与看板同一统计口径；部门统计自动聚合全部下级科室。
- **Q1 紧急任务 Top5 + 近 7 日完成趋势**：一屏看完全局。
- 实时刷新：任务变更后 1 秒内自动更新。

**角色与权限**：
| 角色 | 可见范围 | 导出周报 |
|---|---|---|
| 研发领导 / System Manager / RD Center Manager | 全部研发部门 | ✅ |
| Department Manager / Division Manager | 仅本部门 | ✅ |
| 普通工程师 | 仅本人 | ❌ |

**"研发领导"角色**：安装/migrate 时由 `setup.ensure_pqt_roles()` 自动创建（幂等）。如需手工创建：
`设置 → 角色 → 新建，角色名“研发领导”，勾选 Desk Access`，然后在用户档案中授予对应账号。

**统计口径**（全站统一，见 `utils/stats.py`）：任务归属以 `_assign`（负责人）为准而非 `owner`（创建人）；逾期 = `exp_end_date < 今天` 且状态非 Completed/Cancelled；Template 状态全局排除。

### 0. 部门运营指挥中心 [New]
作为系统的核心落地页，为管理者提供"驾驶舱"式监控：
- **👥 团队负荷动态**：以"头像 + 能量条"形式实时呈现部门全员的任务积压与完成效率情况。
- **🚨 紧急任务快报**：自动抓取 Q1 象限（最优先）的前 5 个任务，并以红色呼吸灯提醒处理。
- **⚡ 极速操作入口**：整合高频业务链接，大幅减少层级跳转。

### 1. 统一个人工作台
将三个核心视角集成于单一页面，通过顶部页签无缝切换：
- **🧩 四象限视图**：直观展示 Q1-Q4 任务布局，支持跨象限拖拽。
- **📋 任务列表**：按项目分组展示，清晰展现所有任务。
- **📊 看板视图**：按"未开始、进行中、已完成"状态展示。

### 2. 多级管理维度
- **部门仪表板**：部门主管可查看下属所有项目进度与任务分布，支持项目状态筛选（默认只看打开的项目）。
- **事业处仪表板**：高层主管可跨部门审视项目总体运营状况，支持项目状态筛选。
- **人员详情**：以部门树形结构展示人员概览，轻松追踪每位成员的当前负荷，任务卡片支持评论展示与编辑。

### 3. 项目详情页
- **概览/任务/知识/会议**四大 Tab，任务按状态分组展示。
- **任务评论**：卡片下方直接显示评论摘要，支持快速添加和修改评论。
- **项目知识地图**：关联 Wiki / Gameplan / Drive 文档。
- **项目列表**：未指定项目时展示全部项目，支持右上角状态筛选（默认打开）。

### 4. 协作与认领
- **认领任务**：展示公共任务池，支持成员主动认领。
- **新建任务**：极简的任务创建流程。
- **任务评论**：支持描述、普通评论和管理员评论三种类型，富文本编辑。

---

## 🌍 第三方应用汉化

本应用通过 `translations/zh.csv` 统一维护 Drive、Gameplan、Wiki 的中文翻译：

| 应用 | 汉化方式 | 状态 |
|------|---------|------|
| **Drive 文件中心** | 直接修改源码 + 硬编码翻译字典 | ✅ 已完工 |
| **Gameplan 讨论区** | 直接修改源码 + 硬编码翻译字典 | ✅ 已完工 |
| **Wiki 知识库** | 直接修改源码 + 硬编码翻译字典 | ✅ 已完工 |

### 汉化内容覆盖
- 侧边栏导航（首页、最近、已共享、回收站、讨论、任务、页面等）
- 页面标题与面包屑导航
- 按钮文本（创建、新建、搜索等）
- 筛选标签与下拉选项
- 空状态提示信息
- 表单占位符文本

---

## 🛠 技术架构
- **后端**：Frappe / ERPNext (Python)
- **前端**：Vanilla JS / jQuery (无重框架，轻量响应)
- **实时性**：集成 Frappe Realtime (Socket.io) 实时推送任务更新

---

## 🚀 快速开始

### 安装环境
确保你已安装 `frappe-bench` 环境，版本建议 v16+。

### 安装步骤
```bash
# 进入 bench 目录
cd ~/frappe-bench

# 获取应用
bench get-app https://gitee.com/alexjunqi/project_quadrant_tracker.git

# 安装到站点
bench --site [站点名称] install-app project_quadrant_tracker

# 构建资源
bench build --app project_quadrant_tracker

# 重启环境
bench restart
```

### 第三方应用汉化安装
```bash
# Drive 文件中心
bench get-app https://gitee.com/alexjunqi/drive.git
bench --site [站点名称] install-app drive

# Gameplan 讨论区
bench get-app https://gitee.com/alexjunqi/gameplan.git
bench --site [站点名称] install-app gameplan

# Wiki 知识库
bench get-app https://gitee.com/alexjunqi/wiki.git
bench --site [站点名称] install-app wiki

# 构建所有应用
CI=true bench build --app drive
CI=true bench build --app gameplan
CI=true bench build --app wiki
bench restart
```

### 升级步骤
```bash
cd ~/frappe-bench
source env/bin/activate
bench update --pull --apps project_quadrant_tracker
bench --site [站点名称] migrate
bench restart
```

---

---

## 📋 版本历史

### v1.5.0 (2026-05-14) - 安全加固更新
- 🔐 修复 22 个安全与规范问题（详见 [CHANGELOG.md](./CHANGELOG.md)）
- 🛡️ API 权限绕过修复、SQL 注入防护、Controller 生命周期保护
- 📝 新增 4 个后端 API 替代前端直接数据库操作
- ✅ 新增 21 个单元测试覆盖权限与安全场景

### v1.4.1 (2026-04-28) - 初始稳定版本
- 四象限任务管理核心功能
- 部门/事业处/个人多级仪表盘
- Drive / Gameplan / Wiki 汉化支持

---

## 📜 许可证
MIT License