🗳️ Polling Application

A full-stack Polling Application built with Java, Spring Boot, MySQL, React, and Material UI, designed with clean architecture, secure authentication, and scalable REST APIs.

This project demonstrates modern backend engineering practices (JWT security, layered architecture, DTO pattern) combined with a responsive and user-friendly frontend.

---

🚀 Tech Stack

🔧 Backend

• Java 25
• Spring Boot
• Spring Security (JWT Authentication)
• Spring Data JPA (Hibernate)
• MySQL
• Java Mail Sender
• Lombok

🎨 Frontend

• React.js
• Material UI (MUI)
• Axios

---

✨ Features

🔐 Authentication & Authorization

• User Registration & Login
• JWT-based authentication
• Secure API endpoints

🗳️ Poll Management

• Create a poll (authenticated users)
• View all polls
• View My Polls (user-specific)
• Delete own polls

❤️ Engagement

• Like a poll
• Comment on polls
• Vote on poll options

📩 Email Integration

• Automatic email notification when a poll is created (via Java Mail Sender)

---

🏗️ Backend Architecture

The backend follows a clean layered architecture:

Controller → Service → Repository → Database
            ↓
           DTO

Key Design Practices

• DTO pattern for API communication
• Service layer abstraction
• Exception handling (recommended to extend)
• Stateless authentication using JWT

---

📡 API Endpoints

Poll APIs

Method	Endpoint	Description
POST	/api/user/polls/	Create a poll
GET	/api/user/polls/	Get all polls
GET	/api/user/polls/my-polls	Get logged-in user's polls
GET	/api/user/polls/{id}	Get poll details
DELETE	/api/user/polls/{id}	Delete poll
GET	/api/user/polls/like/{id}	Like a poll
POST	/api/user/polls/comment	Add comment
POST	/api/user/polls/vote	Vote on poll

---

🔑 Authentication Flow

1. User registers
2. User logs in
3. Backend generates JWT token
4. Token is sent in headers for secured requests

Authorization: Bearer <JWT_TOKEN>

---

📬 Email Notification Flow

• When a user creates a poll:

  • Backend triggers Java Mail Sender
  • Email is sent to the logged-in user

---

🧩 Sample Controller (PollController)

@RestController
@RequestMapping("/api/user/polls")
@RequiredArgsConstructor
@CrossOrigin("*")
public class PollController {

    private final PollService pollService;

    @PostMapping("/")
    public ResponseEntity<?> postPoll(@RequestBody PollDTO pollDTO){
        PollDTO creatdPollDTO = pollService.postPoll(pollDTO);
        return new ResponseEntity<>(creatdPollDTO, HttpStatus.CREATED);
    }   
}

---

⚙️ Setup Instructions

🔹 Backend

git clone https://github.com/nazzmul-anik/polling-app.git
cd polling-app/backend

Run the application:

mvn spring-boot:run

---

🔹 Frontend UI Picture

🔹 Dashboard

🔹 Create Poll Page

🔹 Signu Up Page

🔹 Email Confirmation

🔹 Like & Comment Section

---

👨‍💻 Author

Md Nazmul Hasan Anik

• Backend Developer (Spring Boot)
• Passionate about scalable system design and clean code

---

⭐ If you find this project useful, consider giving it a star!