Writing

Writing on AI, cloud and tech leadership.

Notes from the build: leadership lessons, architecture decisions, building FinMoon AI, and experiments from my home lab. I write them down so the next person (often me) doesn’t have to relearn them.

Series

Enterprise MVP, end to end

One illustrative enterprise MVP, from the first stakeholder workshop to production on Google Cloud: requirements, architecture, database design, development with Flask and React, CI/CD with Cloud Build and Cloud Deploy, and choosing between GKE and Cloud Run.

  1. Part 14 min read

    Enterprise MVP, end to end: from the first workshop to production

    The map for a seven-part series: how I take an enterprise MVP from requirements gathering through architecture, database design, development, CI/CD and deployment on Google Cloud, and the artefact each phase must leave behind.

  2. Part 25 min read

    Requirements gathering for an enterprise MVP: what to ask, what to write down

    How I run discovery for an enterprise MVP: mapping stakeholders, running process workshops, writing user stories with testable acceptance criteria, and pinning down the non-functional requirements that decide the architecture.

  3. Part 34 min read

    Architecture design for an enterprise MVP: C4 diagrams, a modular monolith and the seams that matter

    Turning signed-off requirements into an architecture: C4 context and container diagrams, a Flask modular monolith on Google Cloud, asynchronous ERP integration with an outbox, and architecture decision records that explain the why.

  4. Part 45 min read

    Database design for an enterprise MVP: from domain model to the first PostgreSQL migration

    How I design the database for an enterprise MVP in PostgreSQL: deriving entities from the workflow, choosing keys, enums versus lookup tables, where jsonb belongs, an append-only audit log, an outbox table, and versioned migrations with SQLAlchemy and Alembic.

  5. Part 54 min read

    Developing an enterprise MVP with Flask and React: structure, workflow and tests

    How the build phase of an enterprise MVP runs: a monorepo with a Flask API and a React frontend, contract-first endpoints with generated TypeScript types, the approval workflow as an explicit state machine, tests that hit a real PostgreSQL, and a working demo every week.

  6. Part 65 min read

    CI/CD for an enterprise MVP: GitHub to Cloud Build to Cloud Deploy

    A complete delivery pipeline on Google Cloud: Cloud Build triggers from GitHub for pull requests and merges, images in Artifact Registry, Cloud Deploy releases promoted from dev to staging to production with an approval gate, database migrations as a predeploy hook, and one-command rollback.

  7. Part 78 min read

    GKE or Cloud Run? Choosing where an enterprise MVP runs, and the go-live checklist

    How to decide between serverless Cloud Run and GKE workloads on Google Cloud: traffic shape, cost model, operational burden, team skills and hard limits, with a decision flowchart, both deployment topologies, how the Cloud Deploy pipeline changes, and the checklist I use before go-live.