Task Manager

Simple full-stack task manager with:

• Spring Boot backend (backend/)
• React + Vite frontend (frontend/)

Prerequisites

• Java 17+
• Maven 3.9+
• Node.js 18+
• npm 9+

Quick Start

1) Run backend

cd /Users/uttamkumar/uttam-all-data/01_github-projects/task-manager/backend
mvn spring-boot:run

Backend: http://localhost:8080

If backend startup fails with FATAL: role "postgres" does not exist, run this one-time local PostgreSQL setup:

psql -h localhost -p 5432 -d postgres -c "CREATE ROLE postgres WITH LOGIN SUPERUSER PASSWORD 'postgres123';"
createdb -h localhost -p 5432 -O postgres taskdb

Then start backend again:

cd /Users/uttamkumar/uttam-all-data/01_github-projects/task-manager/backend
mvn spring-boot:run

2) Run frontend

cd /Users/uttamkumar/uttam-all-data/01_github-projects/task-manager/frontend
npm install
npm run dev

Frontend: http://localhost:5173

3) Frontend env

Create frontend/.env:

VITE_API_BASE_URL=http://localhost:8080

For production (Vercel), set:

VITE_API_BASE_URL=https://<your-backend>.onrender.com

Common Commands

Backend

cd /Users/uttamkumar/uttam-all-data/01_github-projects/task-manager/backend
mvn test
mvn clean package

Frontend

cd /Users/uttamkumar/uttam-all-data/01_github-projects/task-manager/frontend
npm run build
npm run preview

Docker (optional)

cd /Users/uttamkumar/uttam-all-data/01_github-projects/task-manager

# first-time setup
cp .env.example .env

# backend change
cd backend
mvn clean package -DskipTests
cd ..
docker compose up -d --build backend

# frontend change
cd frontend
npm run build
cd ..
docker compose up -d --build frontend

# full rebuild
docker compose up -d --build

# verify
docker ps

# debug if needed
docker compose logs -f

# just restart
docker compose down && docker compose up -d

# stop
docker compose down

Root .env values used by Compose:

• DB_NAME, DB_USER, DB_PASSWORD
• TASK_MANAGER_AUTH_USERNAME, TASK_MANAGER_AUTH_PASSWORD, TASK_MANAGER_AUTH_ROLE
• TASK_MANAGER_CORS_ALLOWED_ORIGINS
• VITE_API_BASE_URL (baked into frontend image at build time)
• JWT_SECRET, JWT_EXPIRATION_MS (optional)

Authentication

This project currently uses session-based authentication.

• Login creates a server session
• Browser stores JSESSIONID cookie
• Frontend sends cookie automatically (withCredentials: true)
• Protected endpoints require a valid session
• New users can self-register and access only their own tasks

Default credentials (unless overridden with env vars):

• Username: admin
• Password: admin123

Backend env overrides:

export TASK_MANAGER_AUTH_USERNAME="myuser"
export TASK_MANAGER_AUTH_PASSWORD="mypassword"
export TASK_MANAGER_AUTH_ROLE="USER"
export TASK_MANAGER_CORS_ALLOWED_ORIGINS="https://task-manager-ashen-nu-54.vercel.app"

Auth endpoints:

• POST /api/auth/register
• POST /api/auth/login
• POST /api/auth/logout
• GET /api/auth/me

API Endpoints

Task endpoints:

• GET /api/tasks
• GET /api/tasks/{id}
• GET /api/tasks?status={status}
• GET /api/tasks/search?keyword={keyword}
• GET /api/tasks/stats
• POST /api/tasks
• PUT /api/tasks/{id}
• PATCH /api/tasks/{id}/complete
• PATCH /api/tasks/{id}/pending
• DELETE /api/tasks/{id}

Quick API Check (with session cookie)

curl -i -c cookies.txt -X POST https://task-manager-backend-51pf.onrender.com/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"admin123"}'

curl -i -b cookies.txt https://task-manager-backend-51pf.onrender.com/api/tasks

Notes

• Database: PostgreSQL only (configured in docker-compose.yml and backend application.properties)
• Frontend API backend: https://task-manager-backend-51pf.onrender.com (set VITE_API_BASE_URL in .env to override)
• If frontend cannot call backend, verify VITE_API_BASE_URL and backend CORS settings in backend/src/main/java/backend/security/SecurityConfig.java
• Backend-specific details are in backend/README.md; frontend-specific details are in frontend/README.md