simplify

docs/ARCHITECTURE.md

@@ -91,21 +91,27 @@ insta-recipe/
 ## Key Directories
 
 ### `/src/lib/server/`
+
 Server-side business logic following Hexagonal Architecture principles. Contains domain logic, adapters for external systems (Instagram, Tandoor, LLM), and port definitions.
 
 ### `/src/lib/client/`
+
 Client-side utilities for PWA features (push notifications, install prompts, service worker messaging).
 
 ### `/src/routes/api/`
+
 RESTful API endpoints implemented as SvelteKit server routes. Each directory contains `+server.ts` files exporting HTTP verb handlers.
 
 ### `/src/routes/share/`
+
 Share target page allowing users to share Instagram URLs directly from their browser or mobile apps.
 
 ### `/src/lib/server/queue/`
+
 Queue management system with in-memory storage, processor workers, and type definitions.
 
 ### `/docs/`
+
 Comprehensive documentation including plans, outcomes, API specs, and migration guides.
 
 ---
@@ -113,33 +119,43 @@ Comprehensive documentation including plans, outcomes, API specs, and migration
 ## Design Patterns
 
 ### Singleton Pattern
+
 Used for shared service instances:
+
 - `QueueManager` (`queueManager` exported instance)
 - `QueueProcessor` (`queueProcessor` exported instance)
 - `PushNotificationService` (`pushNotificationService` exported instance)
 - `ServiceWorkerMessageHandler` (`serviceWorkerMessageHandler` exported instance)
 
 ### Factory Pattern
+
 Used for creating configured instances:
+
 - `createLLM()` - Creates OpenAI client with environment configuration
 - `createBrowserContext()` - Creates Playwright browser context with options
 - `initializeBrowser()` - Initializes Chromium browser instance
 
 ### Observer Pattern
+
 Implemented in QueueManager for real-time updates:
+
 - Subscribers receive notifications on queue item changes
 - Server-Sent Events (SSE) stream queue updates to clients
 - Push notifications notify users of completion events
 
 ### Adapter Pattern (Hexagonal Architecture)
+
 External systems accessed via adapters:
+
 - **Instagram Adapter**: `extraction.ts` - Extracts content via Playwright
 - **LLM Adapter**: `llm.ts`, `parser.ts` - Recipe parsing via OpenAI
 - **Tandoor Adapter**: `tandoor.ts` - Recipe management system integration
 - **Browser Adapter**: `browser.ts` - Playwright browser automation
 
 ### Strategy Pattern
+
 Multiple extraction strategies with fallback:
+
 1. Embedded JSON extraction
 2. DOM selector extraction
 3. GraphQL API extraction
@@ -150,28 +166,34 @@ Multiple extraction strategies with fallback:
 ## Key Components
 
 ### Queue Management System
+
 **Location**: `src/lib/server/queue/`
 
 Three-phase processing pipeline:
+
 1. **Extraction Phase**: Extract text and thumbnail from Instagram
 2. **Parsing Phase**: Parse recipe using LLM
 3. **Uploading Phase**: Upload to Tandoor (if enabled)
 
 **Components**:
+
 - `QueueManager`: In-memory FIFO queue with CRUD operations
 - `QueueProcessor`: Worker that processes items with configurable concurrency
 - `types.ts`: Comprehensive type definitions for queue items and updates
 
 ### API Layer
+
 **Location**: `src/routes/api/`
 
 RESTful endpoints for:
+
 - Queue operations (`POST /api/queue`, `GET /api/queue`, `GET /api/queue/[id]`)
 - Real-time updates (`GET /api/queue/stream` - SSE)
 - Push notifications (`POST /api/notifications/subscribe`)
 - Health checks (`GET /api/health`, `GET /api/llm-health`)
 
 ### Client-Side Services
+
 **Location**: `src/lib/client/`
 
 - **PushNotificationManager**: Manages Web Push API subscriptions
@@ -179,14 +201,17 @@ RESTful endpoints for:
 - **ServiceWorkerMessageHandler**: Processes service worker messages
 
 ### Instagram Extraction
+
 **Location**: `src/lib/server/extraction.ts`
 
 Multi-method extraction with intelligent fallback:
+
 - Progress callbacks for real-time feedback
 - Retry logic with configurable attempts
 - Thumbnail extraction and validation
 
 ### LLM Integration
+
 **Location**: `src/lib/server/parser.ts`, `src/lib/server/llm.ts`
 
 - Recipe detection endpoint
@@ -198,6 +223,7 @@ Multi-method extraction with intelligent fallback:
 ## Dependencies
 
 ### Production Dependencies
