Task Management App

A full-stack task management application built with Angular 19, Node.js, Express.js, and MongoDB. Features organization-based multi-tenancy, role-based access control (user/admin/super), task assignment and tracking, and responsive design with Tailwind CSS.

Table of Contents

• Features
• Technologies Used
• Prerequisites
• Installation
• Running the Application
• API Endpoints
• Usage
• License

Features

• User authentication with JWT (register, login, auto-logout)
• Organization-based multi-tenancy with member management
• Role-based access control: user, admin, super
• Task CRUD with assignment to organization members
• Task filtering by status, priority, and search
• Subtask/checklist support
• Activity log per task
• Dashboard with task statistics
• Responsive design using Tailwind CSS

Technologies Used

• Backend: Node.js, Express.js, MongoDB, Mongoose, JWT, bcryptjs, Helmet, express-rate-limit, Swagger
• Frontend: Angular 19, Tailwind CSS, RxJS
• Authentication: JSON Web Tokens (JWT)

Prerequisites

• Node.js (v18.x or later)
• Angular CLI (v19.x or later)
• MongoDB (local or Atlas instance)

Installation

Backend

1. Clone the repository:

   git clone https://github.com/manthanank/task-management-app.git
   cd task-management-app/backend

2. Install dependencies:

   npm install

3. Create a .env file in the backend directory (see .env.example):

   PORT=3000
   MONGODB_USER=your_mongodb_user
   MONGODB_PASSWORD=your_mongodb_password
   MONGODB_DBNAME=tasksdb
   MONGODB_HOST=cluster0.example.mongodb.net
   JWT_SECRET=your_strong_random_secret
   CORS_ORIGIN=http://localhost:4200

4. Start the backend server:

   npm start

Frontend

1. Navigate to the project root:

   cd task-management-app

2. Install dependencies:

   npm install

3. Start the frontend development server:

   ng serve

Running the Application

• The backend server runs on http://localhost:3000
• The frontend server runs on http://localhost:4200
• API documentation is available at http://localhost:3000/api-docs

API Endpoints

Auth

• POST /api/auth/register — Register a new user (optionally with organization)
• POST /api/auth/login — Login and receive JWT token
• POST /api/auth/logout — Logout
• GET /api/auth/users — Get all users (authenticated)

Tasks

• GET /api/tasks — Get all tasks (organization-scoped)
• GET /api/tasks/ongoing — Get ongoing tasks (with search, filter, sort)
• GET /api/tasks/completed — Get completed tasks
• GET /api/tasks/user — Get current user's tasks
• GET /api/tasks/summary/stats — Get task statistics
• GET /api/tasks/:id — Get task by ID
• GET /api/tasks/:id/activities — Get task activity log
• POST /api/tasks — Create a new task (admin)
• PUT /api/tasks/:id — Update a task
• DELETE /api/tasks/:id — Delete a task

Users

• GET /api/users — Get all users (paginated)
• GET /api/users/organization — Get users in same organization
• GET /api/users/profile — Get current user's profile
• GET /api/users/:id — Get user by ID
• PUT /api/users/:id — Update user
• DELETE /api/users/:id — Delete user (admin)

Organizations

• GET /api/organizations — Get all organizations (admin)
• GET /api/organizations/my — Get current user's organization
• GET /api/organizations/:id — Get organization by ID
• POST /api/organizations — Create organization (admin)
• PUT /api/organizations/:id — Update organization (admin)
• DELETE /api/organizations/:id — Delete organization (owner)
• GET /api/organizations/:id/members — Get organization members
• POST /api/organizations/:id/members — Add member (admin)
• DELETE /api/organizations/:id/members — Remove member (admin)

Usage

1. Register — Create a new account, optionally creating or joining an organization.
2. Log In — Authenticate to access the task management features.
3. Dashboard — View task statistics for your organization.
4. Tasks — Create, view, edit, delete, and filter tasks. Assign tasks to organization members.
5. Organizations — Manage organization members (admin/super roles).
6. Profile — View your profile and organization role.

License

This project is licensed under the MIT License. See the LICENSE file for details.