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
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:
+1
-1
@@ -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`
|
||||||
|
|||||||
@@ -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.
|
||||||
|
|||||||
@@ -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ó
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
@@ -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?
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
@@ -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)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -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
@@ -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
@@ -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
@@ -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**
|
||||||
|
|||||||
@@ -1,131 +1,82 @@
|
|||||||
# mozdIT Bt. Website Development
|
# mozdIT Bt. — Weboldal fejlesztés (websitedev)
|
||||||
|
|
||||||
[](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-compose.dev.yml)
|
|
||||||
[](https://pm.llmdev.mozdit.hu)
|
|
||||||
[](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
|
|
||||||
|
|
||||||

|
|
||||||

|
|
||||||

|
|
||||||
|
|
||||||
### ✅ 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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
|
||||||
|
|||||||
@@ -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`.
|
||||||
|
|||||||
Executable → Regular
+2
@@ -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
@@ -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
@@ -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
@@ -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.
|
||||||
|
|||||||
Reference in New Issue
Block a user