README.md
RockFishing Guide API is a RESTful backend application built with Spring Boot.
The goal of this project is to provide structured information for anglers practicing rockfishing, including fishing spots, species, lures, techniques and environmental conditions.
This API will serve as the backend for a future frontend application.
The API manages different fishing related resources:
- Fishing spots
- Fish species
- Lures
- Fishing techniques
- Meteorological conditions
- Catch records
The system is designed with a relational domain model to represent the relationships between species, spots, lures and techniques.
- Java
- Spring Boot
- Spring Data JPA / Hibernate
- MySQL
- Maven
rockfishing-guide
├── api
│ ├── pom.xml
│ ├── mvnw
│ ├── mvnw.cmd
│ ├── src
│ │ ├── main
│ │ │ ├── java
│ │ │ │ └── com
│ │ │ │ └── pachedev
│ │ │ │ └── rockfishingguide
│ │ │ │ ├── RockfishingguideApplication.java
│ │ │ │ └── model
│ │ │ │ ├── entity
│ │ │ │ │ ├── CatchRecord.java
│ │ │ │ │ ├── Equipment.java
│ │ │ │ │ ├── Lure.java
│ │ │ │ │ ├── MeteorologicalCondition.java
│ │ │ │ │ ├── Species.java
│ │ │ │ │ ├── SpeciesLure.java
│ │ │ │ │ ├── Spot.java
│ │ │ │ │ └── Technique.java
│ │ │ │ └── enums
│ │ │ │ ├── AccessDifficulty.java
│ │ │ │ ├── FishingPressure.java
│ │ │ │ ├── LureType.java
│ │ │ │ ├── Season.java
│ │ │ │ ├── SeaState.java
│ │ │ │ ├── SkyCondition.java
│ │ │ │ ├── TideStatus.java
│ │ │ │ ├── TipType.java
│ │ │ │ └── WindDirection.java
│ │ │ └── resources
│ │ │ └── application.properties
│ │ └── test
│ └── .mvn
└── README.md
The core entities of the system include:
- Spot → Fishing locations
- Species → Fish species
- Lure → Artificial fishing lures
- Technique → Fishing techniques
- MeteorologicalCondition → Environmental conditions
- CatchRecord → Records of fish captures
Relationships between entities are modeled using JPA annotations.
Planned improvements for the project:
- REST controllers
- Service layer
- Repository layer
- DTOs and validation
- API documentation
- Frontend application
- Authentication
Daniel Pacheco