# 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ó | 📋 |
| - | Adatvédelmi tájékoztató oldal (/adatvedelem) - GDPR compliance | 📋 |

## 📋 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
```bash
# 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
```bash
# 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:

```bash
# 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