How unlockdigital/loci works
Loci is a research-evidence viewer and authoring system: a reader browses published objects, selects a model annotation, follows its video and timed transcript, and shares a citation or moment. Authors manage source objects, models, videos, transcripts, and annotations through the authenticated console; search and public delivery provide discovery and reader access. The API also includes project-scoped authoring review and semantic/visual search capabilities. Edges are limited to README-described behavior or relationships visible in the supplied excerpts and source index; unsampled subsystems are represented at their exact enclosing directories.
Main entry points: api.js API client · EvidenceObjectApp.jsx Evidence viewer · main.py API routing · endpoints Domain endpoints
Components 24
Public experience
- Object browser
apps/web/src/public/PublicBrowseApp.jsx - Evidence viewer
apps/web/src/evidence/EvidenceObjectApp.jsx - 3D model canvas
apps/web/src/components/ModelCanvas.jsx - Public experience shell
apps/web/src/components/PublicExperienceShell.jsx - Search controls
apps/web/src/components/SearchAutosuggest.jsx - API client
apps/web/src/lib/api.js - Share navigation
apps/web/src/lib/navigation.js - Brand components
apps/web/src/components/BrandLockup.jsx - Studio search
apps/web/src/evidence/studio/StudioSearch.jsx
Authoring and review
- Authoring console
apps/web/src/App.jsx - Authoring endpoints
apps/api/app/api/v1/endpoints/authoring/routes.py - Authentication
apps/api/app/api/v1/endpoints/auth.py
API and domain services
- API routing
apps/api/app/main.py - Public object and clip routes
apps/api/app/api/public/endpoints - Domain endpoints
apps/api/app/api/v1/endpoints - Semantic and visual search
apps/api/app/api/v1/endpoints/search.py - Media and transcript services
apps/api/app/services - Public publication services
apps/api/app/services/public_sync.py
Persistence and integrations
- Database session
apps/api/app/db/session.py - Research records
apps/api/app/models/entities.py - Embedding providers
apps/api/app/services/ai
Other components
- Reader
- PostgreSQL
- Redis queue
Connections 24
- Reader → Object browser: browses
README.md - Object browser → Evidence viewer: opens object
README.md - Evidence viewer → 3D model canvas: selects model
README.md - Evidence viewer → API client: requests evidence
apps/web/src/evidence/EvidenceObjectApp.jsx - Search controls → API client: fetches suggestions
apps/web/src/components/SearchAutosuggest.jsx - Evidence viewer → Studio search: renders search
apps/web/src/evidence/EvidenceObjectApp.jsx - Public experience shell → 3D model canvas: uses canvas
apps/web/src/components/PublicExperienceShell.jsx - Authoring console → API client: requests clips
apps/web/src/App.jsx - Authoring console → API client: loads transcript
apps/web/src/App.jsx - API client → API routing: calls API
- API routing → Public object and clip routes: routes requests
- API routing → Domain endpoints: routes requests
- Domain endpoints → Semantic and visual search: dispatches search
apps/api/app/api/v1/router.py - Domain endpoints → Authoring endpoints: dispatches authoring
apps/api/app/api/v1/endpoints/authoring/routes.py - Domain endpoints → Authentication: dispatches auth
apps/api/app/api/v1/router.py - Semantic and visual search → Embedding providers: uses embeddings
apps/api/app/api/v1/endpoints/search.py - Authoring endpoints → Research records: queries records
apps/api/app/api/v1/endpoints/authoring/routes.py - Database session → PostgreSQL: connects
apps/api/app/db/session.py - Authoring endpoints → Database session: uses session
apps/api/app/api/v1/endpoints/authoring/routes.py - Semantic and visual search → Database session: queries records
apps/api/app/api/v1/endpoints/search.py - Research records → Database session: maps tables
apps/api/app/models/entities.py - Public object and clip routes → Public publication services: serves published data
- Media and transcript services → Research records: records media
apps/api/app/services/notify_digest_worker.py - API routing → Redis queue: uses queue