+
 - **@types/uuid** (^10.0.0) - UUID type definitions
 - **date-fns** (^4.1.0) - Date utility library
 - **openai** (^4.20.0) - OpenAI API client
@@ -206,6 +232,7 @@ Multi-method extraction with intelligent fallback:
 - **zod** (^3.23.0) - Schema validation
 
 ### Development Dependencies
+
 - **@sveltejs/kit** (^2.48.5) - SvelteKit framework
 - **@sveltejs/adapter-node** (^5.4.0) - Node.js adapter
 - **svelte** (^5.43.8) - Svelte 5 framework
@@ -223,12 +250,14 @@ Multi-method extraction with intelligent fallback:
 ## Module Organization
 
 ### SvelteKit Path Aliases
+
 - `$lib` → `src/lib/`
 - `$lib/*` → `src/lib/*`
 - `$app/*` → SvelteKit app imports
 - `$env/dynamic/private` → Environment variables (server-side)
 
 ### Directory Structure Conventions
+
 - **Server-only code**: `src/lib/server/` (not bundled to client)
 - **Client-only code**: `src/lib/client/` (not executed on server)
 - **Shared code**: `src/lib/` (available to both)
@@ -240,6 +269,7 @@ Multi-method extraction with intelligent fallback:
 ## Data Flow
 
 ### Recipe Extraction Flow
+
 ```
 User submits URL
   ↓
@@ -261,6 +291,7 @@ SSE updates notify client
 ```
 
 ### Real-time Updates Flow
+
 ```
 Client connects to GET /api/queue/stream (SSE)
   ↓
@@ -274,6 +305,7 @@ Client updates UI reactively
 ```
 
 ### Push Notification Flow
+
 ```
 Client requests permission
   ↓
@@ -295,37 +327,44 @@ Notification displayed to user
 ## Build System
 
 ### Build Command
+
 ```bash
 npm run build
 ```
 
 Generates production-ready build in `build/` directory using:
+
 - Vite for bundling
 - `@sveltejs/adapter-node` for Node.js deployment
 - TypeScript compilation
 - SvelteKit prerendering and optimization
 
 ### Test Command
+
 ```bash
 npm test
 ```
 
 Runs test suite using Vitest with two projects:
+
 1. **Server tests**: Node environment for server-side code
 2. **Client tests**: Playwright browser for Svelte components
 
 ### Development Server
+
 ```bash
 npm run dev
 ```
 
 Starts Vite dev server with:
+
 - HTTPS enabled (certificates in `.ssl/`)
 - Hot module replacement
 - TypeScript checking
 - File watching
 
 ### Linting & Formatting
+
 ```bash
 npm run lint      # ESLint + Prettier check
 npm run format    # Prettier write
@@ -336,19 +375,24 @@ npm run format    # Prettier write
 ## Deployment
 
 ### Docker Deployment
+
 Dockerfile includes:
+
 - Node.js 22 Alpine base image
 - Playwright Chromium installation
 - Production build
 - Port 3000 exposure
 
 Run with:
+
 ```bash
 docker-compose up
 ```
 
 ### Environment Variables
+
 Required configuration:
+
 - `OPENAI_API_KEY` - LLM API access
 - `TANDOOR_URL` - Tandoor instance URL (optional)
 - `TANDOOR_TOKEN` - Tandoor API token (optional)
@@ -360,13 +404,16 @@ Required configuration:
 ## Testing Architecture
 
 ### Test Categories
+
 1. **Unit Tests**: Individual function testing
 2. **Integration Tests**: Multi-component workflows
 3. **API Tests**: Endpoint behavior validation
 4. **Browser Tests**: Svelte component rendering
 
 ### Test Coverage
+
 138 tests covering:
+
 - Queue management operations
 - Instagram URL validation
 - SSE streaming
@@ -375,6 +422,7 @@ Required configuration:
 - Notification service
 
 ### Test Configuration
+
 - **Server tests**: Node environment with mocked dependencies
 - **Client tests**: Playwright Chromium browser with Svelte testing library
 
@@ -383,15 +431,18 @@ Required configuration:
 ## Security Considerations
 
 ### SSL/TLS
+
 - Development uses local SSL certificates signed by external Caddy CA
 - Certificates stored in `.ssl/` (git-ignored)
 - Required for PWA features (Service Worker, Push API)
 
 ### Authentication
+
 - Basic auth for scheduled tasks (username/password from environment)
 - Tandoor integration uses bearer token authentication
 
 ### Input Validation
+
 - Instagram URL validation with regex patterns
 - Zod schema validation for API payloads
 - Error handling with custom error classes