---
sidebar_position: 1
---

# Platform Architecture

## Overview

All SKIC Playground applications share a common infrastructure pattern:

```
┌─────────────────────────────────────────────────────┐
│                   TrueNAS SCALE                      │
│                                                      │
│  ┌──────────┐  ┌──────────┐  ┌──────────────────┐  │
│  │  Gitea   │  │ Registry │  │  App Containers  │  │
│  │  + CI/CD │  │  (Zot)   │  │                  │  │
│  └──────────┘  └──────────┘  └──────────────────┘  │
│                                                      │
│  ┌──────────┐  ┌──────────┐  ┌──────────────────┐  │
│  │Keycloak  │  │  Hermes  │  │   Monitoring     │  │
│  │  (Auth)  │  │  (Agent) │  │                  │  │
│  └──────────┘  └──────────┘  └──────────────────┘  │
└─────────────────────────────────────────────────────┘
```

## Shared Services

| Service | URL | Purpose |
|---|---|---|
| Gitea | gitea.lego-cloud.eu | Source code, CI/CD |
| Keycloak | keycloak.lego-cloud.eu | Authentication, SSO |
| Zot Registry | :30264 | Container images |
| Hermes Agent | Local | AI operations, automation |

## CI/CD Pattern

All applications follow the same Gitea Actions workflow:

1. **Push to main** → Build + Test
2. **Build container** → Push to Zot registry
3. **Deploy** → Update running container
4. **Docs update** → Rebuild documentation site

## Repository Structure

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