quay/ARCHITECTURE.md

Architecture

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

Contextification Addendum

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.