feat: Sharp style, Tailwind+shadcn, dark navbar, nav restructure, Go/monorepo guidelines

Styling: - Tailwind CSS v4 (preflight:false) integrated via PostCSS plugin - shadcn/ui New York style with --radius:0 (sharp corners everywhere) - Zero border-radius on ALL elements: buttons, code blocks, cards, admonitions, badges - Navbar FORCE dark (#0a0a0a) in both light/dark modes via !important - ThemeSynchronizer: bridges Docusaurus data-theme → shadcn .dark class - Active sidebar item gets left border accent instead of rounded bg React UI components (src/components/ui/index.tsx): - Badge (6 variants: wip, stable, planned, success, warning, outline) - Card + CardHeader + CardTitle + CardContent - Callout (note/info/success/warning/danger) - sharp, left-border style - PropertiesTable - monospace typed API reference tables - StatusIndicator - operational/degraded/outage/maintenance Navigation restructure: - Introduction → Platform → Products → Engineering → Runbooks - Old 'applications/' removed, moved to products/stock-market-pro/ - New Platform section: infrastructure overview + CI/CD pipeline docs - New Engineering section: monorepo structure, Go stack, conventions - New Runbooks section: incident severity, common procedures Implementation guidelines (engineering/guidelines.md): - Monorepo layout with go.work workspace - Go as primary language (why + standard library table) - Python as sidecar for data/ML workloads - Code conventions: gofmt, error wrapping, logging, testing - Git conventions: branch naming, conventional commits - Makefile targets per app - How to add a new application (step-by-step)
2026-07-16 20:58:07 +00:00
parent 674ec348ce
commit 464ea75730
26 changed files with 2076 additions and 217 deletions
@@ -0,0 +1,65 @@
+---
+sidebar_position: 2
+---
+
+# CI/CD Pipeline
+
+All applications follow a single, consistent Gitea Actions pipeline.
+
+## Flow
+
+```mermaid
+sequenceDiagram
+    participant J as Jarvis / Dev
+    participant G as Gitea
+    participant A as Actions Worker
+    participant R as Zot Registry
+    participant H as TrueNAS Host
+
+    J->>G: git push main
+    G->>A: Trigger workflow
+    A->>A: pnpm/go build + test
+    A->>R: docker push image
+    A->>H: Deploy (restart container)
+    H-->>J: ✅ Live
+```
+
+## Workflow Template
+
+```yaml
+# .gitea/workflows/build.yml
+name: Build and Deploy
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build
+        run: make build    # or go build / pnpm build
+
+      - name: Test
+        run: make test
+
+      - name: Docker build & push
+        if: github.ref == 'refs/heads/main'
+        run: |
+          docker build -t $ZOT_REGISTRY/$APP_NAME:$GITHUB_SHA .
+          docker push $ZOT_REGISTRY/$APP_NAME:$GITHUB_SHA
+
+      - name: Deploy
+        if: github.ref == 'refs/heads/main'
+        run: |
+          ssh deploy@lego-cloud.eu "docker pull && docker restart $APP_NAME"
+```
+
+## Gitea Actions Runners
+
+Runners need to be registered on the Gitea instance. See [Gitea Actions documentation](https://docs.gitea.com/usage/actions/quickstart) for setup.
@@ -0,0 +1,43 @@
+---
+sidebar_position: 1
+---
+
+# Platform Overview
+
+SKIC Playground runs entirely on self-hosted infrastructure at `lego-cloud.eu`.
+
+## Infrastructure Diagram
+
+```mermaid
+graph TB
+    subgraph TrueNAS["TrueNAS SCALE 26.0 — lego-cloud.eu"]
+        direction TB
+        Gitea["Gitea 1.26\nSource + CI/CD\ngitea.lego-cloud.eu"]
+        Zot["Zot Registry\n:30264\nOCI images"]
+        Keycloak["Keycloak\nSSO / Auth\nkeycloak.lego-cloud.eu"]
+        Hermes["Hermes Agent\nAI Operations\n(Jarvis)"]
+        Apps["Application\nContainers"]
+    end
+
+    Dev["Developer / Jarvis"] -->|git push| Gitea
+    Gitea -->|Actions runner| CI["CI/CD Worker"]
+    CI -->|docker push| Zot
+    CI -->|deploy| Apps
+    Zot -->|pull| Apps
+    Keycloak -->|auth| Apps
+    Hermes -->|manages| Gitea
+    Hermes -->|manages| Apps
+```
+
+## Services
+
+| Service | URL | Version | Purpose |
+|---|---|---|---|
+| Gitea | gitea.lego-cloud.eu | 1.26.2 | Source control, CI/CD, issue tracking |
+| Keycloak | keycloak.lego-cloud.eu | — | Authentication, SSO |
+| Zot | :30264 | — | OCI-compliant container registry |
+| Hermes | local | — | AI agent (Jarvis) — automation, docs, ops |
+
+## Storage
+
+All persistent data lives under `/mnt/lego-cloud-v1-2025-11-28/` on TrueNAS.
@@ -0,0 +1,94 @@
+<mxfile host="Electron" modified="2026-07-16T00:00:00.000Z" agent="Jarvis" version="24.0.0" type="device">
+  <diagram id="smp-pipeline" name="SMP Data Pipeline">
+    <mxGraphModel dx="1422" dy="762" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1169" pageHeight="827" math="0" shadow="0">
+      <root>
+        <mxCell id="0" />
+        <mxCell id="1" parent="0" />
+
+        <!-- Title -->
+        <mxCell id="title" value="Stock Market Professional — Data Pipeline" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=18;fontStyle=1;fontColor=#6366f1;" vertex="1" parent="1">
+          <mxGeometry x="200" y="20" width="760" height="40" as="geometry" />
+        </mxCell>
+
+        <!-- Market Data APIs -->
+        <mxCell id="api" value="Market Data APIs&#xa;(Yahoo / Alpha Vantage / Polygon)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1a1a2e;strokeColor=#6366f1;fontColor=#ffffff;fontSize=11;fontStyle=1;" vertex="1" parent="1">
+          <mxGeometry x="80" y="120" width="200" height="60" as="geometry" />
+        </mxCell>
+
+        <!-- Data Ingestor -->
+        <mxCell id="ingestor" value="Data Ingestor&#xa;Python / APScheduler" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#111827;strokeColor=#818cf8;fontColor=#ffffff;fontSize=11;fontStyle=1;" vertex="1" parent="1">
+          <mxGeometry x="360" y="120" width="200" height="60" as="geometry" />
+        </mxCell>
+
+        <!-- TimescaleDB -->
+        <mxCell id="tsdb" value="Market Data Store&#xa;SQLite / TimescaleDB" style="shape=cylinder3;whiteSpace=wrap;html=1;boundedLbl=1;backgroundOutline=1;size=15;fillColor=#0f172a;strokeColor=#6366f1;fontColor=#ffffff;fontSize=11;fontStyle=1;" vertex="1" parent="1">
+          <mxGeometry x="640" y="110" width="160" height="80" as="geometry" />
+        </mxCell>
+
+        <!-- Analysis Engine -->
+        <mxCell id="analyser" value="Analysis Engine&#xa;pandas-ta / ta-lib" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#111827;strokeColor=#818cf8;fontColor=#ffffff;fontSize=11;fontStyle=1;" vertex="1" parent="1">
+          <mxGeometry x="360" y="260" width="200" height="60" as="geometry" />
+        </mxCell>
+
+        <!-- Signal Generator -->
+        <mxCell id="signalgen" value="Signal Generator&#xa;Max 3/day · 30min hold" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1e1b4b;strokeColor=#818cf8;fontColor=#ffffff;fontSize=11;fontStyle=1;" vertex="1" parent="1">
+          <mxGeometry x="360" y="400" width="200" height="60" as="geometry" />
+        </mxCell>
+
+        <!-- News API -->
+        <mxCell id="news" value="Economic Calendar&#xa;Forex Factory / Investing.com" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1a1a2e;strokeColor=#f59e0b;fontColor=#ffffff;fontSize=11;" vertex="1" parent="1">
+          <mxGeometry x="80" y="400" width="200" height="60" as="geometry" />
+        </mxCell>
+
+        <!-- Notifier -->
+        <mxCell id="notifier" value="Notifier&#xa;Discord Webhook" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#111827;strokeColor=#818cf8;fontColor=#ffffff;fontSize=11;fontStyle=1;" vertex="1" parent="1">
+          <mxGeometry x="640" y="400" width="160" height="60" as="geometry" />
+        </mxCell>
+
+        <!-- Discord -->
+        <mxCell id="discord" value="Discord&#xa;Daily Trading Plan" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#1a1a2e;strokeColor=#6366f1;fontColor=#ffffff;fontSize=11;" vertex="1" parent="1">
+          <mxGeometry x="880" y="400" width="160" height="60" as="geometry" />
+        </mxCell>
+
+        <!-- Trader -->
+        <mxCell id="trader" value="👤 Trader&#xa;Manual Execution" style="ellipse;whiteSpace=wrap;html=1;fillColor=#0f172a;strokeColor=#10b981;fontColor=#ffffff;fontSize=11;fontStyle=1;" vertex="1" parent="1">
+          <mxGeometry x="893" y="540" width="140" height="60" as="geometry" />
+        </mxCell>
+
+        <!-- Arrows -->
+        <mxCell id="e1" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;exitX=1;exitY=0.5;entryX=0;entryY=0.5;strokeColor=#6366f1;fontColor=#a5b4fc;fontSize=10;" edge="1" source="api" target="ingestor" parent="1">
+          <mxGeometry relative="1" as="geometry" />
+          <mxCell id="e1l" value="OHLCV" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];" vertex="1" connectable="0" parent="e1"><mxGeometry relative="0.5" as="geometry"/></mxCell>
+        </mxCell>
+        <mxCell id="e2" style="edgeStyle=orthogonalEdgeStyle;rounded=0;strokeColor=#818cf8;fontSize=10;" edge="1" source="ingestor" target="tsdb" parent="1">
+          <mxGeometry relative="1" as="geometry" />
+          <mxCell id="e2l" value="write candles" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;fontSize=10;" vertex="1" connectable="0" parent="e2"><mxGeometry relative="0.5" as="geometry"/></mxCell>
+        </mxCell>
+        <mxCell id="e3" style="edgeStyle=orthogonalEdgeStyle;rounded=0;strokeColor=#818cf8;fontSize=10;" edge="1" source="tsdb" target="analyser" parent="1">
+          <mxGeometry relative="1" as="geometry" />
+          <mxCell id="e3l" value="read candles" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;fontSize=10;" vertex="1" connectable="0" parent="e3"><mxGeometry relative="0.5" as="geometry"/></mxCell>
+        </mxCell>
+        <mxCell id="e4" style="edgeStyle=orthogonalEdgeStyle;rounded=0;strokeColor=#818cf8;fontSize=10;" edge="1" source="analyser" target="signalgen" parent="1">
+          <mxGeometry relative="1" as="geometry" />
+          <mxCell id="e4l" value="scored snapshots" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;fontSize=10;" vertex="1" connectable="0" parent="e4"><mxGeometry relative="0.5" as="geometry"/></mxCell>
+        </mxCell>
+        <mxCell id="e5" style="edgeStyle=orthogonalEdgeStyle;rounded=0;strokeColor=#f59e0b;fontSize=10;" edge="1" source="news" target="signalgen" parent="1">
+          <mxGeometry relative="1" as="geometry" />
+          <mxCell id="e5l" value="news filter" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;fontSize=10;" vertex="1" connectable="0" parent="e5"><mxGeometry relative="0.5" as="geometry"/></mxCell>
+        </mxCell>
+        <mxCell id="e6" style="edgeStyle=orthogonalEdgeStyle;rounded=0;strokeColor=#818cf8;fontSize=10;" edge="1" source="signalgen" target="notifier" parent="1">
+          <mxGeometry relative="1" as="geometry" />
+          <mxCell id="e6l" value="≤3 signals" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;fontSize=10;" vertex="1" connectable="0" parent="e6"><mxGeometry relative="0.5" as="geometry"/></mxCell>
+        </mxCell>
+        <mxCell id="e7" style="edgeStyle=orthogonalEdgeStyle;rounded=0;strokeColor=#6366f1;fontSize=10;" edge="1" source="notifier" target="discord" parent="1">
+          <mxGeometry relative="1" as="geometry" />
+          <mxCell id="e7l" value="daily plan" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;fontSize=10;" vertex="1" connectable="0" parent="e7"><mxGeometry relative="0.5" as="geometry"/></mxCell>
+        </mxCell>
+        <mxCell id="e8" style="edgeStyle=orthogonalEdgeStyle;rounded=0;strokeColor=#10b981;fontSize=10;" edge="1" source="discord" target="trader" parent="1">
+          <mxGeometry relative="1" as="geometry" />
+          <mxCell id="e8l" value="reads signals" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;fontSize=10;" vertex="1" connectable="0" parent="e8"><mxGeometry relative="0.5" as="geometry"/></mxCell>
+        </mxCell>
+      </root>
+    </mxGraphModel>
+  </diagram>
+</mxfile>