🗂️ Smart Task Manager API

Production-grade REST API for task management with JWT authentication, role-based access control, and a built-in web frontend — all powered by Spring Boot 3.

---

✨ Features

Category	Details
🔐 Authentication	JWT-based register/login with BCrypt password hashing
👥 Authorization	Role-based access — USER sees own tasks, ADMIN sees all
📋 Task CRUD	Create, read, update, delete with full validation
🔍 Advanced Querying	Filter by status/priority, sort by any field, paginated responses
🎨 Built-in Frontend	Responsive SPA served directly from Spring Boot
🧪 Test Suite	Unit + web-layer tests (JUnit 5 · Mockito · MockMvc)
📮 Postman Collection	Ready-to-import collection for quick API testing
📖 Swagger UI	Auto-generated interactive API docs at /swagger-ui.html
💚 Health Checks	Spring Actuator endpoints at /actuator/health

---

🏗️ Architecture

┌──────────────┐     ┌──────────────┐     ┌──────────────┐     ┌──────────┐
│   Frontend   │────▶│  Controller  │────▶│   Service    │────▶│  MySQL   │
│  (Static JS) │     │   (REST)     │     │  (Business)  │     │    DB    │
└──────────────┘     └──────┬───────┘     └──────────────┘     └──────────┘
                            │
                     ┌──────┴───────┐
                     │ JWT Security │
                     │    Filter    │
                     └──────────────┘

Layered design: Controller → Service → Repository, with DTOs at boundaries and a global exception handler for consistent error responses.

---

📁 Project Structure

smart-task-manager-api/
├── pom.xml                          # Maven build config
├── .env.example                     # Environment variable template
├── README.md
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
├── POSTMAN_GUIDE.md
├── RUNNING.md
├── design.md                        # UI/UX design blueprint
├── use-java17.ps1                   # JDK 17 shell helper
├── scripts/
│   └── start-app.ps1               # Auto-detect Java & run
├── postman/
│   └── Smart_Task_Manager_API.postman_collection.json
├── docs/
│   └── internal/                    # Developer notes (not user-facing)
├── frontend-designs/                # Stitch UI design exports
└── src/
    ├── main/
    │   ├── java/com/smarttaskmanager/api/
    │   │   ├── SmartTaskManagerApiApplication.java
    │   │   ├── config/
    │   │   │   ├── SecurityConfig.java
    │   │   │   ├── CorsConfig.java
    │   │   │   └── OpenApiConfig.java
    │   │   ├── controller/
    │   │   │   ├── AuthController.java
    │   │   │   └── TaskController.java
    │   │   ├── dto/
    │   │   │   ├── auth/
    │   │   │   └── task/
    │   │   ├── entity/
    │   │   │   ├── User.java
    │   │   │   └── Task.java
    │   │   ├── enums/
    │   │   ├── exception/
    │   │   ├── repository/
    │   │   ├── security/
    │   │   └── service/
    │   └── resources/
    │       ├── application.properties
    │       ├── application-test.properties
    │       ├── db/schema.sql
    │       └── static/              # Built-in frontend
    └── test/
        └── java/com/smarttaskmanager/api/
            ├── controller/
            └── service/impl/

---

🚀 Quick Start

Prerequisites

Tool	Version	Notes
JDK	17+	Adoptium or Oracle
Maven	3.9+	Download
MySQL	8+	Download

1. Clone the Repository

git clone https://github.com/YOUR_USERNAME/smart-task-manager-api.git
cd smart-task-manager-api

2. Configure Environment

cp .env.example .env

Edit .env with your database credentials and a strong JWT secret:

# Generate a secure JWT secret:
openssl rand -base64 64

3. Set Up the Database

mysql -u root -p
SOURCE src/main/resources/db/schema.sql;

4. Run the Application

Option A — Direct Maven:

mvn spring-boot:run

Option B — PowerShell helper (Windows):

# Sets up JDK 17 + Maven in current shell
. .\use-java17.ps1
mvn spring-boot:run

Option C — Startup script:

.\scripts\start-app.ps1

5. Access the Application

URL	Description
http://localhost:8080	Web frontend (login/signup/dashboard)
http://localhost:8080/swagger-ui.html	Interactive API documentation
http://localhost:8080/actuator/health	Health check endpoint

---

📖 API Reference

Authentication (Public)

Method	Endpoint	Description
POST	/api/auth/register	Register a new user
POST	/api/auth/login	Login and receive JWT

Tasks (JWT Required)

Method	Endpoint	Description
POST	/api/tasks	Create a new task
GET	/api/tasks	List tasks (paginated, filterable)
GET	/api/tasks/{id}	Get a single task
PUT	/api/tasks/{id}	Update a task
DELETE	/api/tasks/{id}	Delete a task

Query Parameters for GET /api/tasks:

Param	Default	Options
page	0	Page number
size	10	Page size
sortBy	createdAt	Any task field
sortDir	desc	asc / desc
status	—	TODO · IN_PROGRESS · COMPLETED
priority	—	LOW · MEDIUM · HIGH

Quick cURL Test

# Register
curl -X POST http://localhost:8080/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"name":"Test User","email":"test@example.com","password":"password123","role":"USER"}'

# Login
curl -X POST http://localhost:8080/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"test@example.com","password":"password123"}'

# Create Task (use token from login response)
curl -X POST http://localhost:8080/api/tasks \
  -H "Authorization: Bearer <JWT_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"title":"My Task","description":"Details","status":"TODO","priority":"HIGH","dueDate":"2030-12-31"}'

---

🧪 Running Tests

mvn test

Test Coverage

Test Class	Layer	Scenarios
AuthServiceImplTest	Service	Register/login success + failure
TaskServiceImplTest	Service	CRUD, ownership checks, admin behavior
AuthControllerTest	Web	Validation, response codes
TaskControllerTest	Web	Create/get tasks, pagination

---

🔐 Authentication Flow

1. Client  ──POST /api/auth/register──▶  Server
2. Server  ◀── 201 { token, user }  ──  Server
3. Client  ──GET /api/tasks──▶  Server
               Authorization: Bearer <token>
4. JwtAuthenticationFilter validates token
5. SecurityContext set → request proceeds
6. Service enforces role + ownership rules

---

📮 Postman Collection

1. Import postman/Smart_Task_Manager_API.postman_collection.json
2. Create environment with baseUrl = http://localhost:8080
3. Register → Login → Copy token → Set token variable
4. Run task CRUD requests

See POSTMAN_GUIDE.md for a step-by-step walkthrough.

---

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

---

📄 License

This project is licensed under the MIT License — see LICENSE for details.