← Backend Frontend

FALCONIUM FRONTEND ARCHITECTURE

Live system map — derived from codebase analysis
Generated 4 March 2026 · Swift / SwiftUI
Built & working
Partial / needs work
Missing / not implemented
Planned (future)
Layer:
Architecture Pattern
L3
Pattern
MVVM + Coordinator
L3
Navigation Flow
Module lifecycle
L3
Platform
iPad Pro (M-series)
100% Swift / SwiftUI
Modules & Features
L3
📱
LogIn
Authentication
User authentication
Built
Microsoft OAuth
Built
L3
Preloader
Splash & init
App initialization
Built
L3
🌳
Root
App root navigation
Navigation coordinator
Built
L3
🏠
Home Module
Main workspace — 17 screens, all core features
💬 Conversation
Conversation (chat interface)
AllConversations (history)
📧 Email
Emails (list)
EmailDetail (view)
CreateEmail (compose)
ReplyEmail (reply)
ForwardEmail (forward)
📞 Meetings
AllMeetings (list)
Meeting (detail)
MeetingDetail (full)
CreateMeeting (schedule)
LetsHaveMeetingPopUp (modal)
📊 Projects
AllProjects (list)
ProjectView (detail)
CreateProject (create)
📄 Documents
Documents (library)
⚙️ System
LLMLoadProgressView (loading)
Services Layer
AI & ML
AIOrchestrator (routing)
SpeechToTextService
Networking
NetworkService (HTTP)
FileDownloader
FileStorage (local)
Authentication
TokenService (JWT)
MicrosoftAuthManager
KeychainService
Audio & Recording
AudioRecordingService
RecordingService
UI Support
LiveMessageWriter
KeyboardObserver
PermissionService
Application Support
L3
AppManager
AppError
Constants
Coordinator
Formatters
Global
Helpers
Mock
Protocols
Resources
Support
Validator
ViewComponents
LLM (libraries)
Backend & Cloud
L3
⚙️
Django Backend
REST API + WebSocket
Chats (conversations)
Email integration
Meetings (transcripts)
Projects & tasks
Documents (RAG)
MCP tools
LLM Providers
🧠
Anthropic Claude
Primary reasoning
🤖
OpenAI GPT-4o
Embeddings + fallback
🔍
Perplexity
Web search
On-Device Speech
🎤
WhisperKit
STT (planned)
🔊
FluidAudio
Diarization + TTS (planned)
Cloud Speech (Deprecated)
🌐
Replicate
STT fallback (being phased)
🎙️
ElevenLabs
TTS (being phased)
Integration
📤
Microsoft Graph
Outlook OAuth
🗂️
AWS S3
File storage
API Models Flow
25+ Request Models (Body/)
NetworkService
Backend API
Response Models
AI (Claude, GPT, Perplexity)
Email (CRUD, OAuth)
Meetings (transcripts, tasks)
Projects (create, manage)
Documents (RAG, upload)
Messaging (send, stream)
MCP Tools (invoke)
User Query Data Flow
User Input
AIOrchestrator
Route Decision
Routes to: Claude (general Q&A) | GPT-4o (embeddings) | Perplexity (web search)
LLM Response
LiveMessageWriter
Display
Streaming text + real-time UI updates + voice synthesis
Custom Network Layer
HTTP Stack
No Alamofire — full control
📦
Request Encoding
JSON + multipart support
🔄
Retry Logic
Exponential backoff
🔗
WebSocket Streaming
Real-time messages
🔐
Header Management
JWT + OAuth tokens