update docs

This commit is contained in:
2026-03-16 13:32:49 -03:00
parent 91f95d55a5
commit 0f60556e81
9 changed files with 495 additions and 494 deletions

View File

@@ -80,39 +80,6 @@
</header>
<main>
<!-- Explainer Articles -->
<section class="nav-section">
<h2>Explainer Articles</h2>
<div class="doc-links">
<a
href="explainer/viewer.html?file=sysmonstm-from-start-to-finish.md"
class="doc-link"
>
<h3>sysmonstm: From Start to Finish</h3>
<p>
The complete story of building this monitoring
platform. Architecture decisions, trade-offs, and
code walkthrough from MVP to production patterns.
</p>
<span class="tag">Article</span>
</a>
<a
href="explainer/viewer.html?file=other-applications.md"
class="doc-link"
>
<h3>Same Patterns, Different Domains</h3>
<p>
How the same architecture applies to payment
processing systems and the Deskmeter workspace
timer. Domain mapping and implementation paths.
</p>
<span class="tag">Article</span>
</a>
</div>
</section>
<hr class="section-divider" />
<!-- Architecture Diagrams -->
<section class="graph-section" id="overview">
<div class="graph-header-row">
@@ -155,6 +122,11 @@
<strong>Alerts</strong>: Subscribes to events,
evaluates thresholds, triggers actions
</li>
<li>
<strong>Edge</strong>: Lightweight WebSocket
relay on AWS, serves public dashboard at
sysmonstm.mcrn.ar
</li>
</ul>
</div>
</section>
@@ -245,16 +217,17 @@
<h4>Environments</h4>
<ul>
<li>
<strong>Local Dev</strong>: Kind + Tilt for K8s, or
Docker Compose
<strong>Local</strong>: Docker Compose with
aggregator, gateway, Redis, TimescaleDB, alerts
</li>
<li>
<strong>Demo (EC2)</strong>: Docker Compose on
t2.small at sysmonstm.mcrn.ar
<strong>Edge (AWS)</strong>: Lightweight
WebSocket relay at sysmonstm.mcrn.ar, receives
forwarded metrics from local gateway
</li>
<li>
<strong>Lambda Pipeline</strong>: SQS-triggered
aggregation for data processing experience
<strong>Collectors</strong>: Run on remote
machines, stream to local aggregator via gRPC
</li>
</ul>
</div>
@@ -301,7 +274,7 @@
<hr class="section-divider" />
<section class="findings-section">
<h2>Interview Talking Points</h2>
<h2>Key Design Decisions</h2>
<div class="findings-grid">
<article class="finding-card">
<h3>Domain Mapping</h3>
@@ -366,16 +339,13 @@
<h3>Infrastructure</h3>
<ul>
<li>Docker</li>
<li>Kubernetes</li>
<li>Kind + Tilt</li>
<li>Terraform</li>
<li>Docker Compose</li>
</ul>
</div>
<div class="tech-column">
<h3>CI/CD</h3>
<ul>
<li>Woodpecker CI</li>
<li>Kustomize</li>
<li>Container Registry</li>
</ul>
</div>
@@ -386,7 +356,7 @@
<footer>
<p>System Monitoring Platform - Documentation</p>
<p class="date">
Generated: <time datetime="2025-12-31">December 2025</time>
Generated: <time datetime="2026-03-16">March 2026</time>
</p>
</footer>
</body>