Reply Pilot Docs Site

Tato stranka popisuje modul reply-pilot-docs/, ktery publikuje projektovou dokumentaci Reply Pilotu jako samostatnou HTTP sluzbu.

Co je soucasti

• build root docs/ a root mkdocs.yml pres MkDocs
• jednoduchy Python HTTP server pro staticky vystup
• GET /healthz pro monitoring
• Docker image a Compose runtime s non-root uzivatelem
• logovani do reply-pilot-docs/logs/reply-pilot-docs.log

Source Of Truth

• kanonicky zdroj obsahu zustava v repo root docs/
• kanonicka MkDocs konfigurace zustava v repo root mkdocs.yml
• reply-pilot-docs/ je publikačni a deploy modul, ne primarni misto authoringu

Runtime

• aplikace bezi v kontejneru jako non-root uzivatel
• runtime UID:GID se do Compose predava pres HOST_UID a HOST_GID
• lokalni mounty jsou data -> /app/data, logs -> /app/logs, conf -> /app/conf
• conf/ mount zustava read-only
• aktivni log se zapisuje do reply-pilot-docs/logs/reply-pilot-docs.log
• image modulu se jmenuje reply-pilot-docs:latest
• host port je defaultne 127.0.0.1:9095
• produkcni URL je standardne https://reply-pilot-docs.mathbox.90.cz

Build Workflow

Pred lokalnim startem i pred deployem modul synchronizuje root docs/ a root mkdocs.yml do reply-pilot-docs/.build-context/.

Docker build pak pouzije tenhle lokalni snapshot, spusti mkdocs build a vysledny staticky web zabali do image.

Endpointy

• / homepage dokumentace
• /healthz health endpoint