websitedev/SYNC-STATUS-ANALYSIS.md

ELAVULT (deprecated) — egyszeri Linear→Plane migrációs elemzés (történeti).

Sync Status Analysis & Separation Plan

📊 Jelenlegi Állapot Elemzése

🔍 Probléma Azonosítás

• GitHub és Linear szinkronizáció keveredik
• Rossz projekt frissül a GitHub irányában
• Szétválasztás szükséges a két rendszer között

---

🎯 Szinkronizációs Rendszerek Szétválasztása

📋 1. LINEAR SYNC (Requirements & Test Management)

Cél: Requirements és test case-ek kezelése

Mit szinkronizálunk Linear-ral:

• ✅ Requirements (ZEE-47: Contact Form Validation)
• ✅ Test Cases (ZEE-48: TC-001, ZEE-49: TC-002)
• ✅ Test Execution Results → Linear Comments
• ✅ Traceability Matrix maintenance
• ✅ Test Status Updates (Passed/Failed/Skipped)

Linear API Endpoints:

# Requirements
GET /issues?label=requirement
POST /issues (create requirement)
PUT /issues/{id} (update requirement)

# Test Cases  
GET /issues?label=test-case
POST /issues (create test case)
PUT /issues/{id} (update test case)

# Comments
POST /issues/{id}/comments (test results)

Linear Sync Triggers:

• 🧪 Test Execution (npm run test:*)
• 📊 Test Management Script (sync-test-management.js)
• 🔄 Manual Sync (npm run test:sync)

---

🐙 2. GITHUB SYNC (Code & CI/CD)

Cél: Kód verziókezelés és automatizált deployment

Mit szinkronizálunk GitHub-bal:

• ✅ Source Code (proto/ directory)
• ✅ CI/CD Pipeline (.github/workflows/)
• ✅ Docker Images (ghcr.io registry)
• ✅ Deployment (natív docker compose — deploy.sh)
• ✅ Test Artifacts (test results, reports)

GitHub API Endpoints:

# Repository
GET /repos/{owner}/{repo}
POST /repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches

# Issues & PRs
GET /repos/{owner}/{repo}/issues
POST /repos/{owner}/{repo}/issues/{issue_number}/comments

# Actions
GET /repos/{owner}/{repo}/actions/runs
POST /repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches

GitHub Sync Triggers:

• 📝 Code Push (git push origin main)
• 🔀 Pull Requests (PR creation/update)
• ⏰ Scheduled (daily workflows)
• 🚀 Manual Dispatch (workflow_dispatch)

---

📈 Jelenlegi Implementáció Állapota

✅ LINEAR SYNC - Implementálva

Komponens	Státusz	Leírás
Linear API Integration	✅	MCP connector aktív
Requirements Management	✅	ZEE-47 létrehozva
Test Case Tracking	✅	ZEE-48, ZEE-49 létrehozva
Test Results Sync	✅	sync-test-management.js
Traceability Matrix	✅	TRACEABILITY-MATRIX.md
Test Management Docs	✅	TEST-MANAGEMENT.md

⚠️ GITHUB SYNC - Részben Implementálva

Komponens	Státusz	Probléma	Megoldás
GitHub Actions CI/CD	✅	-	Teljesen működik
Docker Integration	✅	-	Teljesen működik
Test Execution	✅	-	Teljesen működik
Linear Sync in GitHub	❌	ROSSZ PROJEKT	Szétválasztás szükséges
Deployment Integration	✅	Natív docker compose (deploy.sh)	Nincs külső PaaS függőség

---

🔧 Szétválasztási Terv

1. LINEAR SYNC - Tiszta Megtartás

graph TD
    A[Test Execution] --> B[sync-test-management.js]
    B --> C[Linear API]
    C --> D[ZEE-47: Requirements]
    C --> E[ZEE-48: TC-001]
    C --> F[ZEE-49: TC-02]
    
    G[Manual Sync] --> B
    H[Test Reports] --> B

2. GITHUB SYNC - Újradefiniálás

graph TD
    A[Code Push] --> B[GitHub Actions]
    B --> C[Run Tests]
    B --> D[Build Docker]
    B --> E[deploy.sh — docker compose up --build]
    
    F[PR Creation] --> G[Test Validation]
    G --> H[Deploy to Staging]
    
    I[Manual Trigger] --> B

---

📋 Műveleti Terv

FÁZIS 1: Linear Sync Tisztítás ✅

• Linear API integráció megtartása
• Requirements és test case tracking
• Test results → Linear comments
• Traceability matrix maintenance

FÁZIS 2: GitHub Sync Újradefiniálás ✅

• Linear sync eltávolítása GitHub Actions-ból
• GitHub-specifikus workflow-ok létrehozása
• Deploy natív docker compose-szal (deploy.sh)
• Docker registry beállítása

