# CLAUDE.md

> **[AI AGENT — OLVASD EL ELŐSZÖR]**
> Ez a fájl egy gyors referencia. A teljes szabályrendszer és workflow-ok a `.agent/` mappában találhatók.
> **Kötelező elolvasni**: `.agent/AGENTS.md` → `.agent/steering/development-rules.md` → `.agent/steering/architecture.md`

---

## Projekt azonosítás

- **Projekt**: mozdIT Bt. weboldal (websitedev)
- **Plane workspace**: `developments` — `pm.llmdev.mozdit.hu`
- **Stack**: Next.js 15, React 19, TypeScript, Tailwind CSS 4, MongoDB, Winston
- **Fő könyvtár**: `proto/` — **minden parancsot innen futtatunk**

---

## Gyors referencia — Alapszabályok

1. **Szöveg sosem kerülhet közvetlenül komponensbe** → `proto/src/content/pages/*.json`
2. **Feladatok**: `TODO.md` (Plane tükörképe), szinkron: `node plane-sync.js`
3. **Tesztek**: minden feature-höz kötelező; commit előtt `npm test` zöld
4. **Commit**: Conventional Commits (`feat:`, `fix:`, `docs:`, `chore:`)
5. **Fájlméret**: soft limit 300 sor, hard limit 400 sor
6. **Language**: kód+commit = English, kommunikáció+docs = Magyar

---

## Kötelező parancsok (`proto/` mappából)

```bash
npm run dev             # fejlesztői szerver (Turbopack)
npm run build           # produkciós build
npm run lint            # ESLint ellenőrzés
npm test                # unit tesztek
npm run test:coverage   # lefedettség riport
npm run test:all        # teljes test suite
node plane-sync.js --list   # Plane projektek listázása
node plane-sync.js          # Plane szinkronizáció
```

---

## Projekt struktúra

```
websitedev/
├── proto/                      # Fő Next.js alkalmazás
│   └── src/
│       ├── app/                # App Router: oldalak és API route-ok
│       ├── components/         # React komponensek (PascalCase.tsx)
│       ├── content/            # JSON tartalom-kezelő rendszer
│       │   ├── common.json     # Közös szövegek
│       │   └── pages/          # Oldal-specifikus JSONok
│       ├── lib/                # MongoDB, Logger, Site Config
│       ├── config/             # Statikus site konfiguráció
│       └── types/              # TypeScript típusok
├── docs/                       # Projekt dokumentáció (Magyar)
├── .agent/                     # AI szabályrendszer ← OLVASD EL
│   ├── AGENTS.md               # Elsődleges szabályok
│   ├── steering/               # Auto-betöltődő irányelvek
│   ├── workflows/              # /new-feature, /fix-bug, /review, /deploy
│   └── references/             # Accessibility checklist
├── TODO.md                     # Feladatlista (Plane szinkron)
└── plane-sync.js               # Plane szinkronizáló script
```

---

## Környezeti változók

Szükséges változók (`.env` és `proto/.env.local`):
- `MONGODB_URI` — MongoDB connection string
- `MONGODB_DB` — Adatbázis neve (default: `mozdit`)
- `NEXT_PUBLIC_SITE_URL` — Publikus site URL
- `NEXT_PUBLIC_WEBMAIL_URL` — Webmail service URL
- `NEXT_PUBLIC_CONTACT_EMAIL` — Kapcsolati email cím
- `PLANE_API_KEY` — Plane szinkronizációhoz (a `.mcp.json`-ban is lehet)
- `PAYLOAD_SECRET` — Payload CMS JWT/session aláíráshoz (MITHOME-86); környezetenként egyedi, erős érték

---

## API struktúra

- `GET /api/health` — Rendszer állapot + MongoDB kapcsolat ellenőrzés
- Minden endpoint egységes válasz formátumban: `{ success, data, error }`
- Rate limiting érzékeny endpoint-okon (pl. `/api/contact`)

---

## Teljes szabályrendszer

| Dokumentum | Tartalom |
| --- | --- |
| `.agent/AGENTS.md` | Összes alapelv, Git konvenciók, mikor kérdezz |
| `.agent/steering/development-rules.md` | Kódolási szabályok, bugfix módszertan, intent capture |
| `.agent/steering/architecture.md` | Rétegek, adatfolyam, design system szabályok |
| `.agent/steering/testing.md` | Tesztelési stratégia, coverage elvárások |
| `.agent/workflows/new-feature.md` | Új funkció fejlesztési lépései |
| `.agent/workflows/fix-bug.md` | Hibajavítás lépései (TDD) |
| `.agent/workflows/review.md` | Code review checklist |
| `.agent/workflows/deploy.md` | Deployment folyamat |
| `.agent/references/accessibility-checklist.md` | WCAG 2.1 AA ellenőrzőlista |