docs: refresh all documentation to the current state
CI Pipeline with Test Management / 🧪 Run Tests & Generate Reports (push) Waiting to run
CI Pipeline with Test Management / 🐳 Docker Integration Tests (push) Blocked by required conditions
CI Pipeline with Test Management / 🏗️ Build Docker Image (push) Blocked by required conditions
CI Pipeline with Test Management / 📊 Generate Test Summary (push) Blocked by required conditions
Test Reporting & Gherkin Analysis / 🧪 Run Tests & Generate Reports (push) Waiting to run
Test Reporting & Gherkin Analysis / 📊 Analyze Test Coverage (push) Blocked by required conditions
Test Reporting & Gherkin Analysis / 🔄 Sync with Linear (push) Blocked by required conditions
Test Reporting & Gherkin Analysis / ⚡ Performance Monitoring (push) Blocked by required conditions

- agent docs: Linear (ZEE-*) → Plane (MITHOME-*) everywhere (task tracking,
  commit examples, workflows, env vars)
- testing steering: replace the obsolete Gherkin/Linear reporting with the
  pre-deploy suite and the CMS test scripts
- README: rewrite to Next.js 15, local deploy, Plane, CMS, security monitoring
- DOCKER/proto docs: correct dev-stack ports (app 8080, mongo 27018) and
  Next.js 15
- content-editor-recovery: mark the old 'next steps' as done
- mark clearly-obsolete Linear/GitHub-era guides as deprecated (banner) —
  LINEAR-SYNC, GITHUB-CICD/INTEGRATION, TEST-MANAGEMENT/REPORTING, traceability,
  sync-status analysis, requirements docs
