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:3001-n	✅
ZEE-30	Kezdőlap (Hero + USP + Webmail CTA)	✅
ZEE-31	Rólunk oldal	✅
ZEE-32	Szolgáltatások oldal	✅
ZEE-33	Kapcsolat űrlap + API stub	✅
ZEE-34	/api/health endpoint	✅
ZEE-35	Dockerfile + Docker Compose fejlesztői környezet	✅
ZEE-29	Tailwind + alap layout (design system, dark mode, animációk)	✅
-	JSON alapú content management rendszer (struktúrált szövegkezelés)	✅
-	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)	✅
-	Mobil navigáció JavaScript funkcionalitás	✅
-	Contact API endpoint (/api/contact) - rate limiting, spam detection, validáció	✅
-	Docker fejlesztői környezet (Next.js + MongoDB + Mongo Express + Loki + Grafana)	✅
-	MongoDB inicializálás és site_config beállítás	✅

🔄 Folyamatban (Linear szerint)

Linear Ticket	Feladat	Státusz
-	ZEE-152	-

📋 Tervezett (Backlog)

Linear Ticket	Feladat	Státusz

| ZEE-36 | CI (lint, unit) + Staging deploy trigger | 📋 | | ZEE-37 | Playwright smoke E2E + Lighthouse CI | 📋 | | ZEE-38 | Prod app + domain + HTTPS | 📋 | | ZEE-39 | Site config migrálás MongoDB-ba | 📋 | | ZEE-40 | Winston logger + Loki integráció | 📋 |

📋 Követelmény Nyilvántartás (REQ Prefix)

Linear Ticket	Követelmény	Kategória	Státusz
ZEE-50	REQ-001: Kezdőlap Funkcionalitás	Funkcionális	✅
ZEE-51	REQ-004: Kapcsolat Űrlap	Funkcionális	✅
ZEE-52	REQ-101: Responsive Design	Nem-funkcionális	✅
ZEE-53	REQ-102: Accessibility (A11y)	Nem-funkcionális	🔄
ZEE-54	REQ-401: Lighthouse Score ≥ 90	Teljesítmény	🔄
ZEE-41	Logging middleware megvalósítása	📋
ZEE-42	Grafana dashboard konfiguráció	📋
ZEE-43	SEO optimalizálás	📋
ZEE-44	Performance optimalizálás	📋
ZEE-45	Reszponzív design finomítása	📋

🥒 Test Reporting Rendszer (Gherkin Format)

Funkció	Státusz	Leírás
Gherkin generálás	✅	Automatikus TC-XXX prefix felismerés
Funkcionális területek elemzése	✅	8 kategória szerinti csoportosítás
Coverage dashboard	✅	Területenkénti lemaradás elemzés
TC issue frissítés	✅	Linear issues Gherkin formátummal
Automatizált reporting	✅	GitHub Actions integráció

🎯 Funkcionális Területek

• 🏠 Weboldal Funkcionalitás: Kezdőlap, navigáció, oldalak
• 📝 Kapcsolat Űrlap: Validáció, spam védelem, rate limiting
• 🎨 Design és UX: Responsive, accessibility, performance
• 🔒 Biztonság: Input validáció, rate limiting, HTTPS
• ⚡ Teljesítmény: Lighthouse, optimalizálás, caching
• 🛠️ Technikai Stack: Next.js, MongoDB, Docker, CI/CD

📊 Jelenlegi Test Coverage

• Összes teszt: 56
• TC-XXX prefix: 1 (TC-001)
• Funkcionális területek: 1 (Kapcsolat Űrlap)
• Sikeres tesztek: 100%
• Lemaradás: Nincs | ZEE-46 | 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

Hagyományos fejlesztés

# 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

Docker fejlesztői környezet

# Docker stack indítása (teljes környezet)
docker-compose -f docker-compose.dev.yml up -d

# Docker stack leállítása
docker-compose -f docker-compose.dev.yml down

# Logok követése
docker-compose -f docker-compose.dev.yml logs -f

# Alkalmazás újraépítése
docker-compose -f docker-compose.dev.yml up --build -d

# Teljes tisztítás (adatok törlése)
docker-compose -f docker-compose.dev.yml down -v

Elérhető szolgáltatások (Docker)

• Weboldal: http://localhost:3000
• MongoDB UI: http://localhost:8081 (admin/password123)
• Grafana: http://localhost:3001 (admin/admin123)
• Loki: http://localhost:3100
• MongoDB: mongodb://admin:password123@localhost:27017/admin

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
• 2025-09-05: Szinkronizáció Linear Website Development projekttel - aktuális státuszok frissítve
• 2025-09-05: Nagyobb implementációs mérföldkő - ZEE-31, ZEE-32, ZEE-33 befejezve, mobil navigáció és contact API implementálva
• 2025-09-05: Docker fejlesztői környezet implementálva - ZEE-34, ZEE-35 befejezve, teljes stack (Next.js + MongoDB + Monitoring) működik

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

✅ Szinkronizáció állapota:

Minden feladat megtalálható a Linear-ben megfelelő ticket számmal. A TODO.md mostantól teljesen szinkronban van a Linear Website Development projekttel.

Befejezett ticketek: ZEE-28, ZEE-30, ZEE-31, ZEE-32, ZEE-33, ZEE-34, ZEE-35 Backlog ticketek: ZEE-29, ZEE-36-46
Duplikált ticketek eltávolítva: ZEE-27 (duplikáció a ZEE-28-hoz képest)

Utolsó szinkronizáció: 2025-01-23 - ZEE-29 (Tailwind + layout) és JSON content management befejezése