si/websitedev
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

chore: migrate from Linear to Plane MCP, add .agent/ framework

Browse Source 
- Add .agent/ directory with AGENTS.md, steering docs, workflows, references
- Replace CLAUDE.md with slim reference pointing to .agent/
- Migrate TODO.md from Linear ZEE-* to Plane MITHOME-* identifiers (26 issues synced)
- Add .mcp.json.example with Plane MCP server config
- Remove .agents/, .cursor/, .roo/ legacy directories
- Update .gitignore: add .mcp.json, remove old IDE dirs
- Replace linear-sync.js approach with Plane MCP server (@makeplane/plane-mcp-server)
This commit is contained in:
Do Siki
2026-04-26 21:25:39 +02:00
parent e413bab812
commit 30f0b94a2f
18 changed files with 1237 additions and 1257 deletions
Download Patch File Download Diff File Expand all files Collapse all files
TODO.md
+59 -132
View File
@@ -1,130 +1,90 @@
# mozdIT Weboldal - Fejlesztési TODO Lista
## Projekt Áttekintés
Next.js 14 alapú weboldal a mozdIT Bt. számára, Dokploy-on hostolva.
Next.js 15 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
**Elsődleges forrás**: Plane — `MITHOME` projekt (`pm.llmdev.mozdit.hu`, workspace: `developments`)
**Lokális másolat**: Ez a fájl csak referencia, a Plane 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-155 | - |
## ✅ Befejezett
## 📋 Tervezett (Backlog)
| Linear Ticket | Feladat | Státusz |
|---------------|---------|---------|
| Plane | Feladat | Státusz |
|-------|---------|---------|
| MITHOME-1 | Repo & Next.js bootstrap — dev szerver | ✅ |
| MITHOME-2 | Kezdőlap (Hero + USP + Webmail CTA) | ✅ |
| MITHOME-3 | Rólunk oldal | ✅ |
| MITHOME-4 | Szolgáltatások oldal | ✅ |
| MITHOME-5 | Kapcsolat űrlap + API route | ✅ |
| MITHOME-6 | /api/health endpoint | ✅ |
| MITHOME-7 | Dockerfile + Docker Compose fejlesztői környezet | ✅ |
| MITHOME-8 | Tailwind + design system, dark mode, animációk | ✅ |
| MITHOME-9 | JSON alapú content management rendszer | ✅ |
| MITHOME-10 | Unit teszt infrastruktúra (Jest + React Testing Library) | ✅ |
| MITHOME-11 | Contact API — rate limiting, spam detection, validáció | ✅ |
| MITHOME-12 | Docker stack — Next.js + MongoDB + Loki + Grafana | ✅ |
| 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ó | 📋 |
| ZEE-154 | Adatvédelmi tájékoztató oldal (/adatvedelem) - GDPR compliance | 📋 |
| - | ZEE-156 | 📋 |
| - | ZEE-157 | 📋 |
---
## 📋 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 | 📋 |
## 🔄 Folyamatban
## 🥒 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ó |
| Plane | Feladat | Státusz |
|-------|---------|---------|
| — | — | — |
### 🎯 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ó | 📋 |
## 📋 Backlog
| Plane | Feladat | Státusz |
|-------|---------|---------|
| MITHOME-13 | CI pipeline — lint + unit tesztek + staging deploy trigger | 📋 |
| MITHOME-14 | Playwright E2E smoke tesztek + Lighthouse CI | 📋 |
| MITHOME-15 | Prod app + domain konfiguráció + HTTPS | 📋 |
| MITHOME-16 | Site config migrálás MongoDB-ba | 📋 |
| MITHOME-17 | Winston logger + Loki integráció | 📋 |
| MITHOME-18 | Adatvédelmi tájékoztató oldal (/adatvedelem) — GDPR | 📋 |
| MITHOME-19 | Accessibility (A11y) — WCAG 2.1 AA megfelelőség | 📋 |
| MITHOME-20 | Lighthouse score ≥ 90 minden kategóriában | 📋 |
| MITHOME-21 | Logging middleware megvalósítása | 📋 |
| MITHOME-22 | Grafana dashboard konfiguráció | 📋 |
| MITHOME-23 | SEO optimalizálás | 📋 |
| MITHOME-24 | Performance optimalizálás | 📋 |
| MITHOME-25 | Reszponzív design finomítása | 📋 |
| MITHOME-26 | Analytics integráció (Plausible / GA4) | 📋 |
---
## Technikai Stack
- **Frontend**: Next.js 14, TypeScript, Tailwind CSS
- **Frontend**: Next.js 15, TypeScript, Tailwind CSS 4
- **Backend**: Next.js API Routes
- **Database**: MongoDB
- **Database**: MongoDB (Mongoose ODM)
- **Logging**: Winston + Loki
- **Monitoring**: Grafana
- **Deployment**: Dokploy
- **Testing**: Jest, React Testing Library
- **Project Management**: Linear (elsődleges)
- **Project Management**: Plane MITHOME (elsődleges)
---
## Fejlesztési Parancsok
### Hagyományos fejlesztés
```bash
# Fejlesztői szerver indítása
# Fejlesztői szerver
cd proto && npm run dev
# Tesztek futtatása
# Tesztek
cd proto && npm test
cd proto && npm run test:all
# Build készítése
# Build
cd proto && npm run build
```
### Docker fejlesztői környezet
```bash
# Docker stack indítása (teljes környezet)
# Docker stack
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)
@@ -132,43 +92,10 @@ docker-compose -f docker-compose.dev.yml down -v
- **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
- **2026-04-26**: Átállás Linear → Plane (MITHOME projekt). TODO.md teljes újraírva, 26 issue szinkronizálva.
- **2025-01-23**: ZEE-29 (Tailwind + layout) és JSON content management befejezése (Linear)
- **2025-09-05**: Docker fejlesztői környezet implementálva