websitedev/CLAUDE.md

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 (Linear tükörképe), szinkron: node linear-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)

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
• LINEAR_API_KEY — Linear szinkronizációhoz

---

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