https://github.com/enkaypeter/student-management-services
Student Management Services Repository
https://github.com/enkaypeter/student-management-services
docker flask microservices spring-boot
Last synced: about 2 months ago
JSON representation
Student Management Services Repository
- Host: GitHub
- URL: https://github.com/enkaypeter/student-management-services
- Owner: enkaypeter
- Created: 2025-04-14T18:49:54.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-23T18:10:53.000Z (about 1 year ago)
- Last Synced: 2025-08-31T12:31:47.463Z (10 months ago)
- Topics: docker, flask, microservices, spring-boot
- Language: Java
- Homepage:
- Size: 975 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎓 Student Management Services
This repository contains a suite of backend services for managing student-related activities in an academic context, implemented as part of an Msc course assessment.
> ⚡ Note: This is a **multi-service repository**. Each service lives in its own directory.
---
## 🚀 Services
| Service Directory | Description | Technology |
| ------------------ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------- |
| `student_service/` | Authentication (JWT), Student profiles, Courses listing, Enrolment, Graduation eligibility | Java 21, Spring Boot 3.3.x, Spring Security, Spring Data JPA, PostgreSQL 14, Flyway, Docker |
| `finance_service/` | Invoice creation, status tracking, payments | Java 17, Spring Boot, Spring Data JPA, MariaDB 10.6, Docker |
| `library_service/` | Library account creation, book returns, fines | Python 3.7, Flask, MariaDB 10.6, Docker |
---
## 📦 Infrastructure
We orchestrate all services and shared infrastructure using two `docker compose` files:
* **Infra stack**: `docker-compose/docker-compose.infra.yml`
* Postgres (Student DB)
* MariaDB (Finance DB)
* MariaDB (Library DB)
* RabbitMQ (*Pub/Sub)
* Consul (Service Discovery)
* Traefik (Proxy)
* **App stack**: `docker-compose/docker-compose.app.yml`
* API Gateway (Spring Cloud Gateway)
* Student Service **[student-service]**
* Finance Service **[finance-service]**
* Library Service **[library-service]**
> All compose services share the `sesc_infra_net` and `sesc_app_net` networks.
### Prerequisites
* Docker & Docker Compose (v2+)
* Java 21 (for student-service)
* Python 3.7+ (for library-service development)
---
## 🛠️ Local Setup
1. **Clone and navigate**
```bash
git clone https://github.com/enkaypeter/sesc_microservices.git
```
2. **Build Entire Stack**
```bash
make build
```
3. **Start Infrastructure**
```bash
make infra
```
4. **Start Application Services**
```bash
make app
```
5. **Verify**
* student-service API: [http://localhost:8090/swagger-ui/index.html](http://localhost:8090/swagger-ui/index.html)
* finance-service API: [http://localhost:8081](http://localhost:8081)
* library-service API: [http://localhost:8082](http://localhost:8082)
5. **Shutdown**
```bash
make down-v
```
---
## 📚 Next Steps
* [ ] **Event-Driven Enhancements:**
* Publish `StudentCreatedEvent` and `InvoiceCreatedEvent` via RabbitMQ.
* Implement subscribers in Finance and Library for consistency.
* [ ] **Observability & Resilience:**
* Expose Prometheus metrics and add Grafana dashboards.
* Enable distributed tracing with OpenTelemetry.
* [ ] **CI/CD & Deployment:**
* Add GitHub Actions (or equivalent) to build, test, and push Docker images.
* [ ] **Developer Experience & Front-End:**
* Add a front-end that consumes the Student API.
* Improve local dev with a `Makefile` or `bash` script to spin up all services.
---
## 📄 License
*This project is part of an MSc Course Assessment and not intended for production use without further enhancements.*