一款全栈协作任务管理网络应用，采用React、Node.js/Express和PostgreSQL构建。

现场演示

部署到铁路： 请按照下方“部署铁路”部分的步骤操作，然后更新此链接并添加您的铁路网址。

特色

• 用户认证 – 使用 JWT 令牌注册/登录
• 项目管理 – 创建项目、邀请成员、管理角色（管理员/成员）
• 任务管理 – 创建带有标题、描述、截止日期、优先级和分配的任务
• 状态追踪 – 进行中的→ →完成
• 仪表盘 – 总任务概览，按状态划分的任务，按用户分配任务，逾期任务
• 基于角色的访问——管理员管理一切;成员更新自己分配的任务

技术堆栈

项目结构

本地设置

先决条件

• Node.js 18+
• PostgreSQL 数据库

步伐

在浏览器中打开http://localhost:5000。

演示账户

TaskForge – Team Task Manager

A full-stack collaborative task management web application built with React, Node.js/Express, and PostgreSQL.

Live Demo

Deploy to Railway: Follow the steps in the Deployment on Railway section below, then update this link with your Railway URL.

Features

• User Authentication – Signup/Login with JWT tokens
• Project Management – Create projects, invite members, manage roles (Admin/Member)
• Task Management – Create tasks with title, description, due date, priority, and assignment
• Status Tracking – To Do → In Progress → Done
• Dashboard – Overview of total tasks, tasks by status, tasks per user, overdue tasks
• Role-Based Access – Admins manage everything; Members update their own assigned tasks

Tech Stack

Project Structure

taskforge/
├── client/              # React frontend (Vite)
│   ├── src/
│   │   ├── api/         # Axios instance
│   │   ├── components/  # Reusable components (Sidebar)
│   │   ├── context/     # AuthContext
│   │   └── pages/       # Dashboard, Projects, ProjectDetail, Tasks, Login, Register
│   └── vite.config.js
├── server/              # Express backend
│   ├── routes/          # auth, projects, tasks, dashboard, users
│   ├── middleware/       # JWT authentication
│   ├── db.js            # PostgreSQL pool
│   └── index.js         # Entry point
├── schema.sql           # Database schema
├── .env.example
└── package.json

Local Setup

Prerequisites

• Node.js 18+
• PostgreSQL database

Steps

# 1. Clone the repository
git clone https://github.com/the708052/TaskForge.git
cd TaskForge

# 2. Install dependencies
npm install

# 3. Set up environment variables
cp .env.example .env
# Edit .env with your DATABASE_URL and JWT_SECRET

# 4. Create the database schema
psql $DATABASE_URL -f schema.sql

# 5. Start the backend (port 3001)
npm run server

# 6. Start the frontend (port 5000) — in a new terminal
npm run client

# Or run both together:
npm run dev

Open http://localhost:5000 in your browser.

Demo Account

After running the schema (which seeds a demo account):

• Email: [email protected]
• Password: demo123

Deployment on Railway

Step 1 – Create a Railway project

1. Go to railway.app and create a new project
2. Add a PostgreSQL plugin to the project

Step 2 – Deploy the backend

1. Connect your GitHub repository
2. Set the Root Directory to / and start command to npm run start
3. Add environment variables:

   DATABASE_URL=
   JWT_SECRET=
   NODE_ENV=production
   PORT=3001