Przegląd Gastro1.pl
Testowy projekt gastro1.pl oparty na TanStack Start, Fumadocs oraz SDK bota głosowo-tekstowego @repo/voice-bot-ui.
Przegląd projektu testowego Gastro1.pl
Gastro1.pl (gastro1.pl) to testowy projekt aplikacji gastronomicznej w monorepo spottedx, przygotowany do weryfikacji pełnego cyklu integracji bota głosowo-tekstowego z pakietu @repo/voice-bot-ui w środowisku TanStack Start + Cloudflare Workers (workerd).
Projekt służy jako poligon referencyjny dla:
- osadzania interaktywnego doradcy głosowego (
VoiceBotAdvisor) z wizualizacją robota 3D i synchronizacją mowy, - routingu zadań domenowych po stronie serwera poprzez rejestr adapterów
TaskAdapterRegistryoraz wspólny handler HTTPhandleTaskAdapterRequest, - obsługi endpointów konwersacyjnych i głosowych (
/api/chat,/api/tts,/api/stt), - utrzymywania dokumentacji technicznej w Fumadocs wraz z eksportem
/docs/llms.txt,/docs/llms-full.txt,/docs/openapi.jsonoraz endpointem MCP/docs/serwer-mcp.
flowchart TD
User([Użytkownik / Gość Gastro1.pl]) <-->|Tekst / Mowa STT / Audio TTS| UI[Interfejs Gastro1.pl\nVoiceBotAdvisor + React 19]
UI -->|POST /api/chat| Chat[Handler /api/chat\nhandleTaskAdapterRequest]
Chat --> Registry[TaskAdapterRegistry\nWybór adaptera i weryfikacja scope]
Registry -->|Draft / CAS / Walidacja| Adapter[Adapter zadania gastronomicznego\nBotTaskAdapter]
UI -->|POST /api/tts| TTS[Handler /api/tts\nhandleTtsRequest]
UI -->|POST /api/stt| STT[Handler /api/stt\nhandleSttRequest]Struktura dokumentacji i modułów
| Obszar | Opis | Lokalizacja w monorepo |
|---|---|---|
| Portal dokumentacji | Aplikacja Fumadocs (@repo/gastro1-pl-docs) | apps/gastro1-pl/docs/package.json |
| SDK bota (klient) | Komponent VoiceBotAdvisor, transport i obsługa mowy | packages/ui/voice-bot-ui/src/index.ts |
| SDK bota (serwer) | Rejestr adapterów TaskAdapterRegistry, handler HTTP i TTS/STT | packages/ui/voice-bot-ui/src/server/index.ts |
Przejdź dalej
- Integracja Bot SDK (@repo/voice-bot-ui) — kontrakt
TaskAdapterRegistry, obsługa żądań whandleTaskAdapterRequestoraz specyfikacja endpointów/api/chat,/api/ttsi/api/stt.