Formatting, README and other friends

README.md

@@ -33,7 +33,7 @@ odpowiadające warstwom aplikacji:
 ```
 zyrarbot/
 ├── settings.py        Settings - konfiguracja ze zmiennych środowiskowych
-├── application.py     Application - korzeń kompozycji, spina bota i serwer web
+├── application.py     Application - korzeń kompozycji, spina bota i API
 ├── storage/           Warstwa trwałości (pliki JSON, katalog uploadów)
 │   ├── json_file_store.py          JsonFileStore
 │   ├── guild_config_repository.py  GuildConfigRepository
@@ -52,18 +52,25 @@ zyrarbot/
 │   ├── track_embed_factory.py          TrackEmbedFactory
 │   ├── notification_channel_resolver.py NotificationChannelResolver
 │   └── music_player.py                 MusicPlayer
-├── bot/               Warstwa Discorda
-│   ├── client.py          MusicBot
-│   ├── guild_resolver.py  GuildResolver
-│   └── cogs/music_cog.py  MusicCog
-└── web/               Panel webowy (FastAPI)
-    ├── factory.py             create_app
-    ├── connection_manager.py  ConnectionManager
-    ├── status_service.py      StatusService
-    ├── status_broadcaster.py  StatusBroadcaster
-    ├── dependencies.py        wstrzykiwanie zależności z app.state
-    ├── schemas/               modele żądań - jeden na plik
-    └── routers/               trasy pogrupowane tematycznie
+└── ui/                Warstwa interfejsów użytkownika
+    ├── api/            API panelu (FastAPI)
+    │   ├── factory.py             mount_api - konfiguracja i routery API
+    │   ├── connection_manager.py  ConnectionManager
+    │   ├── status_service.py      StatusService
+    │   ├── status_broadcaster.py  StatusBroadcaster
+    │   ├── dependencies.py        wstrzykiwanie zależności z app.state
+    │   ├── requests/               modele żądań - jeden na plik
+    │   └── routers/                trasy pogrupowane tematycznie
+    └── bot/            Warstwa Discorda
+        ├── client.py              MusicBot
+        ├── guild_resolver.py      GuildResolver
+        └── cogs/                  komendy i listenery Discorda
+            ├── common.py          wspólne zależności i helpery
+            ├── playback_cog.py    PlaybackCog
+            ├── queue_cog.py       QueueCog
+            ├── control_cog.py     ControlCog
+            ├── voice_cog.py       VoiceCog
+            └── settings_cog.py    SettingsCog
 ```
 
 ### Zasady
@@ -73,5 +80,5 @@ zyrarbot/
   dwóch niezależnych ścieżek modyfikujących kolejkę.
 - **Kolejka jest nieusuwalna, pozycję śledzi indeks** (`GuildMusicState.index`),
   dzięki czemu działa przeskakiwanie i przewijanie w tył.
-- **Zależności wędrują przez konstruktory**, a w warstwie web przez `app.state`
-  i funkcje z `web/dependencies.py`. Nie ma globalnych singletonów.
+- **Zależności wędrują przez konstruktory**, a w API przez `app.state`
+  i funkcje z `api/dependencies.py`. Nie ma globalnych singletonów.