How dpan538/graphic_design_archive works
MGDA is a rights-aware research archive: its main reader workflow is browsing the Index or searching, opening an eligible object record, and consulting its source and provenance information. Public reads use versioned projections rather than a live database connection; PostgreSQL and migration tooling support research and release preparation. TRACE adds Context Canvas, bounded Exploration, and a separately labelled Open Inquiry layer; Spacetime is documented but unreleased. The README establishes these capabilities, while sampled controllers show request dispatch for read APIs and Exploration. Wiring not evidenced by the supplied excerpts is omitted.
Main entry points: project.server.ts Generated projections · read-api-controller.ts Public read API · directory/page.tsx Index · search/page.tsx Search
Components 17
Public Archive
- Index
frontend/src/app/directory/page.tsx - Search
frontend/src/app/search/page.tsx - Object records
frontend/src/app/surfaces/[id]/page.tsx - Reader eligibility
frontend/src/features/reader-eligibility/index.server.ts
Read API
- Public read API
frontend/src/lib/read-platform/server/read-api-controller.ts - Index endpoint
frontend/src/app/api/index/v1/route.ts - Search endpoints
frontend/src/app/api/search/v1/route.ts
TRACE Research
- Context Canvas
frontend/src/features/trace-v49/context/canvas/index.ts - Exploration V2
frontend/src/features/trace-v49/exploration-v2/controller.server.ts - Exploration views
frontend/src/features/trace-v49/exploration-view/controller.server.ts - Exploration V3
frontend/src/features/trace-v49/exploration-v3/controller.server.ts - Open Inquiry
frontend/src/features/trace-v49/open-inquiry-v1/controller.server.ts - Spacetime
frontend/src/features/trace-v49/spacetime/gis/index.ts
Research Data
- Generated projections
frontend/src/features/trace-v49/context/realdata/project.server.ts - Research database
database/data-migrations/v48-to-v49/verify.py
Other components
- Archive reader
- Researcher
Connections 18
- Archive reader → Index: browses
- Archive reader → Search: searches
- Archive reader → Object records: opens
- Researcher → Context Canvas: researches with
- Researcher → Exploration V2: explores
- Researcher → Open Inquiry: reviews hypotheses
- Index → Index endpoint: requests catalogue
- Search → Search endpoints: requests results
- Index endpoint → Public read API: dispatches reads
- Search endpoints → Public read API: dispatches reads
- Object records → Public read API: reads public data
- Public read API → Generated projections: reads projections
- Index → Reader eligibility: filters readers
- Search → Reader eligibility: filters readers
- Exploration V2 → Generated projections: loads read model
- Exploration views → Generated projections: loads read model
- Exploration V3 → Generated projections: loads read model
- Research database → Generated projections: prepares release data