# project_quadrant_tracker

**Repository Path**: jasonfu06/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**: 0
- **Forks**: 10
- **Created**: 2026-04-16
- **Last Updated**: 2026-05-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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

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

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

---

## 🌟 核心理念

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

---

## ✨ 主要特性

### 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
```

---

## 📜 许可证
MIT License