From 2f17ad25e32e4609cd7ca26a8561f1b059438a36 Mon Sep 17 00:00:00 2001 From: "Mark Wendell M. Aquino" Date: Sun, 19 Jul 2026 04:23:05 +0800 Subject: [PATCH] docs(checkpoint): added readme for mental-models project transitions --- .gitignore | 2 +- .../mental-model-project-transitions.md | 247 ++++++++++++++++++ 2 files changed, 248 insertions(+), 1 deletion(-) create mode 100644 mental-models/mental-model-project-transitions.md diff --git a/.gitignore b/.gitignore index 45db95c..1bcd7a7 100644 --- a/.gitignore +++ b/.gitignore @@ -20,4 +20,4 @@ Thumbs.db .vscode/ # Coverage -coverage/ \ No newline at end of file +coverage/ diff --git a/mental-models/mental-model-project-transitions.md b/mental-models/mental-model-project-transitions.md new file mode 100644 index 0000000..63c1743 --- /dev/null +++ b/mental-models/mental-model-project-transitions.md @@ -0,0 +1,247 @@ +# 🧠 Mental Model: Project Transitions + +> The goal of this roadmap is not to learn technologies in isolation, but to understand how they connect to build secure, observable, and production-ready systems. + +As the projects become more complex, the focus shifts from learning individual tools to understanding how entire systems operate in real-world environments. + +--- + +# 📈 Learning Progression + +| Project | Main Focus | What Comes Back | +| ------------------------------------- | ------------------------ | ---------------------------------------------------------------------------- | +| **DevSecOps-Learning-Lab** | Learn the tools | Docker, CI/CD, Trivy, Nginx, HTTPS, monitoring | +| **Secured-Payment-Paymongo-Practice** | Security and payments | Secrets, webhooks, OWASP, HTTPS, audit logs | +| **DevOps-War-Room** | Real-time infrastructure | WebSockets, observability, Grafana, Prometheus, load testing | +| **Sentinel-Core** | Production-grade systems | Distributed systems, queues, event-driven architecture, monitoring, security | + +--- + +# 🔄 The Transition Between Projects + +Each project builds on the previous one. + +The purpose is not: + +```text +Learn Docker. +Finish Docker. +Forget Docker. + +Learn monitoring. +Finish monitoring. +Forget monitoring. +``` + +The actual progression looks like this: + +```text +DevSecOps-Learning-Lab + ↓ +Secured-Payment-Paymongo-Practice + ↓ +DevOps-War-Room + ↓ +Sentinel-Core +``` + +Every new project introduces additional complexity while reusing concepts learned in earlier stages. + +--- + +# 🔧 Phase 1 — Learning Individual Tools + +## DevSecOps-Learning-Lab + +This project focuses on understanding the fundamentals: + +- Linux +- Git and GitHub +- Docker and Docker Compose +- CI/CD pipelines +- Static and dynamic security testing +- Reverse proxies +- HTTPS and certificates +- Secrets management +- Logging and observability + +### Core question: + +> "How does each tool work?" + +--- + +# 🔐 Phase 2 — Security in Real Applications + +## Secured-Payment-Paymongo-Practice + +This project introduces production concerns around financial systems. + +Concepts that return: + +- Environment variables +- API security +- Webhooks +- Signature verification +- HTTPS +- Audit logging +- OWASP practices +- Secure deployment + +### Core question: + +> "How do we protect sensitive workflows?" + +--- + +# 📡 Phase 3 — Operating Real-Time Systems + +## DevOps-War-Room + +This project focuses on systems that continuously exchange information. + +Concepts that return: + +- WebSockets +- Health checks +- Logging +- Prometheus +- Grafana +- Metrics collection +- Load testing +- Container orchestration + +### New questions: + +- How many users are connected? +- Which server is overloaded? +- How much memory is being used? +- How can failures be detected in real time? + +--- + +# 🚀 Phase 4 — Production-Grade Architecture + +## Sentinel-Core + +This project moves beyond individual services and explores distributed systems. + +Concepts that return: + +- Background workers +- Event queues +- Event-driven architecture +- Retry mechanisms +- Observability +- Security +- Monitoring +- Scalability + +### New questions: + +- Which worker processed the event? +- How long did processing take? +- Where did the failure occur? +- How many retries happened? +- What is the system bottleneck? + +--- + +# 🏗️ Evolution of Monitoring + +Monitoring evolves as the projects evolve. + +### In the learning lab: + +```text +Application + ↓ +Logs + ↓ +Prometheus + ↓ +Grafana +``` + +Focus: + +- Is the application healthy? +- Are requests arriving? +- What metrics are available? + +--- + +### In DevOps-War-Room: + +```text +Users + ↓ +WebSocket Server + ↓ +Metrics + ↓ +Dashboards +``` + +Focus: + +- Active connections +- Throughput +- Latency +- Resource consumption + +--- + +### In Sentinel-Core: + +```text +API + ↓ +Queue + ↓ +Worker + ↓ +Database +``` + +Focus: + +- Event processing +- Retries +- Failures +- System bottlenecks + +--- + +# 🎯 The Real Goal + +The objective of these projects is not simply to accumulate technologies. + +The objective is to develop the ability to answer questions such as: + +- What happens when a request enters the system? +- How do services communicate? +- How are failures detected? +- How are systems secured? +- How can engineers observe production behavior? +- How do systems scale? + +--- + +# 💡 Final Mental Model + +```text +Tools + ↓ +Applications + ↓ +Infrastructure + ↓ +Distributed Systems + ↓ +Production Thinking +``` + +Learning technologies is the beginning. + +Understanding how they work together is the real destination.