Warning
Hey! This is just a pet project I built to learn and experiment with technologies like Kafka, Go, Domain-Driven Design, Hexagonal Architecture, Mapbox, and more. It's not production-ready, there are no tests, just a fun playground for exploring how these pieces fit together.
A real-time air quality monitoring system that:
- Collects air quality data from the OpenAQ public API
- Streams it through Kafka
- Stores it in PostgreSQL using a clean DDD architecture
- Displays monitoring stations on an interactive map
┌─────────────────┐
│ OpenAQ API │
└────────┬────────┘
│
▼
┌─────────────────┐
│ Go Collector │
└────────┬────────┘
│
▼
┌─────────────┐
│ Kafka │
│ sensor-data │
└──────┬──────┘
▼
┌─────────────┐
│ Backend │
│ Spring Boot │
│ (DDD/Hex) │
└──────┬──────┘
│
┌───────────┴───────────┐
▼ ▼
┌─────────────┐ ┌─────────────┐
│ PostgreSQL │ │ REST API │
└─────────────┘ └──────┬──────┘
▼
┌─────────────┐
│ Frontend │
│ Next.js │
│ Mapbox │
└─────────────┘
| Component | Tech |
|---|---|
| Frontend | Next.js, TypeScript, Mapbox GL, Tailwind, shadcn/ui |
| Backend | Spring Boot, Java, Hexagonal Architecture, DDD |
| Data Collector | Go |
| Message Broker | Apache Kafka |
| Database | PostgreSQL |
- Hexagonal Architecture - Keeping domain logic isolated from infrastructure
- DDD Patterns - Aggregates, Value Objects, Repositories
- Event-Driven Systems - Using Kafka for async data ingestion
- Go - Building a simple data collector
- Mapbox - Interactive map visualizations
Do whatever you want with it. It's just for learning.