Etiqueta
#architecture
9 articulos
code
December 15, 2025
Part 1/3: Chat with Your PDFs Locally
Build a local PDF chat app that extracts text, indexes it in a vector database, and answers questions with document, section, and page references. Includes runnable code and a Makefile.
code
November 15, 2025
Build Your AI Development Workspace with OpenCode and OpenSpec
A practical introduction to OpenCode, OpenSpec, AGENTS.md, custom agents, and skills, using one small API change to show what each piece does.
code
August 15, 2025
Spec-Driven Development with OpenSpec: From Vague Request to Verifiable Change
A practical OpenSpec walkthrough: clarify an order-cancellation request, write behavior as scenarios, make design decisions, implement with AI, and revise the spec when reality changes.
code
June 15, 2025
Transactional Outbox: Saving State Without Losing Events
Understand the database-and-broker dual-write problem, implement a transactional outbox, and handle delivery retries, duplicate events, ordering, and recovery.
code
May 15, 2025
Your API Needs an Evolution Strategy
A practical guide to evolving public APIs: compatibility, version selection, client migration, deprecation, contract testing, and safe rollback.
code
March 15, 2025
Relational vs. NoSQL Databases: Why PostgreSQL Is My Default
Lessons from using MySQL, PostgreSQL, and MongoDB, including schema evolution, data consistency, and why database-side event logic deserves caution.
code
February 15, 2025
The Hidden Cost of Event-Driven Architectures
A practical look at the operational and design trade-offs behind event-driven architectures, from observability and schema evolution to retries, ordering, and ownership.
code
February 15, 2024
Common Mistakes When Developing Microservices
A guide on the most frequent mistakes made when developing microservices, with practical examples.
code
October 2, 2023
Introduction to Hexagonal Architecture
Introduction to Hexagonal Architecture