websitedev/README.md

mozdIT Bt. — Weboldal fejlesztés (websitedev)

Modern Next.js weboldal a mozdIT Bt. számára — webtárhely, email- és DNS-szolgáltatás, magyar IT vállalkozás.

Stack

• 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

# Fejlesztői szerver
cd proto && npm run dev

# Docker fejlesztői környezet
docker-compose -f docker-compose.dev.yml up -d

# Teljes pre-deploy tesztkészlet
scripts/pre-deploy-tests.sh

Feladatkezelés (Plane)

• Projekt: MITHOME (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

Deploy

./scripts/deploy_to_stage_on_local.sh   # staging: teljes tesztkészlet + push + deploy + smoke
./deploy.sh production                  # éles (szerveren, staging ellenőrzése után)

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.

Tartalomkezelés

A weboldal szövegei és a CMS a proto/src/content/ JSON-fájljaiból jönnek:

proto/src/content/
├── schema.js        # közös séma-validátor (Next + CMS)
├── types.ts         # TypeScript típusok
├── index.ts         # tartalom-betöltő
├── common.json      # közös szövegek (gombok, lábléc, a11y)
└── pages/           # oldalankénti tartalom (home, about, services, …)

Használat:

import { content, getPageContent } from '@/content'
const about = content.pages.about

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.