Loading…
Le Manuel d'ingénierie
Comment c'est réellement construit.
Pas du marketing — de la documentation. Des diagrammes d'architecture vivants, les véritables flux d'intégration et les décisions qui les sous-tendent. Tout ici reflète des systèmes qui existent, tirés des journaux de build des produits eux-mêmes. Mettez-le à l'épreuve.
.jpg&w=3840&q=75)
Vue conteneur
Ce site, en tant que système
mirembemuse.co.za est une application Next.js 15 sur Vercel. Chaque route publique /api/* est protégée par Arcjet et la limitation de débit Upstash ; les données et l'authentification résident dans Supabase (Postgres avec sécurité au niveau des lignes) ; l'assistant diffuse en streaming depuis Claude ; les paiements passent par PayFast (local et international) ; et un moteur privé, JarvisOS, n'est atteint que via des webhooks signés — jamais une base de données partagée.
Les flèches pleines sont des chemins de requête ; les flèches en pointillés sont des rappels asynchrones et signés (PayFast ITN, webhooks JarvisOS). Le nœud moteur est grisé car il s'agit d'un projet distinct et isolé, exposé uniquement via des webhooks.
.jpg&w=3840&q=75)
Flux d'intégration
Un stock fidèle, sur deux systèmes
Une boucle réelle, câblée de bout en bout : lorsqu'une personne achète sur la boutique Sanyu Botanicals, l'inventaire est décrémenté dans le moteur privé et resynchronisé — de sorte que la vitrine ne survend jamais. Deux webhooks, deux schémas d'authentification distincts, une protection contre le rejeu de cinq minutes, et une absence d'effet gracieuse si les secrets ne sont pas définis (le paiement ne casse jamais).
En sortie (Store→Engine), l'authentification se fait avec une clé Bearer plus un HMAC-SHA256 du corps ; en entrée (Engine→Store), la signature porte sur timestamp.body avec une fenêtre de rejeu de cinq minutes. JarvisOS est l'unique source de vérité pour le stock de produits finis.
.jpg&w=3840&q=75)
Plongées en profondeur produit
Spécifications d'ingénierie, par produit
Chaque spécification possède son propre diagramme d'architecture, sa stack réelle, l'échelle de son schéma, les décisions qui la sous-tendent (façon ADR) et les parties difficiles — tirées directement des journaux de build de ce produit.
VarsityOS
An AI "Student Operating System" for South African students — study planning, NSFAS budgeting, wellness and careers around an AI chief-of-staff, Nova.
Next.js 14 (App Router, RSC) · React 18 · TypeScript (strict)AdminOS
A WhatsApp-native, multi-tenant business OS for South African SMEs — the interface is the customer’s existing WhatsApp line, not a dashboard.
Next.js 16 (App Router) · React 19 · TypeScriptK53 Drill Master
An offline-first K53 learner's-licence drill PWA — 600+ DLTC-format questions in English, Afrikaans and isiXhosa, built for budget Android on 3G.
React 18 + Vite · Framer Motion · Supabase (auth + Edge Functions)Sanyu Botanicals
An editorial e-commerce storefront for botanical hair care — with an AI hair chatbot, an "Angel" loyalty portal, and a live two-way inventory sync to the private engine.
Next.js 14 (App Router) · TypeScript · SupabaseThe Selves of Us
A premium digital literary magazine + podcast platform — explicitly anti-AI-generated-content, with a real-time multi-role editorial workflow.
Next.js 15 · React 19 · TypeScriptTrue Access
South Africa’s first community accessibility-mapping platform — disabled people discover and rate accessible spaces; businesses get SANS 10400-S compliance scoring. One codebase for iOS, Android and Web.
Expo SDK 52 (Expo Router) · React Native 0.76 · TypeScriptStokvelOS
AI-powered management for South African stokvels — members transact entirely over WhatsApp in their own language, every transaction is immutable, and records mirror to a read-only Notion workspace for full transparency.
Next.js 16 (App Router) · React 18 · TypeScriptWatchSankofa
A pan-African creative-content streaming platform — film, music, poetry, writing and photography — built mobile-first for African connectivity realities, with Claude-powered discovery.
Next.js 16 (App Router, Turbopack) · TypeScript (strict) · Supabase (Postgres + RLS + Realtime).jpg&w=3840&q=75)
Le manuel
Où approfondir
Architecture système
La vue à système unique — moteur, flotte, ce site, et comment ils se connectent.
En ligneDécisions d'ingénierie
Pourquoi nous l'avons construit ainsi — à travers les prismes métier, ingénierie et humain.
En ligneThe Observatory
Le studio à ciel ouvert — flux de commits en direct et les systèmes en fonctionnement.
En lignePlongées en profondeur produit
Études de cas techniques par produit : stack, schéma, les parties difficiles résolues.
En ligneRegistres de décisions (ADRs)
Décisions d'architecture numérotées et datées — contexte, choix, conséquence.
En ligneDonnées & Schéma
Tranches de schéma réelles et dictionnaires de données issus des bases de production.
En ligneRunbooks
Procédures de déploiement, de restauration, de réponse aux incidents et de remise en main propre.
En ligneSécurité & Confiance
RLS, webhooks signés, limitation de débit, POPIA/PAIA — les contrôles en termes simples.
En ligne.jpg&w=3840&q=75)
Vous voulez cette rigueur sur votre projet ?
La même discipline de documentation accompagne chaque système client — vous possédez le code, le schéma et les runbooks.