---
sidebar_position: 1
---

# Platform Architecture

## Overview

All SKIC Playground applications share a common infrastructure built on TrueNAS SCALE and Gitea.

## Full Pipeline — Interactive Diagram

import Drawio from '@theme/Drawio';
import smpPipeline from '!!raw-loader!./diagrams/smp-pipeline.drawio';

<Drawio content={smpPipeline} />

## Infrastructure

```mermaid
graph TB
    subgraph TrueNAS["🖥 TrueNAS SCALE — lego-cloud.eu"]
        Gitea["🗂 Gitea\nSource + CI/CD"]
        Zot["📦 Zot Registry\n:30264"]
        Apps["🐳 App Containers"]
        Hermes["🤖 Hermes Agent\nAI Operations"]
        Keycloak["🔐 Keycloak\nAuth / SSO"]
    end

    Gitea -->|push image| Zot
    Zot -->|pull & deploy| Apps
    Hermes -->|automates| Gitea
    Hermes -->|manages| Apps
    Keycloak -->|secures| Apps
```

## Shared Services

| Service | URL | Purpose |
|---|---|---|
| Gitea | gitea.lego-cloud.eu | Source code, CI/CD, issue tracking |
| Keycloak | keycloak.lego-cloud.eu | Authentication & SSO |
| Zot Registry | :30264 | OCI container image registry |
| Hermes Agent | Local | AI operations, automation, documentation |

## CI/CD Flow

```mermaid
sequenceDiagram
    participant Dev as Developer / Jarvis
    participant Git as Gitea
    participant CI as Gitea Actions
    participant Reg as Zot Registry
    participant Host as TrueNAS

    Dev->>Git: git push main
    Git->>CI: Trigger workflow
    CI->>CI: pnpm install
    CI->>CI: pnpm build
    CI->>Reg: docker push image
    CI->>Host: Deploy updated container
    Host-->>Dev: ✅ Live
```

## Repository Structure

```
skic-v1-playground/
├── documentation/          ← This docs site (Docusaurus)
├── stock-market-pro/       ← (Planned) Trading system
└── ...                     ← Future applications
```