websitedev/TODO.md

mozdIT Weboldal - Fejlesztési TODO Lista

Projekt Áttekintés

Next.js 14 alapú weboldal a mozdIT Bt. számára, Dokploy-on hostolva.

⚠️ Projekt Management

Elsődleges forrás: Linear (ZEE-28, ZEE-29, ZEE-30, stb.) Lokális másolat: Ez a fájl csak referencia, a Linear az authoritative source

✅ Befejezett (Linear szerint)

Linear Ticket	Feladat	Státusz
ZEE-28	Repo & Next.js bootstrap - befejezett, dev szerver fut localhost:3000-n	✅
ZEE-29	Tailwind + alap layout	✅
ZEE-30	Kezdőlap (Hero + USP + Webmail CTA)	✅
-	Unit teszt infrastruktúra beállítása (Jest + React Testing Library)	✅
-	API endpoint tesztek írása (/api/health)	✅
-	Component tesztek írása (Header, Footer)	✅
-	Teszt hibák javítása (Jest setup, duplicate elements, type casting)	✅
ZEE-34	Basic API endpoints (/api/health) hozzáadása	✅

🔄 Folyamatban (Linear szerint)

Linear Ticket	Feladat	Státusz
ZEE-35	Dokploy staging environment beállítása	🔄
TBC-1	Site config migrálás MongoDB-ba	🔄
TBC-2	Winston logger + Loki integráció	🔄
TBC-3	Logging middleware megvalósítása	🔄
TBC-4	Grafana dashboard konfiguráció	🔄

📋 Tervezett

Linear Ticket	Feladat	Státusz
ZEE-33	Kapcsolat űrlap + API stub	📋
ZEE-32	Szolgáltatások oldal	📋
ZEE-31	Rólunk oldal	📋
TBC-5	SEO optimalizálás	📋
TBC-6	Performance optimalizálás	📋
TBC-7	Reszponzív design finomítása	📋
TBC-8	Analytics integráció	📋

Technikai Stack

• Frontend: Next.js 14, TypeScript, Tailwind CSS
• Backend: Next.js API Routes
• Database: MongoDB
• Logging: Winston + Loki
• Monitoring: Grafana
• Deployment: Dokploy
• Testing: Jest, React Testing Library
• Project Management: Linear (elsődleges)

Fejlesztési Parancsok

# Fejlesztői szerver indítása
cd proto && npm run dev

# Tesztek futtatása
cd proto && npm test

# Build készítése
cd proto && npm run build

Fontos Megjegyzés

A Linear az authoritative project management rendszer. Ez a fájl csak lokális referencia, mindig ellenőrizd a Linear-t az aktuális státuszért és priorításokért.

Frissítési Napló

• 2025-09-05: TODO.md fájl létrehozása, Linear integráció megjegyzésekkel

Szinkronizálás Utmutató

A TODO.md és Linear között párhuzamos vezetéshez használd a linear-sync.js scriptet:

# API kulcs hozzáadása a .env fájlhoz (Linear settings -> API)
# Szerkesd a .env fájlt és add hozzá:
# LINEAR_API_KEY=lin_api_your_actual_key_here

# Szinkronizálás futtatása
node linear-sync.js

# vagy
./linear-sync.js

A script:

• Megkeresi a TODO.md-ben hiányzó Linear ticket-eket
• Létrehozza ezeket a Linear-ben
• Frissíti a Linear ticket státuszokat a TODO alapján
• Visszairja a Linear ticket számokat a TODO.md-be

Hiányzó ticketek a jelenlegi TODO.md-ben:

• TBC-1: Site config migrálás MongoDB-ba
• TBC-2: Winston logger + Loki integráció
• TBC-3: Logging middleware megvalósítása
• TBC-4: Grafana dashboard konfiguráció
• TBC-5: SEO optimalizálás
• TBC-6: Performance optimalizálás
• TBC-7: Reszponzív design finomítása
• TBC-8: Analytics integráció

Script futtatás után ezek Linear ticket számmal lesznek helyettesítve.