A reference Todo List app that serves as a showcase for implementing lightweight microservices in Golang
Quanta is a Todo List application that prioritizes simplicity and a streamlined approach to building services. It offers insights into constructing services that embrace CQRS, tailored to the needs of smaller systems. The codebase is organized and designed to facilitate the development of CQRS-based solutions, while also allowing for the incorporation of traditional REST architecture when necessary, without dogmatically discarding it for specific use cases.
-
Lightweight: Quanta focuses on simplicity and an organized, smaller codebase compared to the more extensive approach of Martello. It provides a clear and concise structure for building microservices with a strong emphasis on CQRS principles without strongly advancing other DDD concepts.
-
HTTP and gRPC Communication: HTTP is primarily used for client-service communication, utilizing either CQRS (GET and POST) or REST when it proves to be more convenient. On the other hand, gRPC is employed for efficient and performant communication between services within the microservices architecture.
-
Optional NATS Integration: Quanta includes a simple event dispatcher as a reference implementation, utilizing NATS for hypothetical microservices within the orchestration. However, the use of NATS is not required for the core functionality of the app. It serves as a demonstration of event-driven architecture, where other hypothetical services, not implemented here, can consume these events. (*)
(*) Please note that Quanta serves as a reference implementation for a future generator. A flag in the generator will enable the inclusion of the necessary functionality to operate with NATS, allowing developers to customize and adapt the event bus integration as needed.
To achieve our goals of materializing aggregate projections in a lightweight manner, we evaluate two approaches:
-
Projection Handlers: This approach involves using projection handlers to trigger the materialization of aggregate projections. We can consider both synchronous and asynchronous implementations, carefully assessing the trade-offs for our specific requirements.
-
Parallel Processors: The second approach explores the use of parallel processors to determine the optimal timing for creating aggregate projections. These processors analyze the event stream or command flow, taking into account factors such as event types, time intervals, or system load, to initiate projection materialization.
We aim to avoid a heavy event processor solution based on queues, event stores, or messaging platforms, opting for a simplified and efficient implementation.
A list of Architectural Decision Records here
Please note that the exploration and implementation showcased in Quanta does not indicate the discontinuation of efforts initiated in Maetello and TS. On the contrary, Quanta serves as a complementary reference, offering a different perspective and approach to building microservices. The development of the other two projects, Martello and TopSpin, continues concurrently, each addressing specific aspects and providing a comprehensive toolkit for developers. Quanta expands the options and insights available, contributing to a broader understanding and application of microservices architecture.
Quanta is distributed under the MIT License.