Do Siki
f918e300a6
Add plane-sync.js one-way (Plane -> TODO.md) synchronization for the MITHOME project. Config reads from .mcp.json with .env override. CLI: --list, --dry-run, --yes, --project, --verbose, --help. Interactive discrepancy resolution (status mismatches, orphans, new issues), backup before write, rate limiting. Pure functions covered by node:test unit tests. Includes PLANE-SYNC-GUIDE.md and TODO.md changelog entry.
4.1 KiB
Executable File
4.1 KiB
Executable File
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
- Szöveg sosem kerülhet közvetlenül komponensbe →
proto/src/content/pages/*.json - Feladatok:
TODO.md(Plane tükörképe), szinkron:node plane-sync.js - Tesztek: minden feature-höz kötelező; commit előtt
npm testzöld - Commit: Conventional Commits (
feat:,fix:,docs:,chore:) - Fájlméret: soft limit 300 sor, hard limit 400 sor
- 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 stringMONGODB_DB— Adatbázis neve (default:mozdit)NEXT_PUBLIC_SITE_URL— Publikus site URLNEXT_PUBLIC_WEBMAIL_URL— Webmail service URLNEXT_PUBLIC_CONTACT_EMAIL— Kapcsolati email címLINEAR_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 |