This commit is contained in:
Do Siki
2026-08-22 19:41:50 +02:00
parent 8ee5befe10
commit 410b4a2e2f
24 changed files with 134 additions and 138 deletions
+1 -1
View File
@@ -124,7 +124,7 @@ chore/[feladat] → Build, deps, tooling
[opcionális részletes leírás] [opcionális részletes leírás]
[opcionális: Closes ZEE-123] [opcionális: Closes MITHOME-XX]
``` ```
**Típusok**: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`, `perf` **Típusok**: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`, `perf`
+7 -7
View File
@@ -29,16 +29,16 @@ A projekt a következő konvenciókat követi:
## Task Tracking (Kötelező) ## Task Tracking (Kötelező)
- Minden feladat a **gyökér `TODO.md`-ben** kerül nyilvántartásra, Linear ticketekre hivatkozva (ZEE-* sorozat). - Minden feladat a **gyökér `TODO.md`-ben** kerül nyilvántartásra, Plane ticketekre hivatkozva (MITHOME-* sorozat).
- A `linear-sync.js` scripttel tartjuk szinkronban a Linear-t és a TODO.md-t. - A `plane-sync.js` scripttel tartjuk szinkronban a Plane-t és a TODO.md-t.
- Soha ne hozz létre párhuzamos feladatlistát vagy külön tasks/ mappát — ez a projekt `TODO.md` + Linear kombinációt használ. - Soha ne hozz létre párhuzamos feladatlistát vagy külön tasks/ mappát — ez a projekt `TODO.md` + Plane kombinációt használ.
- **Feladat státuszok TODO.md-ben**: `📋 Tervezett``🔄 Folyamatban``✅ Kész` - **Feladat státuszok TODO.md-ben**: `📋 Tervezett``🔄 Folyamatban``✅ Kész`
## Szinkronizáció utáni kötelező lépések ## Szinkronizáció utáni kötelező lépések
> **KÖTELEZŐ**: Minden feladat befejezése vagy státuszváltás után: > **KÖTELEZŐ**: Minden feladat befejezése vagy státuszváltás után:
1. Frissítsd a **Linear ticket** státuszát 1. Frissítsd a **Plane ticket** státuszát
2. Frissítsd a **`TODO.md`**-t 2. Frissítsd a **`TODO.md`**-t
3. `git add . && git commit -m "sync: ..."` + push 3. `git add . && git commit -m "sync: ..."` + push
@@ -52,9 +52,9 @@ Nagyobb funkciókhoz a `docs/` mappában dolgozd ki:
### Task formátumok (TODO.md-ben) ### Task formátumok (TODO.md-ben)
```markdown ```markdown
| ZEE-XXX | Feladat neve | 📋 Tervezett | | MITHOME-XXX | Feladat neve | 📋 Tervezett |
| ZEE-XXX | Feladat neve | 🔄 Folyamatban | | MITHOME-XXX | Feladat neve | 🔄 Folyamatban |
| ZEE-XXX | Feladat neve | ✅ Kész | | MITHOME-XXX | Feladat neve | ✅ Kész |
``` ```
- Minden tasknak legyen elfogadási kritériuma mielőtt belekezdünk. - Minden tasknak legyen elfogadási kritériuma mielőtt belekezdünk.
+26 -8
View File
@@ -38,14 +38,14 @@ Ez a fájl automatikusan betöltődik tesztfájlok érintésekor, és segít a t
## Futtatás (`proto/` mappából) ## Futtatás (`proto/` mappából)
```bash ```bash
npm test # unit tesztek (alapértelmezett) npm test # unit tesztek (alapértelmezett, jest.config.unit.js)
npm run test:watch # watch mode npm run test:watch # watch mode
npm run test:coverage # lefedettség riport npm run test:coverage # lefedettség riport
npm run test:browser # browser integration npm run test:browser # browser integration
npm run test:integration # Docker integration (Docker kell!) npm run test:integration # Docker integration (Docker kell!)
npm run test:e2e # E2E tesztek (Docker kell!) npm run test:e2e # E2E tesztek (Docker kell!)
npm run test:all # teljes suite npm run test:all # teljes proto suite
npm run test:report # tesztek + Linear szinkron riport npm run test:smoke:staging # Playwright smoke a staging ellen
``` ```
## Bugfix tesztelési sorrend (kötelező) ## Bugfix tesztelési sorrend (kötelező)
@@ -69,12 +69,30 @@ npm run test:report # tesztek + Linear szinkron riport
``` ```
- Lighthouse accessibility score: **≥90** — minden deploy előtt ellenőrizd. - Lighthouse accessibility score: **≥90** — minden deploy előtt ellenőrizd.
## Gherkin és Linear riporting ## Teljes tesztkészlet (deploy előtt)
A projekt automatikus teszt-riportot tud generálni Gherkin formátumban és Linear-ba szinkronizálni: Minden deploy előtt az **egyetlen belépési pont** futtatandó:
```bash ```bash
npm run test:gherkin # Gherkin riport generálás scripts/pre-deploy-tests.sh
npm run test:update-tc # Linear TC issue-k frissítése ```
npm run test:full-report # mindkettő egyszerre
Ez lefedi: proto unit + `tsc --noEmit` + `eslint`, content séma-validáció, a CMS
integrációs tesztjei (`scripts/test-content-editor-*.js`), a publish-teszt és a
Plane-sync unit tesztek. Bármelyik hibája megszakítja a kiadást.
A CMS (content-editor.js) tesztjei külön is futtathatók (valódi szervert indítanak):
```bash
node scripts/test-content-editor-security.js # auth, CSRF, XFF
node scripts/test-content-editor-serializer.js # collect/reindex regresszió
node scripts/test-content-editor-save.js # atomikus mentés + validáció
node scripts/test-content-editor-conflict.js # optimista zárolás (409)
node scripts/test-content-editor-versions.js # verziók panel (diff, restore)
node scripts/test-content-editor-logo.js # logó feltöltés
node scripts/test-content-editor-login.js # login flow (session, Safari)
node scripts/test-content-editor-logout.js # logout + rate-limit
node scripts/test-content-editor-guide.js # /guide + markdown renderer
node scripts/test-content-editor-bottombar.js # alsó sáv layout guard
node scripts/test-cms-publish.js # publish parancs + integráció
``` ```
+1 -1
View File
@@ -60,4 +60,4 @@ git push origin fix/[hiba-leírás]
### 9. Dokumentálás (ha általánosabb tanulság) ### 9. Dokumentálás (ha általánosabb tanulság)
- Ha érdekes/nem nyilvánvaló bug volt: adj `// WHY:` kommentet a javításhoz - Ha érdekes/nem nyilvánvaló bug volt: adj `// WHY:` kommentet a javításhoz
- Frissítsd a `TODO.md`-t és a Linear ticketet - Frissítsd a `TODO.md`-t és a Plane ticketet
+3 -3
View File
@@ -95,6 +95,6 @@ git commit -m "feat(<scope>): <rövid leírás>"
git push origin feature/[feature-neve] git push origin feature/[feature-neve]
``` ```
### 10. Linear szinkron ### 10. Plane szinkron
- Frissítsd a Linear ticket státuszát - Frissítsd a Plane ticket státuszát
- `node linear-sync.js` ha szükséges - `node plane-sync.js --yes` ha szükséges
+1 -1
View File
@@ -53,7 +53,7 @@ description: Kód review checklist — PR előtt és review során
### Dokumentáció ### Dokumentáció
- [ ] `TODO.md` frissítve? - [ ] `TODO.md` frissítve?
- [ ] Linear ticket státusza frissítve? - [ ] Plane ticket státusza frissítve?
- [ ] API változás esetén `REQUIREMENTS-CATALOG.md` frissítve? - [ ] API változás esetén `REQUIREMENTS-CATALOG.md` frissítve?
--- ---
+1 -1
View File
@@ -75,7 +75,7 @@ Szükséges változók (`.env` és `proto/.env.local`):
- `NEXT_PUBLIC_SITE_URL` — Publikus site URL - `NEXT_PUBLIC_SITE_URL` — Publikus site URL
- `NEXT_PUBLIC_WEBMAIL_URL` — Webmail service URL - `NEXT_PUBLIC_WEBMAIL_URL` — Webmail service URL
- `NEXT_PUBLIC_CONTACT_EMAIL` — Kapcsolati email cím - `NEXT_PUBLIC_CONTACT_EMAIL` — Kapcsolati email cím
- `LINEAR_API_KEY`Linear szinkronizációhoz - `PLANE_API_KEY`Plane szinkronizációhoz (a `.mcp.json`-ban is lehet)
--- ---
+2 -2
View File
@@ -21,8 +21,8 @@ A Docker stack a következő szolgáltatásokat indítja:
| Szolgáltatás | Port | URL | Leírás | | Szolgáltatás | Port | URL | Leírás |
|--------------|------|-----|--------| |--------------|------|-----|--------|
| **Next.js App** | 3000 | http://localhost:3000 | Fő alkalmazás | | **Next.js App** | 8080 | http://localhost:8080 | Fő alkalmazás |
| **MongoDB** | 27017 | mongodb://localhost:27017 | Adatbázis | | **MongoDB** | 27018 | mongodb://localhost:27018 | Adatbázis |
| **Mongo Express** | 8081 | http://localhost:8081 | MongoDB Web UI | | **Mongo Express** | 8081 | http://localhost:8081 | MongoDB Web UI |
| **Loki** | 3100 | http://localhost:3100 | Log aggregátor | | **Loki** | 3100 | http://localhost:3100 | Log aggregátor |
| **Grafana** | 3001 | http://localhost:3001 | Monitoring dashboard | | **Grafana** | 3001 | http://localhost:3001 | Monitoring dashboard |
Executable → Regular
+2
View File
@@ -1,3 +1,5 @@
> **ELAVULT (deprecated)** — a CI/CD Gitea + lokális deployra váltott — lásd .agent/workflows/deploy.md.
# CI/CD Guide - Code & Deployment # CI/CD Guide - Code & Deployment
## 🎯 **Cél** ## 🎯 **Cél**
Executable → Regular
+2
View File
@@ -1,3 +1,5 @@
> **ELAVULT (deprecated)** — a GitHub-integráció megszűnt (Gitea-ra váltás).
# GitHub Actions + Linear Test Management Integration # GitHub Actions + Linear Test Management Integration
## ✅ **Megerősítés: Teljes GitHub Sync Implementálva!** ## ✅ **Megerősítés: Teljes GitHub Sync Implementálva!**
Executable → Regular
+2
View File
@@ -1,3 +1,5 @@
> **ELAVULT (deprecated)** — a projekt a Plane-re váltott — lásd PLANE-SYNC-GUIDE.md.
# Linear Sync Guide - Test Management # Linear Sync Guide - Test Management
## 🎯 **Cél: Linear-specifikus Test Management** ## 🎯 **Cél: Linear-specifikus Test Management**
+57 -106
View File
@@ -1,131 +1,82 @@
# mozdIT Bt. Website Development # mozdIT Bt. Weboldal fejlesztés (websitedev)
[![CI/CD Pipeline](https://github.com/your-username/websitedev/actions/workflows/ci.yml/badge.svg)](https://github.com/your-username/websitedev/actions/workflows/ci.yml) Modern Next.js weboldal a mozdIT Bt. számára — webtárhely, email- és DNS-szolgáltatás, magyar IT vállalkozás.
[![Docker](https://img.shields.io/badge/Docker-Ready-blue)](./docker-compose.dev.yml)
[![Plane Sync](https://img.shields.io/badge/Plane-Synced-success)](https://pm.llmdev.mozdit.hu)
[![Deployment](https://img.shields.io/badge/Deployment-Active-success)](https://mozdit.hu)
Modern Next.js 14 website for mozdIT Bt. - Hungarian IT services company specializing in web hosting, email services, and DNS administration. ## Stack
## 🚀 Quick Start - **Frontend**: Next.js 15 (Turbopack), React 19, TypeScript, Tailwind CSS 4
- **Tartalom**: JSON-alapú, séma-validált content rendszer (`proto/src/content/`)
- **CMS**: saját, dependency-mentes `content-editor.js` (böngészős szerkesztő)
- **Backend**: Next.js API routes, MongoDB
- **Tesztelés**: Jest, React Testing Library, Playwright (smoke), valódi szervert indító CMS-tesztek
- **Deploy**: natív Docker Compose (`deploy.sh`) + Gitea Actions nélkül, lokálisan vezérelt
- **Monitoring**: Winston + Loki, plusz `scripts/security-scan.sh` (ntfy riasztással)
## Gyors indítás
```bash ```bash
# Development server # Fejlesztői szerver
cd proto && npm run dev cd proto && npm run dev
# Docker development environment # Docker fejlesztői környezet
docker-compose -f docker-compose.dev.yml up -d docker-compose -f docker-compose.dev.yml up -d
# Run tests # Teljes pre-deploy tesztkészlet
cd proto && npm run test:all scripts/pre-deploy-tests.sh
``` ```
## 🔄 Dual Sync Architecture ## Feladatkezelés (Plane)
This project uses **separated sync systems** for optimal management: - **Projekt**: [MITHOME](https://pm.llmdev.mozdit.hu) (workspace: `developments`)
- **TODO.md**: helyi tükör, a Plane az elsődleges forrás
- **Szinkron**: `node plane-sync.js` (Plane → TODO.md)
- **Ticket-azonosítók**: `MITHOME-XX`
### 📊 **Plane Sync (Task Management)** ## Deploy
- **Project**: [MITHOME — mozdIT website dev](https://pm.llmdev.mozdit.hu) (workspace: `developments`)
- **TODO.md**: Local mirror, Plane is the authoritative source
- **Sync**: `node plane-sync.js` (one-way Plane → TODO.md)
- **Status Mapping**: `completed` → ✅, `started` → 🔄, `unstarted` → ⏳, `backlog` → 📋
### 🐙 **GitHub Sync (CI/CD)** ```bash
- **Code Versioning**: Git-based source control ./scripts/deploy_to_stage_on_local.sh # staging: teljes tesztkészlet + push + deploy + smoke
- **CI/CD Pipeline**: Automated testing and deployment ./deploy.sh production # éles (szerveren, staging ellenőrzése után)
- **Docker Integration**: Container build and registry ```
- **Deployment**: Docker Compose (deploy.sh)
### 🧪 Test Types A CMS „Publikálás" gombja szintén commitol + pushol + deployol (csak a beállított környezetre). Részletek: `.agent/workflows/deploy.md`, `docs/helyi-staging-deploy.md`.
- **Unit Tests**: Component and logic testing
- **Browser Integration**: jsdom + mocked APIs
- **Docker Integration**: Real HTTP calls to services
- **E2E Tests**: Complete user workflows
## 🛠️ Tech Stack ## Tartalomkezelés
- **Frontend**: Next.js 14, TypeScript, Tailwind CSS 4 A weboldal szövegei és a CMS a `proto/src/content/` JSON-fájljaiból jönnek:
- **Design System**: CSS Variables, Dark Mode, Custom Animations
- **Content Management**: JSON-based structured content
- **Backend**: Next.js API Routes, MongoDB
- **Testing**: Jest, React Testing Library, Docker
- **Deployment**: Docker Compose (deploy.sh), native
- **Monitoring**: Winston, Loki, Grafana
- **Project Management**: Plane, GitHub Issues
## 📈 Current Status
![Requirements Coverage](https://img.shields.io/badge/Requirements-100%25-success)
![Test Automation](https://img.shields.io/badge/Test_Automation-100%25-success)
![Build Status](https://img.shields.io/badge/Build-Passing-success)
### ✅ Completed Features
- [x] Responsive website with modern design
- [x] **Design System** with CSS variables, animations, and micro-interactions
- [x] **Dark Mode** with system preference detection and manual toggle
- [x] **JSON Content Management** - Structured, easily modifiable content system
- [x] Contact form with validation & spam protection
- [x] Rate limiting and security features
- [x] Docker development environment
- [x] Comprehensive test suite
- [x] CI/CD pipeline with Plane sync integration
- [x] Requirements traceability system
### 🚧 In Progress
- [ ] Performance optimization (ZEE-44)
- [ ] SEO enhancements
- [ ] Analytics integration
## 🔗 Links
- **Production**: https://mozdit.hu
- **Staging**: https://staging.mozdit.hu
- **Plane Project**: https://pm.llmdev.mozdit.hu (workspace: `developments`, project: `MITHOME`)
- **Docker Registry**: ghcr.io/your-username/websitedev
## 📚 Documentation
### **Sync Systems:**
- [Plane Sync Guide](./PLANE-SYNC-GUIDE.md) - Task management with Plane
- [GitHub CI/CD Guide](./GITHUB-CICD-GUIDE.md) - Code & deployment pipeline
- [Sync Status Analysis](./SYNC-STATUS-ANALYSIS.md) - Current state overview
### **Development:**
- [Test Management Strategy](./TEST-MANAGEMENT.md)
- [Traceability Matrix](./TRACEABILITY-MATRIX.md)
- [Docker Setup](./DOCKER.md)
- [Development Guide](./proto/README.md)
## 🎨 Design System
The project uses a comprehensive design system with:
- **CSS Variables**: Brand colors, spacing, shadows, transitions
- **Dark Mode**: Automatic system preference + manual toggle via ThemeProvider
- **Animations**: fadeIn, float, pulse, hover effects (lift, scale, glow)
- **Components**: Buttons, cards, icons with consistent styling
## 📝 Content Management
All website text content is managed through JSON files:
``` ```
proto/src/content/ proto/src/content/
├── types.ts # TypeScript definitions ├── schema.js # közös séma-validátor (Next + CMS)
├── index.ts # Content loader utility ├── types.ts # TypeScript típusok
├── common.json # Shared texts (buttons, labels) ├── index.ts # tartalom-betöltő
── pages/ ── common.json # közös szövegek (gombok, lábléc, a11y)
├── home.json # Homepage content └── pages/ # oldalankénti tartalom (home, about, services, …)
├── about.json # About page content
├── services.json # Services page content
└── contact.json # Contact page content
``` ```
**Usage:** Használat:
```typescript ```typescript
import { content, getPageContent } from '@/content' import { content, getPageContent } from '@/content'
const about = content.pages.about
// Access content
const aboutContent = content.pages.about
const servicesContent = getPageContent('services')
``` ```
## Dokumentáció
- **Agent-szabályok**: `.agent/AGENTS.md`, `.agent/steering/`, `.agent/workflows/`
- **CMS felhasználói útmutató**: `docs/felhasznaloi-utmutato.md` (a CMS-ben a ❓ Súgó is ezt rendereli)
- **Plane szinkron**: `PLANE-SYNC-GUIDE.md`
- **Staging deploy**: `docs/helyi-staging-deploy.md`
- **Gitea runner**: `docs/gitea-runner-telepites.md`
## Környezetek
- **Staging**: https://stage.mozdit.hu
- **CMS (staging)**: https://cms.stage.llmdev.mozdit.hu
- **ntfy (riasztás)**: `st_limidev_security` topic
## Biztonsági monitoring
`scripts/security-scan.sh` (cron, 5 percenként) kriptominer/backdoor indikátorokat figyel
(álcázott folyamatnevek, `/tmp/.kworkerd`-jellegű maradványok, magas CPU), és találat esetén
ntfy push-t küld a `st_limidev_security` topicra.
Executable → Regular
+2
View File
@@ -1,3 +1,5 @@
> **ELAVULT (deprecated)** — Linear-korszakbeli követelmény-katalógus (ZEE-* hivatkozások).
# mozdIT Weboldal - Követelmény Katalógus # mozdIT Weboldal - Követelmény Katalógus
## 📋 **Követelmény Kategóriák és REQ Prefixek** ## 📋 **Követelmény Kategóriák és REQ Prefixek**
Executable → Regular
+2
View File
@@ -1,3 +1,5 @@
> **ELAVULT (deprecated)** — a ZEE-* hivatkozások a megszűnt Linear-ra mutatnak.
# mozdIT Weboldal - Követelmény Nyilvántartás Áttekintés # mozdIT Weboldal - Követelmény Nyilvántartás Áttekintés
## 🎯 **REQ Prefix Rendszer** ## 🎯 **REQ Prefix Rendszer**
Executable → Regular
+2
View File
@@ -1,3 +1,5 @@
> **ELAVULT (deprecated)** — egyszeri Linear→Plane migrációs elemzés (történeti).
# Sync Status Analysis & Separation Plan # Sync Status Analysis & Separation Plan
## 📊 **Jelenlegi Állapot Elemzése** ## 📊 **Jelenlegi Állapot Elemzése**
Executable → Regular
+2
View File
@@ -1,3 +1,5 @@
> **ELAVULT (deprecated)** — Linear-korszakbeli tesztmenedzsment.
# Test Management Strategy # Test Management Strategy
## 📋 Requirements & Test Case Management with Linear ## 📋 Requirements & Test Case Management with Linear
Executable → Regular
+2
View File
@@ -1,3 +1,5 @@
> **ELAVULT (deprecated)** — Linear-korszakbeli riportrendszer.
# Test Reporting Implementation - Gherkin Format & Functional Analysis # Test Reporting Implementation - Gherkin Format & Functional Analysis
## 🎯 **Implementált Funkciók** ## 🎯 **Implementált Funkciók**
Executable → Regular
+2
View File
@@ -1,3 +1,5 @@
> **ELAVULT (deprecated)** — Linear-korszakbeli riportrendszer.
# Test Reporting System - Gherkin Format & Functional Analysis # Test Reporting System - Gherkin Format & Functional Analysis
## 🎯 **Cél: Átfogó Teszt Reporting Rendszer** ## 🎯 **Cél: Átfogó Teszt Reporting Rendszer**
Executable → Regular
+2
View File
@@ -1,3 +1,5 @@
> **ELAVULT (deprecated)** — Linear-korszakbeli (ZEE-*) nyomkövetés.
# Requirements Traceability Matrix # Requirements Traceability Matrix
## 📋 Requirements ↔ Test Cases ↔ Automated Tests ## 📋 Requirements ↔ Test Cases ↔ Automated Tests
+6 -3
View File
@@ -74,6 +74,9 @@ node scripts/test-content-editor-security.js
## Következő védelmi lépések ## Következő védelmi lépések
1. A szerveroldali mentésnek sémaellenőrzést, atomikus írást és visszaállítható mentést kell használnia (`MITHOME-41`). > **Elkészültek** (MITHOME-41/42/43, majd az azt követő issue-k): séma-validált atomikus mentés
2. A publikálási folyamatot a natív, systemd-alapú kiadási eljáráshoz kell igazítani (`MITHOME-42`). > visszaállítható backup-pal, systemd-alapú publikálás/deploy, egyedi hitelesítő adatok, CSRF,
3. A Content Editor alapértelmezett hitelesítő adatait és a hiányzó CSRF-, audit- és rate-limit védelmet meg kell szüntetni (`MITHOME-43`). > audit-log és rate-limit — valamint azóta: login oldal + session, optimista zárolás (409),
> verziók panel diff-el/restore-ral, logó-feltöltés, gyorsbillentyűk, Safari-kompatibilis auth,
> deploy-verzió (git SHA) és pre-deploy tesztkészlet. A friss állapotot lásd
> `docs/felhasznaloi-utmutato.md` és `.agent/workflows/cms-feature.md`.
+2
View File
@@ -1,3 +1,5 @@
> **ELAVULT (deprecated)** — a Linear-integrációról szóló szakasz elavult (Plane-re váltás).
# MCP Integrációs Minták Fejlesztői Környezetekhez # MCP Integrációs Minták Fejlesztői Környezetekhez
A Model Context Protocol (MCP) a mesterséges intelligencia asszisztensek és fejlesztői eszközök összekapcsolásának alapvető szabványává vált, amely kifinomult munkafolyamatokat tesz lehetővé a beszélgetési AI és a strukturált vállalati rendszerek között. **A production telepítések 20,5%-kal gyorsabb feladatvégzést és 100%-os sikerességi arányt jelentenek** a nem MCP implementációkhoz képest, miközben 19,2%-kal csökkentik az API hívások számát az intelligens kontextuskezelés révén. A Model Context Protocol (MCP) a mesterséges intelligencia asszisztensek és fejlesztői eszközök összekapcsolásának alapvető szabványává vált, amely kifinomult munkafolyamatokat tesz lehetővé a beszélgetési AI és a strukturált vállalati rendszerek között. **A production telepítések 20,5%-kal gyorsabb feladatvégzést és 100%-os sikerességi arányt jelentenek** a nem MCP implementációkhoz képest, miközben 19,2%-kal csökkentik az API hívások számát az intelligens kontextuskezelés révén.
+4 -4
View File
@@ -1,6 +1,6 @@
# Project Knowledge # Project Knowledge
mozdIT Bt. website - Next.js 14 app for a Hungarian IT services company (web hosting, email, DNS). mozdIT Bt. website - Next.js 15 app for a Hungarian IT services company (web hosting, email, DNS).
## Quickstart ## Quickstart
@@ -21,7 +21,7 @@ cd proto && npm run test:all # All tests (unit + browser + docker)
## Architecture ## Architecture
- **proto/** - Main Next.js 14 application - **proto/** - Main Next.js 15 application
- `src/app/` - App Router pages and API routes - `src/app/` - App Router pages and API routes
- `src/components/` - React components (Header, Footer, ThemeProvider) - `src/components/` - React components (Header, Footer, ThemeProvider)
- `src/content/` - **JSON content management system** - `src/content/` - **JSON content management system**
@@ -55,7 +55,7 @@ Path alias: `@/*` → `./src/*`
## Conventions ## Conventions
- **Language**: Hungarian content, English code/comments - **Language**: Hungarian content, English code/comments
- **Stack**: Next.js 14 App Router, TypeScript, Tailwind CSS 4 - **Stack**: Next.js 15 App Router, TypeScript, Tailwind CSS 4
- **Design System**: CSS variables, dark mode, animations in `globals.css` - **Design System**: CSS variables, dark mode, animations in `globals.css`
- **Content**: JSON files in `src/content/` for all page texts - **Content**: JSON files in `src/content/` for all page texts
- **Database**: MongoDB with Mongoose - **Database**: MongoDB with Mongoose
@@ -67,7 +67,7 @@ Path alias: `@/*` → `./src/*`
- **All commands run from `proto/`** - The main app lives in the proto subdirectory - **All commands run from `proto/`** - The main app lives in the proto subdirectory
- **Docker required for integration tests** - Start with `docker-compose -f docker-compose.dev.yml up -d` - **Docker required for integration tests** - Start with `docker-compose -f docker-compose.dev.yml up -d`
- **Dual tracking**: Linear (ZEE-* tickets) + TODO.md for task management - **Dual tracking**: Plane (MITHOME-* tickets) + TODO.md for task management
- **Environment variables**: Need `MONGODB_URI`, `MONGODB_DB` for database connection - **Environment variables**: Need `MONGODB_URI`, `MONGODB_DB` for database connection
- **Path mapping**: Use `@/` imports (e.g., `@/lib/mongodb`, `@/content`) - **Path mapping**: Use `@/` imports (e.g., `@/lib/mongodb`, `@/content`)
- **Content changes**: Edit JSON files in `src/content/pages/` - rebuild container to see changes - **Content changes**: Edit JSON files in `src/content/pages/` - rebuild container to see changes
+1 -1
View File
@@ -1,6 +1,6 @@
# mozdIT Bt. Website - Next.js Application # mozdIT Bt. Website - Next.js Application
Modern Next.js 14 website for mozdIT Bt. - Hungarian IT services company. Modern Next.js 15 website for mozdIT Bt. - Hungarian IT services company.
## 🚀 Quick Start ## 🚀 Quick Start
Executable → Regular
+2
View File
@@ -1,3 +1,5 @@
> **Részben elavult** — a friss tesztelési irányelvek: `.agent/steering/testing.md`; a deploy előtti teljes készlet: `scripts/pre-deploy-tests.sh`. A lenti port-hivatkozások a régi dev-stackre vonatkoznak.
# Testing Guide # Testing Guide
This document outlines the comprehensive testing strategy and available test commands for the mozdIT website project. This document outlines the comprehensive testing strategy and available test commands for the mozdIT website project.