homelab-design

Author	SHA1	Message	Date
Billy D.	5e9f589311	docs(adr): update ADR-0022 to use Go with hot reload - Switch from Python to Go for smaller images (~10MB vs ~150MB) - Add fsnotify for hot reload of secrets without pod restart - Update status from Proposed to Accepted - Add Prometheus metrics endpoint - Update resource limits (32Mi vs 128Mi) - Mark repository creation as complete	2026-02-02 17:49:34 -05:00
Billy D.	add1b5b71e	docs(adr): ADR-0023 Valkey for ML inference caching Document decision to consolidate mlcache into single valkey instance. Includes future guidance for vLLM KV-cache offloading integration.	2026-02-02 17:30:08 -05:00
Billy D.	e85deaa642	docs(adr): finalize ADR-0021 and add ADR-0022 ADR-0021 (Accepted): - ntfy as central notification hub - Alertmanager integration for critical/warning alerts - Service readiness notifications via Flux notification-controller - Standardized topic naming ADR-0022 (Proposed): - ntfy-discord-bridge Python service design - SSE subscription with reconnection logic - Message transformation to Discord embeds - Priority/tag to color/emoji mapping - Kubernetes deployment with ExternalSecret for webhook	2026-02-02 11:58:52 -05:00
Billy D.	7b77d6c29f	docs(adr): ADR-0021 notification architecture - Define ntfy as central notification hub - Standardize topic naming (gitea-ci, alertmanager-alerts, etc.) - Document Alertmanager integration - Design ntfy-to-Discord bridge architecture (future work)	2026-02-02 11:54:08 -05:00
Billy D.	09cc796417	docs: ADR-0020 internal registry URLs for CI/CD Document decision to use registry.lab.daviestechlabs.io for artifact uploads to bypass Cloudflare 100MB limit.	2026-02-02 11:19:16 -05:00
Billy D.	37b18dad08	accept: ADR-0019 handler deployment strategy	2026-02-02 09:14:33 -05:00
Billy D.	d790aa31eb	docs: add ruff linting/formatting conventions for Python repos	2026-02-02 08:45:33 -05:00
Billy D.	a2a426eb3b	docs: add ADR-0015 for CI notifications and semantic versioning	2026-02-02 08:00:18 -05:00
Billy D.	730ab32b5d	docs: add ADR-0014 for Docker build best practices Documents standardized Docker patterns: - BuildKit syntax 1.7 with cache mounts - uv for Python package installation (10-100x faster) - OCI Image Spec labels - HEALTHCHECK directives - Non-root execution - Version pinning with ranges Complements ADR-0012 (uv) and ADR-0013 (CI/CD)	2026-02-02 07:26:43 -05:00
Billy D.	5ba8138719	docs: add ADR-0013 for Gitea Actions CI/CD	2026-02-02 07:15:48 -05:00
Billy D.	598875c5a9	docs: add ADR-0011 (KubeRay), ADR-0012 (uv), update architecture docs	2026-02-02 07:10:47 -05:00
Billy D.	b6f7605fab	docs: Update for decomposed repo structure - AGENT-ONBOARDING: New repo map with daviestechlabs Gitea repos - TECH-STACK: Reference handler-base instead of llm-workflows - CODING-CONVENTIONS: Update project structure for new repos - ADR 0006: Update GitRepository examples for Gitea repos llm-workflows has been split into: - handler-base, chat-handler, voice-assistant - kuberay-images, argo, kubeflow, mlflow, gradio-ui	2026-02-02 05:58:35 -05:00
Billy D.	832cda34bd	feat: add comprehensive architecture documentation - Add AGENT-ONBOARDING.md for AI agents - Add ARCHITECTURE.md with full system overview - Add TECH-STACK.md with complete technology inventory - Add DOMAIN-MODEL.md with entities and bounded contexts - Add CODING-CONVENTIONS.md with patterns and practices - Add GLOSSARY.md with terminology reference - Add C4 diagrams (Context and Container levels) - Add 10 ADRs documenting key decisions: - Talos Linux, NATS, MessagePack, Multi-GPU strategy - GitOps with Flux, KServe, Milvus, Dual workflow engines - Envoy Gateway - Add specs directory with JetStream configuration - Add diagrams for GPU allocation and data flows Based on analysis of homelab-k8s2 and llm-workflows repositories and kubectl cluster-info dump data.	2026-02-01 14:30:05 -05:00
Billy Davies	4d4f6f464c	Initial commit	2026-02-01 19:16:18 +00:00

14 Commits