Files
websitedev/knowledge.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

2.7 KiB
Executable File

Project Knowledge

mozdIT Bt. website - Next.js 15 app for a Hungarian IT services company (web hosting, email, DNS).

Quickstart

# Setup
cd proto && npm install

# Dev server (with Turbopack)
cd proto && npm run dev

# Docker dev environment (includes MongoDB, Grafana, Loki)
docker-compose -f docker-compose.dev.yml up -d

# Tests
cd proto && npm test              # Unit tests
cd proto && npm run test:all      # All tests (unit + browser + docker)

Architecture

  • proto/ - Main Next.js 15 application
    • src/app/ - App Router pages and API routes
    • src/components/ - React components (Header, Footer, ThemeProvider)
    • src/content/ - JSON content management system
      • types.ts - Content TypeScript definitions
      • index.ts - Content loader utility
      • common.json - Shared texts (buttons, labels)
      • pages/*.json - Page-specific content
    • src/lib/ - Utilities (MongoDB, Logger, Site Config)
    • src/config/ - Static site configuration
    • src/types/ - TypeScript definitions
  • docker/ - MongoDB initialization scripts
  • docs/ - Project documentation (Hungarian)
  • scripts/ - Test sync and reporting scripts

Path alias: @/*./src/*

Commands (run from proto/)

Command Description
npm run dev Dev server with Turbopack
npm run build Production build
npm run lint ESLint check
npm test Unit tests
npm run test:browser Browser integration tests
npm run test:integration Docker integration tests
npm run test:e2e End-to-end tests
npm run test:all All test suites
npm run docker:dev Start Docker stack

Conventions

  • Language: Hungarian content, English code/comments
  • Stack: Next.js 15 App Router, TypeScript, Tailwind CSS 4
  • Design System: CSS variables, dark mode, animations in globals.css
  • Content: JSON files in src/content/ for all page texts
  • Database: MongoDB with Mongoose
  • Logging: Winston with Loki integration
  • Testing: Jest + React Testing Library
  • ESLint: next/core-web-vitals + next/typescript

Gotchas

  • All commands run from proto/ - The main app lives in the proto subdirectory
  • Docker required for integration tests - Start with docker-compose -f docker-compose.dev.yml up -d
  • Dual tracking: Plane (MITHOME-* tickets) + TODO.md for task management
  • Environment variables: Need MONGODB_URI, MONGODB_DB for database connection
  • Path mapping: Use @/ imports (e.g., @/lib/mongodb, @/content)
  • Content changes: Edit JSON files in src/content/pages/ - rebuild container to see changes
  • Dark mode: Uses data-theme attribute on <html>, managed by ThemeProvider