# 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

```bash
# 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](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`

## Deploy

```bash
./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:

```typescript
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.