# 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:**
```bash
# 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:**
```bash
# 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**
```mermaid
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**
```mermaid
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** ✅
- [x] Linear API integráció megtartása
- [x] Requirements és test case tracking
- [x] Test results → Linear comments
- [x] Traceability matrix maintenance

### **FÁZIS 2: GitHub Sync Újradefiniálás** ✅
- [x] **Linear sync eltávolítása** GitHub Actions-ból
- [x] **GitHub-specifikus** workflow-ok létrehozása
- [x] **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:**
```mermaid
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:**
```mermaid
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:**
```mermaid
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)**
- [x] **Linear sync eltávolítása** GitHub Actions-ból
- [x] **GitHub-specifikus workflow** létrehozása
- [x] **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)
- [x] `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