How akira0610/eq-impactmap works
Project type and purpose
• This is a full-stack web application (“Global Earthquake Realtime Visualization Platform”) that fetches real-time data from the USGS, processes it, exposes it via a REST API (FastAPI), and visualizes it on an interactive map in the browser.
File structure
• Top-level:
• .github/workflows/deploy.yml → CI/CD pipeline
• Dockerfile → containerization
• java-fetcher/ → Java-based periodic data-fetcher
• python-api/ → FastAPI application (routers, services, templates)
• static/ → CSS/JS assets for the frontend
• Key patterns:
• java-fetcher/src/EarthquakeFetcher.java → scheduled fetch-and-push job
• python-api/routers and python-api/services → clear separation of routing vs business logic
• python-api/templates + static/ → backend-served static assets and HTML views
• Deployment/config: Docker, GitHub Actions
README insights
• Components described: USGS → Java Fetcher → FastAPI → Frontend → deck.gl + Mapbox
• Tech stack: Java, Python (FastAPI), HTML/CSS/JS, pydeck/Mapbox
Essential elements to capture
• External USGS feed
• Java‐based fetcher service and its schedule
• FastAPI server’s routers and services
• Static/template serving path
• Client-side visualization stack (deck.gl + Mapbox)
• CI/CD pipeline and Docker deployment