AVAX Platform — Přehled specifikace

Každá komponenta má vlastní soubor specifikace. Při práci na konkrétní části načtěte pouze relevantní soubor.

Šablona a architektura

Soubor	Účel
_template.md	Šablona pro novou app specifikaci — vyplnit při onboardingu
per-app-container.md	Architektonický spec posunu od Python module mountu k per-app kontejnerům (2026-05-14 draft)
apps-gateway.md	FastAPI reverse proxy pro routing /apps/<slug>/* na app kontejnery — discovery z DB, health monitor, per-firma channel routing (2026-05-14 draft)

Pilot / aktivní apps

Soubor	App
avax-legal.md	AVAX Legal — časová osa zákonů + AI výklad (in-progress, pilot pro per-app kontejner)
app-hotline.md	Hotline AVAXIS — voice/call monitoring, STT, Q&A extraction, RAG knowledge base, billing podklady (draft v0.1)

Komponenty

Aplikace a launcher

Soubor	Komponenta
main-app.md	Hlavní aplikace — launcher, platformy, S3, offline
app-catalog.md	Katalog aplikací, manifest update, kanály alpha/beta/stable, AVAX SDK
app-distribution.md	Bucket-per-app distribuce, avax-publish CLI, finalize/promote
app-management-v2.md	Sjednocené UI pro vytváření a správu AVAX aplikací
launcher2-gui.md	GUI spec launcher2 — obrazovky, menu, témata, settings
launcher2-roadmap.md	Roadmap launcher2 — L2.2–L2.8
launcher2-tray-widget.md	L2.9 — background mode + mini widget nad taskbarem

Auth, uživatelé, oprávnění

Soubor	Komponenta
auth-organization.md	Auth, firmy (IČO), uživatelé, role, oprávnění, 2FA
users.md	Správa zaměstnanců — pracovní pozice, schvalování
user-data-sharing.md	Sdílené adresáře, S3 ACL, předání agendy
peer-sharing.md	Peer-to-peer sdílení sync adresáře

Komunikace a support

Soubor	Komponenta
chat.md	Chat — interní, support, meziremní, skupinový, broadcast
voice-chat.md	Hlasové hovory (starší verze — P2P v ChatWindow)
voice-video-call.md	WebRTC P2P hovory (aiortc), zařízení, video
support.md	Support — priorita, fronta, agenti, AI asistent, KB
custom-emoji-assets.md	Custom emoji/obrázkové assety — shortcode :name:, S3 + cache + fallback, picker, admin upload (v1 bez AI), draft

Zálohy, S3, sync

Soubor	Komponenta
s3backup.md	S3 Backup aplikace — multi-firma, devices, smart sync, monetizace
sync-backup.md	Synchronizace dat, zálohy, manifest protokol
s3-architecture.md	Izolace firem (Ceph RADOS user + bucket per firma), šifrování
s3-key-manager.md	Admin UI pro správu S3 credentials
s3-key-pool.md	Backend pool S3 klíčů — admin nahraje, backend přiřadí firmě

Portál, infrastruktura, deploy

Soubor	Komponenta
portal-management.md	Správa portálu — Avaxis superfirma, registrace, katalog, monitoring
server-infrastructure.md	Proxmox VM, PostgreSQL, Redis, AI service, monitoring
deployment.md	Installer, dev/prod prostředí, bootstrapper, Admin→Verze
backend-deploy.md	Backend deploy: Docker compose, image v S3, sealed secrets, triggers, pg_dump

Technologický stack (přehled)

Vrstva	Technologie
Desktop (Win/Linux)	Python + customtkinter (desktop/launcher2/) — aktivní vývoj
Desktop (archiv)	Tauri 2.0 / egui 0.31 (desktop/launcher/) — nevyvíjíme
Web aplikace	Next.js 15 (React, App Router)
Backend API	FastAPI (Python 3.12) + Celery
Real-time	WebSocket (přes API Gateway)
Databáze	PostgreSQL 16 + pgvector + Redis 7
AI	Ollama GPU (mistral:7b, nomic-embed-text) + Claude API (fallback)
Úložiště	S3 vlastní — https://s3.avaxis.cz/ (30 TB, MinIO/Ceph)

S3 kořenová struktura

s3://avaxis/
├── apps/           → viz app-catalog.md
├── users/          → viz sync-backup.md
├── chat/           → viz chat.md
└── system/         → launcher auto-update

Samostatné repo (mimo tento spec strom)

• app-AiCenter — C:\avaxis\app-AiCenter\ (vlastní repo, vyvíjí jiný Claude). Lokální orchestrátor nad ComfyUI/LM Studio/TRELLIS → generuje AVAX assety (emoji/obrázky). AVAX je konzument; kontrakt viz custom-emoji-assets.md §8 + app-AiCenter/docs/api-contract.md.

Aplikace plánované do budoucna (zatím nespecifikovány)

• Android aplikace — plugin architektura (Chat, Úkoly, Přehledy)
• Plánovací kalendář výroby a procesů — vstup do modulu Úkoly
• Úkoly (Tasks) — samostatná aplikace napojená na kalendář

---

Poslední aktualizace: 2026-05-14