Files
websitedev/README.md
T
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
docs: refresh all documentation to the current state
- 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
2026-08-22 19:41:50 +02:00

83 lines
2.9 KiB
Markdown
Executable File

# mozdIT Bt. — Weboldal fejlesztĂ©s (websitedev)
Modern Next.js weboldal a mozdIT Bt. szĂĄmĂĄra — webtĂĄrhely, email- Ă©s DNS-szolgĂĄltatĂĄs, magyar IT vĂĄllalkozĂĄs.
## Stack
- **Frontend**: Next.js 15 (Turbopack), React 19, TypeScript, Tailwind CSS 4
- **Tartalom**: JSON-alapĂș, sĂ©ma-validĂĄlt content rendszer (`proto/src/content/`)
- **CMS**: sajĂĄt, dependency-mentes `content-editor.js` (böngĂ©szƑs szerkesztƑ)
- **Backend**: Next.js API routes, MongoDB
- **Tesztelés**: Jest, React Testing Library, Playwright (smoke), valódi szervert indító CMS-tesztek
- **Deploy**: natĂ­v Docker Compose (`deploy.sh`) + Gitea Actions nĂ©lkĂŒl, lokĂĄlisan vezĂ©relt
- **Monitoring**: Winston + Loki, plusz `scripts/security-scan.sh` (ntfy riasztĂĄssal)
## Gyors indĂ­tĂĄs
```bash
# FejlesztƑi szerver
cd proto && npm run dev
# Docker fejlesztƑi környezet
docker-compose -f docker-compose.dev.yml up -d
# Teljes pre-deploy tesztkészlet
scripts/pre-deploy-tests.sh
```
## Feladatkezelés (Plane)
- **Projekt**: [MITHOME](https://pm.llmdev.mozdit.hu) (workspace: `developments`)
- **TODO.md**: helyi tĂŒkör, a Plane az elsƑdleges forrĂĄs
- **Szinkron**: `node plane-sync.js` (Plane → TODO.md)
- **Ticket-azonosĂ­tĂłk**: `MITHOME-XX`
## Deploy
```bash
./scripts/deploy_to_stage_on_local.sh # staging: teljes tesztkészlet + push + deploy + smoke
./deploy.sh production # Ă©les (szerveren, staging ellenƑrzĂ©se utĂĄn)
```
A CMS „PublikĂĄlĂĄs" gombja szintĂ©n commitol + pushol + deployol (csak a beĂĄllĂ­tott környezetre). RĂ©szletek: `.agent/workflows/deploy.md`, `docs/helyi-staging-deploy.md`.
## Tartalomkezelés
A weboldal szövegei és a CMS a `proto/src/content/` JSON-fåjljaiból jönnek:
```
proto/src/content/
├── schema.js # közös sĂ©ma-validĂĄtor (Next + CMS)
├── types.ts # TypeScript típusok
├── index.ts # tartalom-betöltƑ
├── common.json # közös szövegek (gombok, lĂĄblĂ©c, a11y)
└── pages/ # oldalankĂ©nti tartalom (home, about, services, 
)
```
HasznĂĄlat:
```typescript
import { content, getPageContent } from '@/content'
const about = content.pages.about
```
## DokumentĂĄciĂł
- **Agent-szabĂĄlyok**: `.agent/AGENTS.md`, `.agent/steering/`, `.agent/workflows/`
- **CMS felhasznĂĄlĂłi ĂștmutatĂł**: `docs/felhasznaloi-utmutato.md` (a CMS-ben a ❓ SĂșgĂł is ezt rendereli)
- **Plane szinkron**: `PLANE-SYNC-GUIDE.md`
- **Staging deploy**: `docs/helyi-staging-deploy.md`
- **Gitea runner**: `docs/gitea-runner-telepites.md`
## Környezetek
- **Staging**: https://stage.mozdit.hu
- **CMS (staging)**: https://cms.stage.llmdev.mozdit.hu
- **ntfy (riasztĂĄs)**: `st_limidev_security` topic
## BiztonsĂĄgi monitoring
`scripts/security-scan.sh` (cron, 5 percenként) kriptominer/backdoor indikåtorokat figyel
(ålcåzott folyamatnevek, `/tmp/.kworkerd`-jellegƱ maradvånyok, magas CPU), és talålat esetén
ntfy push-t kĂŒld a `st_limidev_security` topicra.