Gratech CometX 🚀

منصة ذكاء اصطناعي آمنة مع بنية ثلاثية الفصوص - Secure AI Platform with Three-Lobe Architecture

🎨 Three-Lobe Architecture

flowchart TD
    subgraph "Comet-X Digital Entity"
        Executive[Executive Lobe<br/>Service Worker<br/>Control & Memory]
        Sensory[Sensory Lobe<br/>Shadow DOM<br/>Input & Context]
        Cognitive[Cognitive Lobe<br/>Offscreen Canvas<br/>Local AI Models]
        
        User[X User] -->|Input| Sensory
        Sensory -->|Context| Executive
        Executive -->|Coordination| Cognitive
        Cognitive -->|Response| Executive
        Executive -->|Output| User
    end

Loading

🚀 Quick Start

Prerequisites

• Node.js 20+
• Docker & Docker Compose (optional)

Local Development

Backend API

# Install dependencies
npm ci

# Start backend server
npm start

# API available at http://localhost:3000
# Swagger docs at http://localhost:3000/docs

Frontend

cd frontend

# Install dependencies
npm install

# Start development server
npm run dev

# Frontend available at http://localhost:5173

Docker Compose (Recommended)

Run both frontend and backend with one command:

docker-compose up --build

Services:

• Frontend: http://localhost (port 80)
• Backend API: http://localhost:3000
• Swagger Docs: http://localhost:3000/docs

📡 API Endpoints

• GET /health - Health check
• GET /api/v1/models - List available AI models
• POST /api/v1/chat - Send chat message
• GET /api/v1/status - System status
• GET /docs - Swagger API documentation

🎯 Features

Frontend (React + TypeScript + Tailwind)

• ✅ Dark theme (Laplace color scheme)
• ✅ Model selector (DeepSeek-R1, GPT-4, Claude, Llama)
• ✅ Thinking/Reasoning block display
• ✅ Code syntax highlighting
• ✅ File upload support
• ✅ Chat history sidebar
• ✅ Streaming effect for responses
• ✅ SSH Terminal component with:
  • Root connection support
  • Interactive terminal
  • Command history
  • Private key support

Backend (Node.js Express)

• ✅ RESTful API with Express
• ✅ CORS enabled
• ✅ Swagger documentation
• ✅ Error handling
• ✅ Health monitoring

🔗 روابط النشر

• GitHub Pages: https://grar00t.github.io/gratech-comet-x/
• Azure Static Web: يتم النشر تلقائياً عبر OIDC
• Docker Image: ghcr.io/grar00t/gratech-comet-x:latest

الخطوات السريعة

1. أضف أسرار X وAzure (بدون كشف القيم).
2. فعّل OIDC في Entra ID مع Federated Credential.
3. ادفع إلى main لمشاهدة Workflows تعمل.

الحِزمة الأمنية

• CodeQL (Security tab)
• Dependabot (تحديثات)
• Trivy (فحص Docker)
• حماية الفرع main (PR + Status checks)

📚 الوثائق الإضافية

• دليل الإعداد الكامل
• إعداد Azure Front Door
• سياسة الأمان