项目交付管理工具

B 端项目交付管理工具 - 帮助项目经理高效拆解任务、合理分配资源、自动生成报告

功能特性

• 甘特图展示 - 可视化项目计划，支持任务层级和依赖关系
• AI 任务拆解 - 自动将大任务拆解为详细的 WBS 子任务
• 资源管理与日历 - 查看团队成员时间分配和加班情况
• 日报周报生成 - AI 自动生成项目报告
• 本地部署 - 数据本地存储，安全可控

技术栈

• 前端: React 18 + TypeScript + Ant Design
• 桌面框架: Electron
• 数据库: SQLite (sql.js - 纯 JavaScript 实现)
• 构建工具: Vite
• AI 服务: DeepSeek API
• 甘特图: DHTMLX Gantt

开发环境要求

• Node.js 20 LTS 或更高版本
• npm 或 pnpm 包管理器

安装与运行

1. 安装依赖

npm install

如果 Electron 安装失败，请运行：

npm rebuild electron

2. 配置 AI 服务

AI 服务已配置 DeepSeek API，无需额外设置。

如需更换 API Key，编辑 .env 文件：

AI_PROVIDER=deepseek
AI_API_KEY=your_api_key_here

3. 运行开发模式

# 运行 Electron 开发模式
npm run electron:dev

应用将自动打开，显示项目列表界面。

4. 数据库初始化

数据库会在首次运行时自动创建，也可以手动运行迁移脚本：

npm run db:migrate

数据库文件位置：

• Windows: %APPDATA%\project-delivery-tool\delivery.db

5. 测试 AI 功能

# 测试 AI 任务拆解
node test-ai.js

# 测试完整流程（创建项目 +AI 拆解 + 保存到数据库）
node test-full-flow.js

快速开始

# 1. 安装依赖
npm install

# 2. 运行数据库迁移
npm run db:migrate

# 3. 测试 AI 功能（可选）
node test-ai.js

# 4. 启动 Electron 开发模式
npm run electron:dev

项目结构

project-delivery-tool/
├── electron/                 # Electron 主进程
│   ├── main.js              # 主进程入口
│   ├── preload.js           # 预加载脚本
│   ├── database.js          # SQLite 数据库操作
│   └── ai-service.js        # AI 服务集成
├── src/                     # React 源代码
│   ├── modules/             # 功能模块
│   │   ├── project/         # 项目管理
│   │   ├── task/            # 任务管理（甘特图）
│   │   ├── resource/        # 资源日历
│   │   └── report/          # 报告生成
│   ├── App.tsx              # 应用入口
│   └── main.tsx             # React 入口
├── scripts/                 # 工具脚本
│   └── db-migrate.js        # 数据库迁移
├── package.json
└── tsconfig.json

构建发布

构建应用

npm run electron:build

构建产物将输出到 dist-electron/ 目录。

数据库结构

projects (项目表)

字段	类型	说明
id	INTEGER	主键
name	TEXT	项目名称
client	TEXT	客户
start_date	DATE	开始日期
end_date	DATE	结束日期
status	TEXT	状态 (planning/active/delayed/completed)
budget_hours	INTEGER	预算工时

tasks (任务表)

字段	类型	说明
id	INTEGER	主键
project_id	INTEGER	项目 ID
parent_id	INTEGER	父任务 ID (支持层级)
name	TEXT	任务名称
start_date	DATE	开始日期
end_date	DATE	结束日期
duration	INTEGER	工期 (天)
progress	INTEGER	完成百分比
predecessor_ids	TEXT	前置任务 ID
assignee	TEXT	负责人

members (成员表)

字段	类型	说明
id	INTEGER	主键
name	TEXT	姓名
role	TEXT	角色
skills	TEXT	技能 (JSON)
available_hours_per_day	INTEGER	每日可用工时

resource_calendar (资源日历表)

字段	类型	说明
id	INTEGER	主键
member_id	INTEGER	成员 ID
date	DATE	日期
available_hours	INTEGER	可用工时
assigned_hours	INTEGER	已分配工时
type	TEXT	类型 (work/overtime/leave/training)

AI 任务拆解

系统支持使用 DeepSeek 或通义千问进行 AI 任务拆解。

DeepSeek

注册地址：https://platform.deepseek.com/

通义千问

注册地址：https://dashscope.console.aliyun.com/

开发状态

MVP 状态: ✅ 完成

已完成的核心功能:

• ✅ 项目管理 (CRUD 操作)
• ✅ 甘特图 (DHTMLX 集成 + 数据库同步)
• ✅ AI 任务拆解 (DeepSeek API + 保存到数据库)
• ✅ 团队成员管理
• ✅ 资源日历
• ✅ 报告生成 UI

详细测试报告请查看 COMPLETION_REPORT_v2.md

常见问题

数据库文件在哪里？

数据库文件位于用户数据目录：

• Windows: C:\Users\<用户名>\AppData\Roaming\project-delivery-tool\delivery.db
• macOS: ~/Library/Application Support/project-delivery-tool/delivery.db
• Linux: ~/.config/project-delivery-tool/delivery.db

AI 拆解失败？

1. 检查 .env 文件中的 API Key 是否正确
2. 确认网络连接正常
3. 查看控制台错误日志

License

MIT