How therishabhpro/gapas-game-aesthetic-preference-analysis-system works
GAPAS is a research dataset platform whose main workflow is to capture or upload gameplay screenshots, remove near-duplicates, persist session and image records, analyze images with a configurable VLM, validate annotations against one dataset schema, and export dataset rows. The graph distinguishes UI/API orchestration from capture, analysis, validation, storage, and export responsibilities. Some integration wiring is inferred only from documented capabilities or import references; unverified links are dashed, and unsampled implementation details are not asserted.
Main entry points: analysis-pipeline.ts VLM Analysis Pipeline · route.ts Screenshot API · index.ts Export Query · connection.ts DB Connection
Components 24
Research UI
- Session Workspace
app/session/[id]/page.tsx - Folder Upload
components/UploadZone.tsx - Session API
app/api/sessions/route.ts - Session Detail API
app/api/sessions/[id]/route.ts
Capture Intake
- Screenshot API
app/api/screenshots/route.ts - Live Capture
lib/capture/screen-capture.ts - Duplicate Detection
lib/capture/duplicate-detector.ts - Image Storage
lib/storage
Analysis and Schema
- Analysis API
app/api/analysis/route.ts - VLM Analysis Pipeline
lib/vlm/analysis-pipeline.ts - Provider Registry
lib/vlm/index.ts - Prompt Builder
lib/vlm/prompt-builder.ts - Mock Analysis
lib/vlm/mock-analysis-service.ts - Dataset Schema
lib/schema/dataset-schema.ts - Response Validation
lib/validation/schema-validator.ts
Persistence
- MongoDB
- DB Connection
lib/db/connection.ts - Session Records
lib/db/models/session.ts - Screenshot Records
lib/db/models/screenshot.ts - Trait Records
lib/db/models/trait.ts
Dataset Export
- Export API
app/api/export/route.ts - Export Query
lib/export/index.ts - Format Exporters
lib/export
Other components
- Researcher
Connections 29
- Researcher → Session Workspace: uses capture
README.md - Researcher → Folder Upload: uploads files
README.md - Session Workspace → Live Capture: starts capture
app/session/[id]/page.tsx - Folder Upload → Duplicate Detection: checks duplicates
components/UploadZone.tsx - Session Workspace → Screenshot API: submits screenshots
- Screenshot API → Duplicate Detection: checks hashes
app/api/screenshots/route.ts - Screenshot API → Image Storage: stores images
app/api/screenshots/route.ts - Screenshot API → DB Connection: connects DB
app/api/screenshots/route.ts - Screenshot API → Screenshot Records: reads and writes
app/api/screenshots/route.ts - Screenshot API → Session Records: reads session
app/api/screenshots/route.ts - DB Connection → MongoDB: connects
lib/db/connection.ts - Researcher → Analysis API: requests analysis
- Analysis API → VLM Analysis Pipeline: runs analysis
app/api/analysis/route.ts - VLM Analysis Pipeline → Provider Registry: selects provider
lib/vlm/analysis-pipeline.ts - VLM Analysis Pipeline → Prompt Builder: builds prompts
lib/vlm/analysis-pipeline.ts - Provider Registry → Mock Analysis: registers mock
lib/vlm/index.ts - VLM Analysis Pipeline → Response Validation: validates response
lib/vlm/analysis-pipeline.ts - Response Validation → Dataset Schema: derives fields
- VLM Analysis Pipeline → DB Connection: connects DB
lib/vlm/analysis-pipeline.ts - VLM Analysis Pipeline → Session Records: updates status
lib/vlm/analysis-pipeline.ts - VLM Analysis Pipeline → Screenshot Records: reads and updates
lib/vlm/analysis-pipeline.ts - VLM Analysis Pipeline → Trait Records: writes traits
lib/vlm/analysis-pipeline.ts - Screenshot Records → Dataset Schema: builds analysis fields
lib/db/models/screenshot.ts - Researcher → Export API: requests export
- Export API → Export Query: queries rows
app/api/export/route.ts - Export Query → DB Connection: connects DB
lib/export/index.ts - Export Query → Trait Records: reads traits
lib/export/index.ts - Export Query → Format Exporters: dispatches format
lib/export/index.ts - Export Query → Dataset Schema: uses field order
lib/export/index.ts