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
75 lines
2.7 KiB
Markdown
Executable File
75 lines
2.7 KiB
Markdown
Executable File
# Project Knowledge
|
|
|
|
mozdIT Bt. website - Next.js 15 app for a Hungarian IT services company (web hosting, email, DNS).
|
|
|
|
## Quickstart
|
|
|
|
```bash
|
|
# 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
|