How joao-henrike/nova works
NOVA/CloudStart is an AWS-hosted web application and infrastructure project. The visible runtime workflow is browser use of the frontend, FastAPI routing, OAuth-backed authentication or item operations, and PostgreSQL persistence. The README also documents cloud operations and monitoring; the tree exposes FinOps, monitoring, and resilience code, but not the Terraform and deployment modules described there. The graph therefore maps only evidenced source paths and uses the README for documented product-level relationships; unsampled implementation details are omitted.
Main entry points: app.js Browser frontend · auth.py Authentication routes · main.py FastAPI application · items.py Item routes
Components 25
Web application
- Browser frontend
apps/frontend/public/app.js - Store workflow
apps/frontend/public/store.js - Checkout flow
apps/frontend/public/checkout.js - Quote flow
apps/frontend/public/quote.js - Confirmation view
apps/frontend/public/confirmation.js - API status
apps/frontend/public/api-status.js
Backend API
- FastAPI application
apps/backend/app/main.py - Authentication routes
apps/backend/app/api/routes/auth.py - Item routes
apps/backend/app/api/routes/items.py - Health routes
apps/backend/app/api/routes/health.py - Authentication service
apps/backend/app/services/auth.py - OAuth providers
apps/backend/app/services/providers.py - Token security
apps/backend/app/core/security.py - Auth repository
apps/backend/app/repositories/auth.py - Auth rate limits
apps/backend/app/services/rate_limit.py - Items service
apps/backend/app/services/items.py - Items repository
apps/backend/app/repositories/items.py - Item schemas
apps/backend/app/schemas/item.py
Operations and insight
- FinOps commands
finops/finops.py - Cost pricing
finops/pricing.py - Monitoring bootstrap
monitoring/bootstrap.py - Resilience runner
resilience/run.py
Other components
- Web user
- PostgreSQL
- Google and Apple
Connections 25
- Web user → Browser frontend: uses
- Browser frontend → FastAPI application: calls API
- Browser frontend → Store workflow: uses
- Browser frontend → Checkout flow: uses
- Browser frontend → Quote flow: uses
- Browser frontend → Confirmation view: uses
- Browser frontend → API status: uses
- FastAPI application → Authentication routes: registers
apps/backend/app/main.py - FastAPI application → Item routes: registers
apps/backend/app/main.py - FastAPI application → Health routes: registers
apps/backend/app/main.py - Authentication routes → Authentication service: calls
apps/backend/app/api/routes/auth.py - Authentication routes → Auth rate limits: enforces
apps/backend/app/api/routes/auth.py - Authentication routes → OAuth providers: calls
apps/backend/app/api/routes/auth.py - Authentication service → Auth repository: calls
apps/backend/app/services/auth.py - Authentication service → Token security: creates tokens
apps/backend/app/services/auth.py - Authentication routes → Google and Apple: redirects to
apps/backend/app/api/routes/auth.py - Authentication routes → PostgreSQL: reads/writes
apps/backend/app/api/routes/auth.py - Item routes → Items service: calls
apps/backend/app/api/routes/items.py - Items service → Items repository: calls
apps/backend/app/services/items.py - Item routes → Item schemas: validates
apps/backend/app/api/routes/items.py - Items repository → PostgreSQL: reads/writes
- Health routes → PostgreSQL: checks
apps/backend/app/api/routes/health.py - FinOps commands → Cost pricing: uses
finops/finops.py - Monitoring bootstrap → PostgreSQL: configures
- Resilience runner → PostgreSQL: operates