See the agent_docs/ directory for detailed architecture documentation:
- architecture.md — Key files, components, and system design
- api.md — API endpoints and authentication
- database.md — Database models and migrations
- development.md — Local development setup
- testing.md — Testing patterns and fixtures
- workflow.md — Dev workflow, JIRA, PRs, CI
flowchart LR
client[Client]
flask[Flask app]
api[REST API]
v2[OCI registry API]
model[Data model]
db[(Database)]
storage[Object storage]
workers[Workers]
client --> flask
flask --> api
flask --> v2
api --> model
v2 --> model
model --> db
v2 --> storage
workers --> model
workers --> storage
Quay state is split between database metadata, Redis coordination/cache data, and object storage blobs. Use data/model/ and data/registry_model/ rather than direct endpoint-to-database shortcuts.