index

Learning

A personal knowledge base of deep-dive engineering notes — written to understand systems from first principles, not just to use them. Each topic is broken down session by session, building intuition from the ground up.

Contents

bridgeonline/ — Building a real-time multiplayer Bridge game

A session-by-session developer guide covering the design and implementation of BridgeOnline: a four-player, real-time Contract Bridge web app. The notes trace the whole system — domain logic, real-time sync, persistence, voice, testing, and the bugs found along the way.

Module	Topic
00 — Project Overview	What the app is and why it’s worth studying
01 — Architecture & Design	How the system fits together
02 — Game Logic as Pure Functions	Bridge rules and DSA inside the engine
03 — Database Design with Prisma	Schema, FK constraints, ORMs
04 — Real-Time with Socket.io	Events, rooms, pub-sub, state sync
05 — Testing Strategy	Unit → Integration → E2E
06 — WebRTC & Voice Chat	P2P, SDP, ICE, mesh topology
07 — Scalability	Redis, queues, reconnection, observability
08 — TypeScript & Next.js Patterns	Async params, Prisma JSON, enum narrowing
09 — Game State Bugs & Defensive Coding	Guard clauses, spec tests, API testing
10 — E2E, Playwright & Node.js 24	webServer env, CDP, multi-browser contexts
11 — Full Game Simulation & Play-Route Bugs	End-to-end play debugging
12 — Turn Order Fix & Passed-Out UI	Turn order, passed-out hand handling

cloud/ — Cloud computing & Kubernetes from first principles

Notes on the mental models, architecture, and mechanics of modern cloud computing.

• basic_learning.md — Cloud from first principles to production
• MentalModels/ — Utility model, statistical multiplexing, virtualization, fault tolerance, networking, elasticity, cost
• Architecture/ — Global infra, compute, storage, networking, load balancing, databases, serverless, containers, security, observability
• kubernetes/ — The ladder from kernel → OS → VM → Docker → Kubernetes

How these notes are written

Each document explains why a thing exists before how it works, builds on the previous one, and assumes strong DSA fundamentals. DOUBTS.md files capture open questions worth revisiting.