index

@CKIR.IO/VISIONS Technical Wiki

Table of Contents

Server Architecture

• 0. Introduction & System Overview
• 1. Server Overview
• 1.1. REST Interfaces
• 1.2. MCP Interfaces
• 1.3. BullMQ Async Processing
• 1.4. Socket.IO Real-time Layer
• 1.5. Image Preprocessing Pipeline

Dashboard

• 2. Dashboard Overview
• 2.1. Frontend Architecture
• 2.2. Color Harmony & Theming
• 2.3. State Management & Real-time Events

Development Methodology

• 3. AI-Assisted Development: Vibe Coding, Context Coding, and Code Ownership
• 3.1. Market Positioning & Competitive Landscape

Navigation

Document	Concern	Key Sections
0-introduction	System architecture, communication patterns, technology matrix	Architecture diagram, component overview, technology matrix
1-server	Server entry point, module graph, request lifecycle	Endpoint registry, configuration stack, error handling strategy
1.1-rest	REST API design, multipart handling, response contracts	Endpoint specification, request flow, REST vs MCP comparison
1.2-mcp	MCP protocol implementation, JSON-RPC 2.0 transport	Method reference, controller dispatch, transport characteristics
1.3-bullmq	Job queue architecture, worker lifecycle, scaling	Queue topology, retry strategy, worker architecture, buffer serialization
1.4-socketio	Real-time event system, room management, scaling	Event system, room lifecycle, Redis adapter, result delivery
1.5-image-preprocessing	Image preprocessing, variant taxonomy, OCR benefits	Pipeline architecture, variant taxonomy, CLAHE parameters, fault resilience
2-dashboard	Dashboard purpose, technology stack, functional panels	Panel descriptions, environment configuration, directory structure
2.1-architecture	Vue 3 component hierarchy, composables, API layer	Component hierarchy, composable patterns, TanStack Vue Query integration
2.2-color-harmony	Theme system, color harmony, Tailwind v4 integration	Theme taxonomy, semantic color system, AppThemeSwitcher component
2.3-state-and-realtime	Pinia stores, Socket.IO client, event log	Store architecture, connection lifecycle, state transitions
3-ai-assisted-development	Vibe coding, context coding, code ownership, research synthesis	Empirical evidence, enterprise rationale, remediation framework
3.1-market-positioning	Market fit, competitive landscape, benefits, drawbacks, strategic positioning	Competitor comparison, risk analysis, niche differentiation