Gastro1.pl Docs

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 TaskAdapterRegistry oraz wspólny handler HTTP handleTaskAdapterRequest,
  • 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.json oraz 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

ObszarOpisLokalizacja w monorepo
Portal dokumentacjiAplikacja Fumadocs (@repo/gastro1-pl-docs)apps/gastro1-pl/docs/package.json
SDK bota (klient)Komponent VoiceBotAdvisor, transport i obsługa mowypackages/ui/voice-bot-ui/src/index.ts
SDK bota (serwer)Rejestr adapterów TaskAdapterRegistry, handler HTTP i TTS/STTpackages/ui/voice-bot-ui/src/server/index.ts

Przejdź dalej

On this page