FÁZIS 3: Szinkronizáció Szétválasztása 📋

• Linear sync → csak test management
• GitHub sync → csak CI/CD és deployment
• Külön dokumentáció mindkét rendszerhez
• Monitoring szétválasztása

---

🎯 Új Architektúra Diagram

Jelenlegi Problémás Állapot:

graph TB
    subgraph "PROBLÉMA: Kevert Szinkronizáció"
        A[Code Push] --> B[GitHub Actions]
        B --> C[Linear Sync] 
        C --> D[ROSSZ PROJEKT FRISSÜL]
        B --> E[Test Execution]
        E --> F[Linear API]
        F --> G[ZEE-47, ZEE-48, ZEE-49]
    end

Cél: Szétválasztott Architektúra:

graph TB
    subgraph "DEVELOPMENT"
        A[Code Changes] --> B[Git Push]
        C[Test Execution] --> D[Test Results]
    end
    
    subgraph "LINEAR SYNC (Test Management Only)"
        D --> E[sync-test-management.js]
        E --> F[Linear API]
        F --> G[ZEE-47: Requirements]
        F --> H[ZEE-48: TC-001]
        F --> I[ZEE-49: TC-002]
        F --> J[Test Comments]
    end
    
    subgraph "GITHUB SYNC (CI/CD Only)"
        B --> K[GitHub Actions]
        K --> L[Run Tests]
        K --> M[Build Docker Image]
        K --> O[deploy.sh — docker compose up --build]
        
        P[PR Creation] --> Q[Test Validation]
        Q --> R[Staging Deploy]
    end
    
    subgraph "DEPLOYMENT"
        O --> S[Production]
        R --> T[Staging]
    end
    
    subgraph "MONITORING"
        U[Linear Dashboard] --> V[Test Status]
        W[GitHub Actions] --> X[Build Status]
        Y[Healthcheck /api/health] --> Z[Deployment Status]
    end

Szinkronizációs Folyamatok:

sequenceDiagram
    participant Dev as Developer
    participant Git as GitHub
    participant Linear as Linear
    participant Docker as Docker Registry
    participant Server as Szerver (docker compose)
    
    Note over Dev,Server: LINEAR SYNC (Test Management)
    Dev->>Linear: Run Tests
    Linear->>Linear: Update ZEE-47, ZEE-48, ZEE-49
    Linear->>Linear: Add Test Comments
    
    Note over Dev,Server: GITHUB SYNC (CI/CD)
    Dev->>Git: git push
    Git->>Git: GitHub Actions Trigger
    Git->>Server: deploy.sh — git pull + docker compose up --build

---

📊 Jelenlegi Problémák Listája

🚨 KRITIKUS

1. Linear sync GitHub Actions-ban → Rossz projekt frissül
2. Docker registry beállítása → Deploy natív compose-szal, nincs registry push
3. GitHub secrets hiányoznak → Linear API key

⚠️ FONTOS

1. Workflow duplikáció → CI és test-management overlap
2. Dokumentáció keveredés → Linear és GitHub docs össze vannak keverve
3. Monitoring szétválasztás → Két külön dashboard kell

📋 KIS PROBLÉMÁK

1. Badge URLs → GitHub repository URL-ek hardcoded
2. Test result paths → Relatív path-ok problémásak lehetnek
3. Environment variables → GitHub Actions vs local különbségek

---

🎯 Következő Lépések Prioritás Szerint

1. AZONNALI (Kritikus)

• Linear sync eltávolítása GitHub Actions-ból
• GitHub-specifikus workflow létrehozása
• Deploy natív docker compose-szal (deploy.sh)

2. RÖVID TÁVÚ (1-2 nap)

• GitHub secrets beállítása
• Docker registry konfigurálása
• Monitoring szétválasztása

3. KÖZÉP TÁVÚ (1 hét)

• Dokumentáció tisztítása
• Dashboard-ok szétválasztása
• Automated testing mindkét rendszerben

---

📝 Dokumentum Frissítési Terv

Frissítendő Fájlok:

• .github/workflows/ci.yml → Linear sync eltávolítása
• .github/workflows/test-management.yml → GitHub-specifikusra átírás
• scripts/sync-test-management.js → Csak Linear sync
• README.md → Badge URL-ek javítása
• GITHUB-INTEGRATION.md → Újraírás

Új Dokumentumok:

• LINEAR-SYNC-GUIDE.md → Linear-specifikus útmutató
• GITHUB-CICD-GUIDE.md → CI/CD útmutató (Gitea Actions + natív compose)
• DEPLOYMENT-GUIDE.md → Natív docker compose deploy (deploy.sh)

---

Utolsó frissítés: 2026-08-17
Státusz: Dokploy eltávolítva, natív docker compose deploy + Gitea Actions
Következő lépés: Docker registry opcionális beállítása