▲ PromNET

2026. május 2. · #projekt-jegyzek #markdown #workflow #ux

Projekt-jegyzék — privát napló minden Cloud-projekthez

A PromNET minden Cloud-projektjéhez bevezettünk egy privát Markdown-jegyzéket. Mire jó: deploy-naplók, fejlesztői jegyzetek, AI-context-átadás. Vibe-coded UX, csak neked látható.

Projekt-jegyzék — privát napló minden Cloud-projekthez

A modern fejlesztői workflow-ban minden projekten van egy NOTES.md vagy egy JOURNAL.md vagy egy TODO.md — valamilyen privát jegyzet a fejhez, amit a git nem mindig követ, vagy igen, de zavaró. Egy hosting-platformon ezt nehéz a UI-ba beilleszteni — a legtöbb hoszting-szolgáltató nem törődik vele, mert a kódra fókuszál, nem a fejlesztő-folyamatra.

A PromNET-en bevezettünk egy Projekt-jegyzéket — minden Cloud- projekthez egy privát Markdown-szöveg, csak a tulajdonosa látja, a sidebar-ban gyorsan elérhető.

Mi ez konkrétan

A /app/cloud/{slug}/jegyzet oldal egyetlen Markdown-szövegmező. Saját formázás, saját tartalom. Mentés gombra → D1-ben rögzítjük. A jegyzék csak a projekt-tulajdonosé — admin sem nézheti meg (adminisztratív jogcímek nélkül).

Példa-tartalom:

# Cégem.hu projekt-jegyzék

## Deploy-napló
- 2026-04-15: első deploy, astro template
- 2026-04-22: kontakt-form + Form Handler
- 2026-05-01: kép-galéria hozzáadva

## TODO
- [ ] OG-image dinamikus generálás
- [ ] Google Analytics G-tag bekötése
- [x] Favicon csere

## AI-context — Claude prompt-hoz
A projekt: magyar fogászati rendelő honlapja.
Stack: Astro 5 + Tailwind. Form Handler-en a kontakt-űrlap.
Stílus: minimal, kék-fehér, professzionális.

A jegyzék-tartalom NEM kerül az élő-deploy-ba. Privát.

Mire jó

1. Deploy-naplók

A klasszikus “git log” rövid commit-message-eket tartalmaz. A WHY-t ritkán mondja el — egy “fix bug” üzenet 3 hónap múlva rejtély. A jegyzékben több kontextust írhatsz: “Mert az ügyfél kérte hogy a kék kontaktgomb piros legyen”.

2. Fejlesztői napló

Aki WIP-projekten dolgozik weeks-end alatt, gyakran elfelejti hol tartott. A jegyzék emlékeztető-pad — “holnap a header-rel folytatom”.

3. AI-context-átadás

A 2026-os fejlesztő ChatGPT-t / Claude-ot használja kódoláshoz. A jegyzékben eltárolhatod a projekt-kontextust (mi a stack, mi a stílus, mi a célközönség), és másold be a chat-be ha új sessiont indítasz. NEM kell elmondani 5-ször.

4. Mappa nélküli emlékeztető

A cloud_projects UI-ban nincs külön mappa-rendszer a fejlesztői jegyzeteknek. A jegyzék az egy-helyen-mindent megoldás.

5. Magán-statisztika

Magán-mutatók (“ezen a projekten 3-szor tévesztettem domain-bekötést”) nyomon-követhető privátan. NEM kell a fejlesztői pszichológiát publikus repo-ba tenni.

A megoldás-tér: miért nem GitHub-Wiki?

Felmerülhet: “miért nem GitHub-wiki vagy Notion-page?”. A válasz:

A PromNET-jegyzék a projekt-dashboard alatt van, kéznél, csak neked, D1-tárolva, automatikusan mentett.

Mire NEM jó

A Projekt-jegyzék NEM:

Ha dokumentum-rendszer kell több aldokumentummal, treestruktúrával, verziókezeléssel — Notion vagy Obsidian való. A PromNET-jegyzék egyetlen célra van: gyors privát emlékeztető a projekt mellé.

A vibe-coded UX

A jegyzék-szerkesztő szándékosan minimal:

NINCS rich-text-toolbar (B / I / H1 / H2 stb. gombok). NINCS WYSIWYG. Csak Markdown, mert a célközönsége az, aki tudja hogy mi a Markdown.

A sidebar-integráció

A /app/* AppShell-sidebar-ban a “Projektek” szekció alatt mindig megjelenik egy “Projekt-jegyzék” link. Ha van aktív projektben (a URL-en /cloud/{slug}/), a jegyzék-link közvetlenül oda mutat. Ha nincs aktív projekted, a projekt-listára visz.

Ez kéznél tartja a jegyzéket — nem kell 3 menü-szint alá elásva keresni.

A roadmap

A következő hónapokban:

Pozícionálás

A Projekt-jegyzék NEM Notion-killer. NEM Obsidian-alternatíva. Egyetlen célra van: mikor a Cloud-projektedet kezeled, kéznél legyen egy privát szöveges-pad.

Aki ezt használja: örül. Aki nem: NEM lát semmit a sidebar-ban (csak egy nem-kötelező link). Nem zavar senkit.

A funkció most is élő — bármely Cloud-projekted alatt a jegyzék-link elérhető a /app/cloud/{slug}/jegyzet URL-en.

© 2026 PromNET — Polyák Csaba. ← Vissza a blog-ra

Hozzászólások

Betöltés…