# 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**: V16
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 10
- **Created**: 2025-11-20
- **Last Updated**: 2026-04-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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

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

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

---

## ✨ 主要特性 (V1.4.1)

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

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

### 2. 多级管理维度
- **部门仪表板**：部门主管可查看下属所有项目进度与任务分布，支持直接点击项目名称跳转详情。
- **事业处仪表板**：高层主管可跨部门审视项目总体运营状况，直观追踪各阶段各类型项目。
- **人员详情**：以部门树形结构展示人员概览，轻松追踪每位成员的当前负荷与活跃项目。

### 3. 协作与认领
- **认领任务**：展示公共任务池，支持成员主动认领。
- **新建任务**：极简的任务创建流程。

### 4. V16 深度适配与原生体验
- **专属图标**：定制化官方风格专属应用图标。
- **无缝集成**：完美适配 Frappe V16 Workspace 与侧边栏。
- **全中文化**：界面完整汉化，符合中国用户使用习惯。

---

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

---

## 🚀 快速开始

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

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

# 获取应用
bench get-app project_quadrant_tracker

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

# 构建资源
bench build --app project_quadrant_tracker

# 重启环境
bench restart
```

### 升级步骤
```bash
# 进入 bench 目录
cd ~/frappe-bench

# 进入虚拟环境
source env/bin/activate

# 更新应用代码并执行必要操作
bench update --pull --apps project_quadrant_tracker

# 执行数据库迁移（确保站点数据同步）
bench --site [站点名称] migrate

# 重启环境
bench restart
```

---

## 📜 许可证
MIT License