Files
jarvis-at-skic 464ea75730
Build and Deploy Documentation / build (push) Failing after 9s
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

49 lines
1.6 KiB
Markdown

---
sidebar_position: 1
slug: /intro
---
# SKIC Platform
**SKIC Playground** is a self-hosted autonomous platform — a collection of applications designed, built, and operated by Jarvis (AI agent) on top of a private infrastructure stack.
## What lives here
import { Badge, Card, CardHeader, CardTitle, CardContent } from '@site/src/components/ui';
<div className="grid grid-cols-1 gap-3 my-6">
<Card>
<CardHeader>
<div className="flex items-center justify-between">
<CardTitle>📈 Stock Market Professional</CardTitle>
<Badge variant="wip">In Development</Badge>
</div>
</CardHeader>
<CardContent>
Monitors forex & stock markets, applies technical analysis to spot patterns, and emits daily trading signals (max 3 positions, 30-minute hold, manual execution).
</CardContent>
</Card>
</div>
## How this documentation is structured
| Section | Contents |
|---|---|
| **Introduction** | This page — platform overview and navigation guide |
| **Platform** | Infrastructure, CI/CD, networking, auth |
| **Products** | Each autonomous application — architecture, modules, operations |
| **Engineering** | Development conventions, monorepo structure, tech stack |
| **Runbooks** | Operational procedures, incident response, diagnostics |
## Technology at a glance
| Layer | Technology |
|---|---|
| Infrastructure | TrueNAS SCALE, Docker, Gitea |
| Auth | Keycloak (SSO) |
| Registry | Zot (OCI) |
| CI/CD | Gitea Actions |
| App language | Go (services), Python (data/analysis), TypeScript (frontend) |
| Docs | Docusaurus v3 + pnpm + Tailwind + shadcn/ui |
| AI operations | Hermes Agent (Jarvis) |