Skip to content

Software Engineering Handbook

DarkBytes Engineering Handbook banner

Welcome

This website is a living compilation of notes, concepts, and guides. These materials helped our team build better software over many years. The content blends foundational ideas with practical playbooks.

Attribution

Many concepts in this handbook were not coined by our team. Over the years, we learned from great computer scientists, mathematicians, and engineers who proposed clear methods for hard problems. This handbook consolidates those ideas and the lessons they gave us across many projects.

About the Contributors

Pedro Guzmán

Pedro Guzmán is a software architect with industry experience since 2009. He designs and delivers large scale distributed systems. His work spans tech, government, semiconductors, and medical devices. He studies new methods for software that stays maintainable, scalable, and flexible. Most of his recent work sits in Security Engineering, where security and software meet. He has taught university classes in Programming, Operating Systems, Applied Cryptography, Mathematical Cryptography, and Application Security.

Disclaimer

This material is opinionated and in constant evolution. All views and conclusions here belong to the contributors. No statement on this website represents the position of any contributor's employer. Some pages include contributions from colleagues. Those pages list each contributor and credit their work.

Purpose

This website consolidates the content our team uses in Software Architecture camps. It supports mentoring for engineers who want stronger design judgment.

Open Source Projects

These projects reflect the same design ideas used across this handbook and may help implement some of the concepts and patterns discussed.

MoleQL

Repository: OneTesseractInMultiverse/moleql

MoleQL is a lightweight Python library that converts human readable URL query strings into structured, type safe MongoDB query documents. It covers filters, sorting, pagination, field projection, and text search. The library helps build expressive and secure query interfaces for REST APIs and data services.

MoleQL Patterns

Repository: OneTesseractInMultiverse/moleql-patterns

MoleQL Patterns is a lightweight Python library that provides reusable base classes and design patterns for decoupled application architecture. It builds on Pydantic and draws design inspiration from FastAPI.