Do SikiandClaude Sonnet 5
12b2711168
CI Pipeline with Test Management / đ§Ș Run Tests & Generate Reports (push) Canceled after 0s
Test Reporting & Gherkin Analysis / đ§Ș Run Tests & Generate Reports (push) Canceled after 0s
CI Pipeline with Test Management / đł Docker Integration Tests (push) Canceled after 0s
CI Pipeline with Test Management / đïž Build Docker Image (push) Canceled after 0s
CI Pipeline with Test Management / đ Generate Test Summary (push) Canceled after 0s
Test Reporting & Gherkin Analysis / đ Analyze Test Coverage (push) Canceled after 0s
Test Reporting & Gherkin Analysis / đ Sync with Linear (push) Canceled after 0s
Test Reporting & Gherkin Analysis / ⥠Performance Monitoring (push) Canceled after 0s
Removes the standalone, git-push-based content editor that predates
Payload CMS: content-editor.js, its scripts/cms-*.js modules, its
scripts/test-content-editor-*.js + scripts/test-cms-publish.js test
suite, scripts/markdown-render.js (only used by the editor's guide
renderer), the proto-side test doubles (cms-editor-client.test.ts,
cms-editor-shortcuts.test.ts), and the editor's own user guide
(docs/felhasznaloi-utmutato.md).
Kept: proto/src/content/*.json (still the source for
migrate-content-to-payload.ts and test fixtures for Header/Footer,
per MITHOME-96), proto/src/content/schema.js + scripts/test-content-schema.js
(still validate those JSON files), and docs/content-editor-recovery.md
(historical incident record, not user-facing tool docs).
Safety net before deletion (per user request): added
proto/scripts/export-content-snapshot.ts, a reusable Payload Local API
exporter, and ran it to produce docs/backups/payload-content-snapshot-*.json
â a full hu/en snapshot of every Global + LegalPages + Partners document
at the moment of retirement. Also confirmed no data-loss risk otherwise:
.content-backups/ (the editor's own gitignored backup dir) tops out at
2026-08-23, well before today's fresh migration run, and every JSON
edit ever made through the editor already exists as its own git commit
("content: frissĂtve a CMS-bĆl").
Updated dangling references: pre-deploy-tests.sh and
.agent/steering/testing.md (dropped the CMS test block),
.agent/workflows/deploy.md (publish flow is now Payload draft/publish,
not git push), CLAUDE.md + .agent/AGENTS.md (dropped the /cms-feature
workflow, deleted alongside it), README.md (stack description),
.agent/steering/development-rules.md (the guide-maintenance rule no
longer has a guide to maintain).
Verified: tsc, lint, proto unit tests (51 passed), root
test-content-schema.js, plane-sync unit tests, production build all
green after the deletion.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
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, /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 | |