The engineering notebook
RSS feed#architecture
Articles, practical guides, and engineering notes on architecture.
By Ashish Bhakhand 108 published articles
Explore the articles
34 articles
Reset filtersMongoDB Behind a Repository Boundary
Keep ObjectIds, query documents, and persistence models out of business logic while preserving the capabilities MongoDB is good at.
Designing API Errors: Public Messages, Internal Causes, and Stable Codes
Give clients predictable errors while preserving the technical evidence operators need to diagnose failures.
Why I Keep Choosing BLoC and Equatable for Production Flutter Apps
How growing Flutter features pushed me from widget-owned state to explicit events, predictable states, and value equality.
Pydantic Is a Boundary, Not Your Entire Domain Model
Separate API schemas, internal domain types, and database rows so each representation serves the job it was designed for.
Keeping Compose Screens Free of Network and Storage Work
Let composables describe UI while ViewModels and repositories own effects, retries, and persistence.
Thin FastAPI Routers: What Belongs in an Endpoint?
Use routes as typed HTTP adapters while services own decisions, transactions, and orchestration.
Splitting Large TCA Features Without Losing the State Flow
Separate state, actions, reducer logic, and child domains while keeping one understandable feature contract.
How I Structure a Large FastAPI Backend with Vertical Slices
Organize FastAPI around business capabilities so routes, services, schemas, persistence, and rules evolve together.
One Client Boundary per Feature in TCA
Give reducers a small capability-based dependency while network, persistence, and caching remain implementation details.