Do Siki
410b4a2e2f
CI Pipeline with Test Management / đ§Ș Run Tests & Generate Reports (push) Waiting to run
CI Pipeline with Test Management / đł Docker Integration Tests (push) Blocked by required conditions
CI Pipeline with Test Management / đïž Build Docker Image (push) Blocked by required conditions
CI Pipeline with Test Management / đ Generate Test Summary (push) Blocked by required conditions
Test Reporting & Gherkin Analysis / đ§Ș Run Tests & Generate Reports (push) Waiting to run
Test Reporting & Gherkin Analysis / đ Analyze Test Coverage (push) Blocked by required conditions
Test Reporting & Gherkin Analysis / đ Sync with Linear (push) Blocked by required conditions
Test Reporting & Gherkin Analysis / ⥠Performance Monitoring (push) Blocked by required conditions
- agent docs: Linear (ZEE-*) â Plane (MITHOME-*) everywhere (task tracking, commit examples, workflows, env vars) - testing steering: replace the obsolete Gherkin/Linear reporting with the pre-deploy suite and the CMS test scripts - README: rewrite to Next.js 15, local deploy, Plane, CMS, security monitoring - DOCKER/proto docs: correct dev-stack ports (app 8080, mongo 27018) and Next.js 15 - content-editor-recovery: mark the old 'next steps' as done - mark clearly-obsolete Linear/GitHub-era guides as deprecated (banner) â LINEAR-SYNC, GITHUB-CICD/INTEGRATION, TEST-MANAGEMENT/REPORTING, traceability, sync-status analysis, requirements docs
103 lines
4.2 KiB
Markdown
Executable File
103 lines
4.2 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, /cms-feature, /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)
|
|
|
|
---
|
|
|
|
## 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/cms-feature.md` | CMS fejlesztĂ©s + ĂștmutatĂł karbantartĂĄs |
|
|
| `.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 | |