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.
102 lines
4.1 KiB
Markdown
Executable File
102 lines
4.1 KiB
Markdown
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
|
|
|
|
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
|
|
- `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 | |