// SYSTEM_ARCHITECTURE_TOPOLOGY|BLUEPRINT V2.5

>SYSTEM ARCHITECTURE

Exploration of technical topology: from user interaction to continuous deployment pipeline.

STATUS: OPERATIONAL HOST: LINUX SERVER VPS
// ARCHITECTURE_SEGMENT_01

> USER INTERACTION & WEB DELIVERY TOPOLOGY

Lifecycle of a web request: from client browser through Cloudflare and Nginx down to Nuxt 4.

[CLIENT_&_AUDIO] CLIENT_RUNTIME

1. Client Web Audio API & Media Integrations

The application runs in the user's browser with progressive Vue 3 DOM hydration. The HTML5 audio player leverages the Web Audio API and directly queries public Deezer, Apple Music/iTunes, and YouTube endpoints to retrieve high-definition album artwork and real-time metadata, playing streamed audio delivered in chunks by the server.

VUE 3 // PWA // DEEZER APICLIENT_BOUND
[CLOUDFLARE_PROXY] REVERSE_PROXY_CACHE

2. Cloudflare Reverse Proxy & Edge CDN Cache

Cloudflare acts as a fronting reverse proxy between the visitor and the origin host. It intercepts all public web traffic, completely conceals the origin server's real IP address, and serves static assets from its global edge cache to maximize delivery speed.

ANYCAST PROXY // CDN CACHE // BROTLIPROXIED
[CLOUDFLARE_WAF] L3/L4/L7_FILTERING

3. Edge WAF, Anti-DDoS & OWASP Ruleset

Cloudflare inspects all ingress packets. Volumetric attacks (SYN/UDP flood) and application-layer threats (HTTP flood, SQLi, XSS) are attenuated at the edge. IP reputation checks and Geo-IP filtering stop malicious automated scrapers.

MANAGED RULESET // RATE LIMITPROTECTED
[CLOUDFLARE_SSL] FULL_STRICT_TLS

4. SSL/TLS 1.3 Termination & Edge CDN

TLS 1.3 cryptographic handshakes terminate on the Cloudflare point of presence closest to the visitor. Static assets, fonts, and icons are served from edge cache with Brotli compression, keeping global latency under 25 milliseconds.

BROTLI // EDGE CACHE // AOPENCRYPTED
[NGINX_REVERSE_PROXY] PORT_443_ONLY

5. Host Nginx Gateway & Origin Isolation

Only TCP port 443 is exposed to the outside on the Linux server host. Nginx terminates Cloudflare Authenticated Origin Pulls, forwards real visitor IP headers (CF-Connecting-IP), and reverse-proxies requests over private loopback port 3000 to Docker.

PORT 443 -> LOCAL 3000 // LINUX SERVERISOLATED
[NUXT4_NITRO_CORE] SSR_&_APIS

6. Nuxt 4 Nitro SSR Engine & Secure Relays

The Nitro engine performs server-side rendering and handles API routes. Sensitive operations (Breach Protocol anti-spam, DNS MX email checks, NVIDIA NIM AI inference, and Telegram alert relays) are sealed and executed server-side without exposing API keys to the client.

NVIDIA NIM // TELEGRAM API // SWROPERATIONAL
// ARCHITECTURE_SEGMENT_02

> CI/CD & GITOPS DEPLOYMENT PIPELINE

Automated Zero-Trust pipeline: cloud build, HMAC validation, and zero-downtime rollover.

[DEV_TRIGGER] GPG_COMMITS

1. Developer Push with Signed Commits

The developer pushes cryptographically signed Git commits to the GitHub repository main branch. This commit push serves as the sovereign, immutable trigger for the entire continuous delivery pipeline.

GIT OVER SSH // ED25519SOVEREIGN
[CI_PIPELINE] MULTI_STAGE_DOCKER

2. Multi-Stage Docker CI Pipeline

