Do Siki
b0df8dd182
- Updated README.md with project details, quick start instructions, and tech stack. - Expanded TODO.md to reflect current project status and backlog items, including Linear ticket synchronization. - Added mobile menu toggle functionality in Header component with corresponding tests for user interactions. - Configured Next.js for Docker deployment and optimized build settings.
169 lines
6.8 KiB
Markdown
169 lines
6.8 KiB
Markdown
# 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 | ✅ |
|
|
| - | 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 |
|
|
|---------------|---------|---------|
|
|
| - | Jelenleg nincs aktív folyamatban lévő feladat | - |
|
|
|
|
## 📋 Tervezett (Backlog)
|
|
| Linear Ticket | Feladat | Státusz |
|
|
|---------------|---------|---------|
|
|
| ZEE-29 | Tailwind + alap layout | 📋 |
|
|
| 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
|
|
```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-09-05 - Docker fejlesztői környezet implementáció befejezése után |