📖 Journal Application

A secure RESTful Journal Management API built using Spring Boot and MongoDB Atlas. The application implements JWT Authentication, Spring Security, and Role-Based Access Control (RBAC) to provide secure access to journal management features. It also integrates Redis Caching, Weather API, Email Notifications, and Scheduled Tasks, showcasing modern backend development practices.

---

🚀 Features

👤 User Features

• User Registration
• Secure Login using JWT Authentication
• Create Journal Entries
• View Personal Journal Entries
• Update Existing Journal Entries
• Delete Journal Entries
• Users can access only their own journal entries

👨‍💼 Admin Features

• View All Users
• Delete Users
• View All Journal Entries
• Role-Based Access Control (ROLE_USER, ROLE_ADMIN)

🔐 Security

• JWT Authentication
• Spring Security
• Authentication & Authorization
• Role-Based Access Control (RBAC)
• Custom JWT Filter
• Protected REST APIs
• Secure Password Encryption

☁️ Database

• MongoDB Atlas Cloud Database
• Spring Data MongoDB Integration

⚡ Additional Features

• Redis Caching
• Weather API Integration
• Email Notifications
• Scheduled Tasks
• Unit Testing with JUnit

---

🛠️ Tech Stack

Technology	Purpose
Java 17	Programming Language
Spring Boot 2.7.18	Backend Framework
Spring Security	Security Framework
JWT	Authentication
MongoDB Atlas	Cloud Database
Spring Data MongoDB	Database Access
Redis	Caching
Maven	Build Automation
Lombok	Boilerplate Code Reduction
JUnit 5	Unit Testing

---

🏗️ Project Architecture

                 Client
                    │
                    ▼
            JWT Authentication
                    │
                    ▼
          Spring Security Filter
                    │
                    ▼
              REST Controllers
                    │
                    ▼
                 Services
                    │
                    ▼
              Repositories
                    │
                    ▼
              MongoDB Atlas

---

📂 Project Structure

journal-application
│
├── src
│   ├── main
│   │   ├── java
│   │   │   ├── controller
│   │   │   ├── service
│   │   │   ├── repository
│   │   │   ├── entity
│   │   │   ├── config
│   │   │   ├── filter
│   │   │   ├── scheduler
│   │   │   ├── cache
│   │   │   ├── constants
│   │   │   ├── enums
│   │   │   ├── apiResponse
│   │   │   └── utils
│   │   │
│   │   └── resources
│   │
│   └── test
│
├── pom.xml
├── README.md
└── .gitignore

---

🔌 REST API Overview

Method	Functionality	Access
POST	Register User	Public
POST	Login User	Public
GET	View Personal Journals	User
POST	Create Journal	User
PUT	Update Journal	User
DELETE	Delete Journal	User
GET	View All Users	Admin
DELETE	Delete User	Admin
GET	View All Journals	Admin
GET	Weather Information	Authenticated

Note: Endpoint URLs may differ depending on your controller mappings.

---

⚙️ Installation

Clone the Repository

git clone https://github.com/MOKSHITH096/journal-application.git

Navigate to the Project

cd journal-application

Configure Environment Variables

Configure the following environment variables before running the project:

MONGODB_URI
REDIS_URL
MAIL_USERNAME
MAIL_PASSWORD
WEATHER_API_KEY
JWT_SECRET

Build the Project

mvn clean install

Run the Application

mvn spring-boot:run

The application will start at:

http://localhost:8081

---

🧪 Testing

Run all unit tests using:

mvn test

---

📸 API Screenshots

User Registration	User Login

Create Journal	View Journals

Update Journal	Delete Journal

Weather API

🚀 Future Enhancements

• Swagger / OpenAPI Documentation
• Docker Containerization
• Global Exception Handling
• Request Validation
• Pagination & Sorting
• CI/CD Pipeline
• Refresh Token Support
• API Rate Limiting

---

👨‍💻 Author

Mokshith

Backend Developer | Java | Spring Boot | Spring Security | MongoDB | REST APIs

---

⭐ If you found this project useful, consider giving it a star on GitHub!