How evr1lay/grooves works
Grooves is a record-catalog application: a user interacts with a single-page frontend, which uses a FastAPI CRUD API to list, create, update, and delete records. Requests pass through route handlers and dependency injection to a record service, repository, and SQLite-backed SQLAlchemy models. Schemas define API payloads, while application startup initializes the database tables. The README documents the frontend and CRUD API; frontend implementation details and its exact HTTP wiring were not sampled.
Main entry points: routers/record.py Record routes · session.py Database session · main.py FastAPI application · repositories/record.py Record repository
Components 13
API and application
- FastAPI application
app/main.py - Record routes
app/api/routers/record.py - Service dependencies
app/api/dependencies.py
Record domain
- Record schemas
app/schemas/record.py - Record service
app/services/record.py
Persistence
- Record repository
app/repositories/record.py - Record ORM model
app/models/record.py - ORM base
app/models/base.py - Database session
app/db/session.py - Database configuration
app/core/config.py - SQLite records store
Client
- Record frontend
frontend/index.html
Other components
- User
Connections 19
- User → Record frontend: uses
README.md - Record frontend → Record routes: calls CRUD API
README.md - FastAPI application → Record routes: registers
app/main.py - FastAPI application → ORM base: creates tables
app/main.py - FastAPI application → Database session: uses engine
app/main.py - Record routes → Service dependencies: resolves service
app/api/routers/record.py - Record routes → Record service: calls
app/api/routers/record.py - Record routes → Record schemas: validates and returns
app/api/routers/record.py - Service dependencies → Database session: gets session
app/api/dependencies.py - Service dependencies → Record service: constructs
app/api/dependencies.py - Record service → Record repository: calls
app/services/record.py - Record service → Record schemas: validates output
app/services/record.py - Record repository → Record ORM model: queries and persists
app/repositories/record.py - Record repository → Record schemas: accepts payloads
app/repositories/record.py - Record repository → Database session: uses session
app/repositories/record.py - Record ORM model → ORM base: extends
app/models/record.py - Database session → Database configuration: loads settings
app/db/session.py - Database session → SQLite records store: connects
app/db/session.py - FastAPI application → SQLite records store: initializes schema
app/main.py