https://wiki.chuk.dev/index.php?action=history&feed=atom&title=Chuk_Chat_Architecture
Chuk Chat Architecture - Revision history
2026-04-15T01:55:03Z
Revision history for this page on the wiki
MediaWiki 1.45.1
https://wiki.chuk.dev/index.php?title=Chuk_Chat_Architecture&diff=23&oldid=prev
AI-Assistant: Add architecture overview with platform and layer explanations
2026-03-13T18:09:08Z
<p>Add architecture overview with platform and layer explanations</p>
<p><b>New page</b></p><div>= Chuk Chat Architecture =<br />
<br />
This page explains the system architecture at a level that is useful for curious users, product people, and technical readers.<br />
<br />
== Four-layer architecture ==<br />
Chuk Chat is organized in four main layers:<br />
<br />
# '''Presentation layer''': pages, chat UI, sidebars, settings screens.<br />
# '''Service layer''': business logic (chat handling, model config, sync, encryption helpers).<br />
# '''Data layer''': models and persisted chat data.<br />
# '''Platform layer''': platform-specific behavior for mobile, desktop, and web.<br />
<br />
== Why this architecture is used ==<br />
* Easier maintenance and safer updates<br />
* Better testing and reliability<br />
* Clear separation between UI, logic, and storage<br />
<br />
== Platform structure ==<br />
* '''Desktop''' (Windows, macOS, Linux): multi-panel layout with sidebar plus chat workspace.<br />
* '''Mobile''' (Android): single-panel chat with slide-out navigation and mobile input UX.<br />
* '''Web''': desktop-style layout with browser-safe platform stubs where needed.<br />
<br />
== State and sync model ==<br />
* UI state (input focus, scroll position) stays local to screens.<br />
* App state (chat content, selected model, preferences) is managed by services.<br />
* Persisted state (chat history, preferences) is stored and synced, with encrypted chat content.<br />
<br />
== Streaming architecture ==<br />
Chuk Chat supports both:<br />
* HTTP SSE streaming (POST /v1/ai/chat)<br />
* WebSocket streaming (/v1/ai/chat/ws)<br />
<br />
This gives good browser compatibility plus stable mobile streaming behavior.<br />
<br />
== Security architecture highlights ==<br />
* End-to-end encrypted chat storage<br />
* Certificate pinning on supported native platforms<br />
* Zero-data-retention provider filtering at the routing layer<br />
<br />
== Related pages ==<br />
* [[How Chuk Chat Works]]<br />
* [[Chuk Chat AI Providers and Services]]<br />
* [[Chuk Chat Backend and API]]<br />
<br />
[[Category:Chuk Chat]]<br />
[[Category:Architecture]]</div>
AI-Assistant