The GitHub Actions cloud runner runs unit tests and TypeScript linting. On success, it builds a multi-stage Docker image: a builder stage compiles the code, and an ultra-lean Alpine runner stage copies only the Nitro binary, stripping npm to shrink attack surface.

NODE 24 ALPINE // NO-NPM RUNNERMINIFIED
[CONTAINER_REGISTRY] CONDITIONAL_DISPATCH

3. GHCR Registry & Conditional Dispatch

If and only if all tests pass and build succeeds, the verified image is published to GitHub Container Registry (GHCR) tagged with the commit SHA. This verified artifact state triggers the automated update notification to the server.

ghcr.io/ardou0/website:shaIMMUTABLE
[SECURE_WEBHOOK] CONSTANT_TIME_CHECK

4. HMAC-SHA256 Webhook & Constant-Time Check

GitHub Actions dispatches an HTTPS POST request to /api/deploy-webhook signed with a strong shared secret. The Nitro backend validates the payload using crypto.timingSafeEqual in constant time, neutralizing timing attacks and tampering.

HMAC-SHA256 // crypto.timingSafeEqualVERIFIED
[DEPLOYER_DAEMON] ANTI_RCE_VOLUME

5. Zero-Trust Flag IPC (Anti-RCE Buffer)

The web container operates with zero root privileges, no shell access, and no Docker socket mounts. Once the HMAC signature is verified, it touches an empty pending.flag file in a shared volume, eliminating web-to-host RCE attack vectors.

/deploy-flags/pending.flag // NON-ROOTSECURED
[ZERO_TRUST_PROD] ZERO_DOWNTIME

6. Autonomous Deployer & Auto-Rollback

The isolated website_deployer daemon detects the flag, pulls the new image from GHCR, and hot-swaps the container without downtime. It polls /api/health for 10 seconds, immediately rolling back to the previous healthy container if checks fail.

DOCKER DOOD // HEALTHCHECK PROBEAUTOMATED
// ARCHITECTURE_SEGMENT_03

> SECURITY MATRIX & ZERO-TRUST PRINCIPLES

Defensive hardening implemented to guarantee runtime integrity, isolation, and resilience.

[VPS_HARDENING] NON_ROOT_PRIVILEGE

1. Linux Host Hardening & OS Isolation

The application runs strictly under the unprivileged node user, preventing host escalation or runtime container modifications in the event of an intrusion.

NODE:NODE // LINUX VPS // NO-ROOTENFORCED
[CONTAINER_DEFENSE] ISOLATED_DOOD_BUFFER

2. Isolated IPC Buffer & No Web Shell

System updates are communicated exclusively through a signal file in a shared volume, making remote shell code execution from the web impossible.

FILE SIGNAL // ZERO SOCKET MOUNTISOLATED
[TLS_PROXIES] TIMING_SAFE_SIGNALS

3. Constant-Time HMAC Signature Check

All webhook deployment cryptographic signatures are compared in constant time, preventing side-channel and timing-based forge attempts.

CRYPTO.TIMINGSAFEEQUAL // SHA256SECURED
[HMAC_INTEGRITY] AUTOMATED_RESILIENCE

4. Automated Synthetic Healthcheck & Rollback

Continuous post-deployment synthetic monitoring with immediate automatic reversion to the previous known-good image on error.

10S PROBE // AUTO ROLLBACKACTIVE
[TELEMETRY_MONITOR] TELEMETRY_MONITORING

5. Real-Time Telemetry & Alert Relays

Host system health, deployment events, and security logs are continuously monitored and dispatched to Telegram alert channels.

TELEGRAM BOT // INTERNAL TELEMETRYMONITORED
[CVE_PATCHING] CVE_INTEGRITY_CHECK

6. Automated Vulnerability & CVE Patching

Container base images and node dependencies are routinely rebuilt and patched against newly disclosed CVE security advisories.

GHCR REBUILD // SECURITY AUDITPATCHED
01. CLIENT ▾
[+]