https://github.com/sasmithx/green-shadow
Green Shadow (Pvt) Ltd. is a mid-scale farm specializing in root crops and cereals. The company operates at both national and international levels and is renowned in its field for high-quality production.
https://github.com/sasmithx/green-shadow
hibernate-validator intellij-idea jdk-21 jwt-authentication spring-boot spring-data-jpa spring-mvc spring-security
Last synced: 2 months ago
JSON representation
Green Shadow (Pvt) Ltd. is a mid-scale farm specializing in root crops and cereals. The company operates at both national and international levels and is renowned in its field for high-quality production.
- Host: GitHub
- URL: https://github.com/sasmithx/green-shadow
- Owner: sasmithx
- License: mit
- Created: 2024-11-30T02:42:47.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-12-06T15:31:22.000Z (7 months ago)
- Last Synced: 2025-03-28T05:18:12.608Z (3 months ago)
- Topics: hibernate-validator, intellij-idea, jdk-21, jwt-authentication, spring-boot, spring-data-jpa, spring-mvc, spring-security
- Language: Java
- Homepage:
- Size: 5.86 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Green Shadow Spring Boot Application
This is a Spring Boot-based backend system. It provides RESTful APIs for managing crop , equipment , field , staff , user , vehicle , monitoring log and transactions. The project uses Spring Boot, JPA, Hibernate,Spring Security, and MySQL for database connectivity.
## Features
- Equipment Management
- Field Management
- Staff Management
- User Management
- Vehicle Management
- Monitoring Log Management
- Role-Based Access Control
- Token Generation
- Token Validation
- Token Refresh
- Spring Security Integration
- Custom Authentication Provider
- Secure Password Storage
- Profile Management
- Login Attempt Auditing
- Activity Logging
- Protected Endpoints
- Transaction Processing
- Exception Handling and Validation using Hibernate Validator
- JSON Response formatting
- Logs with logback
## Technologies
- **Java Vesion:** JDK 21
- **Backend Framework:** Spring Boot (v3.4.0)
- **Database:** MySQL
- **ORM:** JPA, Hibernate
- **Server:** Apache Tomcat
- **Validation:** Hibernate Validator
- **Logger:** Logback
## Architecture Overview
- **Entities:** Representations for Crop , Email , Equipment , Field , Staff , User , Vehicle and Monitoring Log
- **Data Transfer Objects (DTOs):** Includes CropDTO, EmailDTO, EquipmentDTO , FieldDTO , StaffDTO , UserDTO , VehicleDTO and MoniterLogDTO
- **Repositories:** Interfaces for database operations.
- **Services:** Business logic for manage.
- **Controllers:** API endpoints for handle Requests.
- **Utilities:** Helper classes for tasks.
- **Exceptions:** Custom error handling mechanisms for specific scenarios
- **Configuration:** Application setup classes like application.properties,application-dev.properties
## Validation
Data validation is enforced through Hibernate Validator annotations within the DTO classes, ensuring both data integrity and accuracy.
## Logging
Logging is set up with Logback, capturing logs both in the console and in a dedicated file.
## Custom Exceptions
Custom exceptions are designed to address specific error situations, delivering clear and informative error messages to the client.
## Setup and Configuration
**Prerequisites**
- **JDK 21**
- **MySQL server**
- **Maven**
## Clone the repository:
```bash
https://github.com/sasmithx/Green-Shadow.git
```
## Database Configuration
## API Documentation
To view this project API Documentation
Refer to the [ Postman API Documentation](https://documenter.getpostman.com/view/35385442/2sAYBaApai) for detailed API endpoints and usage instructions.
## License
This project is licensed under the MIT License - see the [ MIT License](https://github.com/sasmithx/Green-Shadow?tab=MIT-1-ov-file#) file for details.
##
© 2024 Sasmith Manawadu