Do SikiandClaude Sonnet 5
758ee2cfed
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
The Content layer description across the AI-agent steering docs still described the pre-migration JSON system as the live, current mechanism â rule #1 in CLAUDE.md and the Content row in architecture.md explicitly told future work (and future agent sessions) to edit proto/src/content/pages/*.json directly, which the live site hasn't read since MITHOME-91. Rewrote, per the ticket's named targets: - .agent/steering/architecture.md: system overview, the Content layer table row, rule #1, and the Content Management code example now describe Payload Globals/Collections + the payload-content.ts Local API adapter, with /admin as the editing surface. - CLAUDE.md: Stack line now names Payload CMS, rule #1 rewritten the same way, and the project-structure tree gets the (frontend)/(payload) route groups, globals/, collections/, and payload.config.ts that were entirely missing from it. Also fixed directly-adjacent staleness found while doing this pass â same "how is content edited" documentation debt, just not literally named in the ticket: - .agent/AGENTS.md: same project-structure tree gap as CLAUDE.md. - .agent/workflows/new-feature.md: step 3 told contributors to edit the JSON file directly; now points at the Payload config + admin. - .agent/workflows/review.md: the example "flag hardcoded text" review comment suggested moving it into the JSON file. - .agent/steering/development-rules.md: the TRADEOFF code example literally used "JSON content management vs CMS" as a live open decision â that decision is resolved, updated the example to match. - README.md: the entire "TartalomkezelĂ©s" section and a "CMS PublikĂĄlĂĄs gomb" paragraph described the retired content-editor.js workflow (git-push-based publish, JSON directory tour) as current; also dropped a dead link to docs/felhasznaloi-utmutato.md, deleted in MITHOME-93. Doc-only change, no proto/ source touched â no gate to run beyond a sanity re-read of each edited file. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
109 lines
5.1 KiB
Markdown
Executable File
109 lines
5.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, Payload CMS (self-hosted, `/admin`), 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** â Payload CMS Global/Collection mezĆ (admin: `/admin`), a frontend `proto/src/lib/payload-content.ts`-en ĂĄt olvassa. (`proto/src/content/pages/*.json` mĂĄr csak a migrĂĄciĂłs seed-script forrĂĄsa + teszt-fixture, Ă©lĆ oldal nem hasznĂĄlja â MITHOME-91/93/96.)
|
|
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/
|
|
â â âââ (frontend)/ # Publikus oldalak: [locale]/[slug] catch-all
|
|
â â âââ (payload)/ # Payload admin (/admin) + REST/GraphQL API
|
|
â âââ components/ # React komponensek (PascalCase.tsx)
|
|
â âââ globals/ # Payload Globals (Home, About, Services, Contact, Common)
|
|
â âââ collections/ # Payload Collections (LegalPages, Partners, Media, ContactSubmissions, Users)
|
|
â âââ payload.config.ts # Payload CMS konfigurĂĄciĂł
|
|
â âââ content/ # RĂGI JSON rendszer â csak migrĂĄciĂłs seed + teszt-fixture (MITHOME-91/93/96)
|
|
â â âââ common.json
|
|
â â âââ pages/
|
|
â âââ lib/ # payload-content.ts (Local API adapter), MongoDB health-check, Logger
|
|
â âââ 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
|
|
- `ADMIN_EMAIL` / `ADMIN_PASSWORD` â staging/production: `deploy.sh` ezekkel hoz lĂ©tre egy ismert admin usert egy vadonatĂșj adatbĂĄzison (MITHOME-97 follow-up), csak akkor, ha a `users` collection mĂ©g ĂŒres
|
|
|
|
---
|
|
|
|
## 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 | |