KAOS/TASKS/review/T12.md
djuka 563abd8481 T12: Dodat docs viewer sa goldmark markdown renderovanjem
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20 12:42:11 +00:00

1.7 KiB

T12: Dashboard — prikaz dokumentacije i CLAUDE.md

Kreirao: planer Datum: 2026-02-20 Agent: coder Model: Sonnet Zavisi od: T11


Opis

Dodaj tab/sekciju na dashboard za prikaz dokumentacije. Prikazuje CLAUDE.md renderovan kao HTML, sa klikabilnim referencama koje otvaraju referencirane fajlove inline.

Endpointi

GET /docs                    → lista svih .md fajlova (HTML)
GET /docs/{path...}          → renderovan markdown fajl (HTML fragment)

Kako radi

  1. Sidebar ili tab "Dokumenti" pored Kanban boarda
  2. Klik → prikaže CLAUDE.md renderovan kao HTML
  3. Reference u tabeli (npr. agents/coder/CLAUDE.md) su linkovi
  4. Klik na link → HTMX učita taj fajl: hx-get="/docs/agents/coder/CLAUDE.md"
  5. Breadcrumb navigacija: CLAUDE.md > agents > coder > CLAUDE.md
  6. Dugme "Nazad" vraća na prethodni fajl

Markdown renderovanje

  • Go library: github.com/gomarkdown/markdown ili goldmark
  • Renderuj server-side u HTML
  • Tabele, code blokovi, headeri — sve podržano
  • Relativne putanje u linkovima → pretvaraju se u /docs/ linkove

Fajlovi koji se prikazuju

Svi .md fajlovi u projektu:

  • CLAUDE.md (glavni)
  • agents/*/CLAUDE.md
  • TASKS/*.md
  • TASKS/reports/*.md
  • README.md

Bezbednost

  • Samo .md fajlovi (ne dozvoli čitanje .go, .env itd.)
  • Samo unutar project root-a (ne dozvoli ../../../etc/passwd)
  • Path traversal zaštita

Testovi

  • GET /docs → lista fajlova
  • GET /docs/CLAUDE.md → renderovan HTML
  • GET /docs/agents/coder/CLAUDE.md → renderovan HTML
  • GET /docs/../../etc/passwd → 403
  • GET /docs/main.go → 403 (nije .md)
  • Klikabilni linkovi u renderovanom HTML-u

Pitanja


Odgovori