# GO Kick

> GO Kick documentation, available as raw markdown for AI agents and LLMs. Append `.md` to any page URL, or send `Accept: text/markdown`.

## Getting Started
- [Getting Started](https://gokick.strategio.dev/index.md): GO CQRS DDD skeleton s Vue 3 SPA, SQLite databází a JWT autentizací – vše v jedné binárce.

## Framework
- [Framework](https://gokick.strategio.dev/framework.md): Architektura, vrstvy a infrastruktura skeletonu.
- [Overview](https://gokick.strategio.dev/framework/overview.md): Přehled frameworku -- tech stack, architektura, pravidla závislostí, lifecycle.
- [Dev Stack](https://gokick.strategio.dev/framework/overview/dev-stack.md): Technologický stack a adresářová struktura.
- [Installation](https://gokick.strategio.dev/framework/overview/commands.md): Instalace, build, lint, formátování a další make příkazy.
- [Architecture](https://gokick.strategio.dev/framework/overview/architecture.md): DDD vrstvy s CQRS, pravidla závislostí, lifecycle, cross-domain izolace.
- [Layers](https://gokick.strategio.dev/framework/overview/layers.md): Přehled všech balíčků v jednotlivých vrstvách a jejich zodpovědnosti.
- [Domain](https://gokick.strategio.dev/framework/domain.md): Doménová vrstva -- jádro aplikace bez závislostí.
- [Entity & Value Objects](https://gokick.strategio.dev/framework/domain/entities.md): Doménové entity (User, RefreshToken) a value objects (Nickname, Role, Email, Password).
- [Interfaces](https://gokick.strategio.dev/framework/domain/interfaces.md): Repository a service interfaces -- user.Repository, PasswordHasher, PermissionChecker, JwtService, Transactor, PermissionsRegistry.
- [Errors & Events](https://gokick.strategio.dev/framework/domain/errors-events.md): Doménové error typy (ValidationError, AuthError, PermissionError) a domain events s EventCollector.
- [Application](https://gokick.strategio.dev/framework/application.md): Application vrstva -- CQRS bus, commands, queries, event handlers.
- [Bus](https://gokick.strategio.dev/framework/application/bus.md): Balíček application/bus/ -- middleware chain, dispatch, tři instance.
- [Commands](https://gokick.strategio.dev/framework/application/commands.md): Balíček application/command/ -- write operace, validace, Permissioned interface.
- [Queries](https://gokick.strategio.dev/framework/application/queries.md): Balíček application/query/ -- CQRS read operace.
- [Events](https://gokick.strategio.dev/framework/application/events.md): Domain events -- jak vyhlásit "stalo se X" tak, aby na to reagoval kdokoli další, aniž by o tom command handler musel vědět.
- [Audit log](https://gokick.strategio.dev/framework/application/audit.md): Append-only zápis security-relevantních akcí, který přežije rollback business transakce.
- [Presentation](https://gokick.strategio.dev/framework/presentation.md): Prezentační vrstva -- HTTP server, handlery, middleware, CLI.
- [HTTP Server](https://gokick.strategio.dev/framework/presentation/http-server.md): Routing, SPA fallback, Vite proxy, response helpery, HTTPError interface.
- [Handlers & Middleware](https://gokick.strategio.dev/framework/presentation/http-handlers.md): HTTP handlery s bus dispatchem a middleware chain (trace, security headers, CORS, CSRF, logging, JWT).
- [Console](https://gokick.strategio.dev/framework/presentation/console.md): Cobra CLI -- root command, serve, seed a create-user subcommand.
- [Infrastructure](https://gokick.strategio.dev/framework/infrastructure.md): Infrastrukturní vrstva -- konfigurace, databáze, security, Wire DI.
- [Config](https://gokick.strategio.dev/framework/infrastructure/config.md): Balíček infrastructure/config/ -- .env soubory, Config struct.
- [Database](https://gokick.strategio.dev/framework/infrastructure/database.md): Balíčky database/ a sqlite/ -- SqliteManager, migrace, BaseRepository, repozitáře.
- [Security](https://gokick.strategio.dev/framework/infrastructure/security.md): Balíček infrastructure/security/ -- JwtService, PasswordHasher, PermissionChecker.
- [Wire DI](https://gokick.strategio.dev/framework/infrastructure/wire.md): Balíček infrastructure/di/ -- compile-time DI, workflow.
- [Scheduler](https://gokick.strategio.dev/framework/infrastructure/scheduler.md): In-process scheduler -- jak nastavit, že se něco má provádět pravidelně (každou hodinu, každý den) uvnitř běžícího serveru.
- [Job Queue](https://gokick.strategio.dev/framework/infrastructure/job-queue.md): Perzistentní fronta pro background práci -- jak rozjet úlohu, která musí proběhnout i když proces mezitím spadne.
- [Observability](https://gokick.strategio.dev/framework/infrastructure/observability.md): Strukturované logování, jednotná slovní zásoba atributů, korelace přes trace_id/user_id a připravený šev pro OpenTelemetry.

## Guides
- [Guides](https://gokick.strategio.dev/guides.md): Praktické návody -- autentizace, frontend, build a deploy.
- [Authentication](https://gokick.strategio.dev/guides/auth.md): JWT access + refresh token, session lifecycle, role & permissions.
- [Permissions](https://gokick.strategio.dev/guides/permissions.md): Jak fungují role a permissions. Deklarace v handlerech, kontrola přes bus, seznam pro frontend.
- [Frontend Utils](https://gokick.strategio.dev/guides/frontend-utils.md): Přehled všech frontend utilit — fetch, auth, toast, modals.
- [Forms & Validation](https://gokick.strategio.dev/guides/forms.md): Jak napsat formulář, který mluví s API a renderuje chyby z backendu. Validace žije v doméně, frontend ji jen propisuje.
- [Sentry](https://gokick.strategio.dev/guides/sentry.md): Nastavení error trackingu (Sentry) pro backend i frontend — projekty, DSN, dev vs prod delivery, deploy za Cloudflare, ověření.

## Business Logic
- [Business Logic](https://gokick.strategio.dev/business.md): Placeholder pro Business pravidla projektu.

## Codebase
- [Codebase](https://gokick.strategio.dev/codebase.md): Placeholder pro Algoritmy a znovupoužitelné balíčky v rámci projektu.

## Roadmap
- [Roadmap](https://gokick.strategio.dev/roadmap.md): Fázovaný plán dotažení skeletonu do produkce — od opravy event flow přes job queue až po hardening a observabilitu.

## Optional
- [MCP endpoint](https://gokick.strategio.dev/mcp): Model Context Protocol server for programmatic, token-efficient access to this documentation.