How miniflux/v2 works
Main Components
a. Core Application Components:
• Web Server Layer (internal/http/server)
• API Layer (internal/api)
• User Interface Layer (internal/ui)
• Database Layer (PostgreSQL)
• Feed Processing System (internal/reader)
• Background Workers (internal/worker)
b. External Integrations:
• RSS/Atom Feed Sources
• Integration Services (internal/integration)
• Multiple third-party services (Pocket, Telegram, Matrix, etc.)
• Authentication Systems (OAuth2, WebAuthn)
Architecture Pattern Representation
[Client Layer]
• ↓↑
[Web/API Layer]
• ↓↑
[Service Layer]
• ↓↑
[Storage Layer]
Component Details
Frontend:
• Static assets (CSS/JS/Templates)
• Multiple UI views
• API clients
Backend Services:
• Feed fetcher and parser
• Content sanitizer
• Media proxy
• Job scheduler
• Authentication handler
• Integration handlers
Database:
• PostgreSQL with direct SQL (no ORM)
• User management
• Feed storage
• Entry storage
• Category management
Key Flows to Highlight
• Feed Processing Flow:
• [Feed Sources] → [Fetcher] → [Parser] → [Sanitizer] → [Storage]
• User Request Flow:
• [Browser] → [Web Server] → [Handler] → [Service] → [Database]
Important Elements
• Security boundaries
• Authentication flow
• Background job processing
• Content processing pipeline
• Integration points
• Data flow directions
Specific Implementation Notes
• Separation between the different API implementations (REST, Fever, Google Reader)
• Worker pool system
• Template engine system
• Localization system
• Static file serving mechanism