mirror of
https://github.com/zitadel/zitadel.git
synced 2025-12-26 14:26:32 +00:00
This PR initiates the rework of Zitadel's backend to state-persisted objects. This change is a step towards a more scalable and maintainable architecture. ## Changes * **New `/backend/v3` package**: A new package structure has been introduced to house the reworked backend logic. This includes: * `domain`: Contains the core business logic, commands, and repository interfaces. * `storage`: Implements the repository interfaces for database interactions with new transactional tables. * `telemetry`: Provides logging and tracing capabilities. * **Transactional Tables**: New database tables have been defined for `instances`, `instance_domains`, `organizations`, and `org_domains`. * **Projections**: New projections have been created to populate the new relational tables from the existing event store, ensuring data consistency during the migration. * **Repositories**: New repositories provide an abstraction layer for accessing and manipulating the data in the new tables. * **Setup**: A new setup step for `TransactionalTables` has been added to manage the database migrations for the new tables. This PR lays the foundation for future work to fully transition to state-persisted objects for these components, which will improve performance and simplify data access patterns. This PR initiates the rework of ZITADEL's backend to state-persisted objects. This is a foundational step towards a new architecture that will improve performance and maintainability. The following objects are migrated from event-sourced aggregates to state-persisted objects: * Instances * incl. Domains * Orgs * incl. Domains The structure of the new backend implementation follows the software architecture defined in this [wiki page](https://github.com/zitadel/zitadel/wiki/Software-Architecturel). This PR includes: * The initial implementation of the new transactional repositories for the objects listed above. * Projections to populate the new relational tables from the existing event store. * Adjustments to the build and test process to accommodate the new backend structure. This is a work in progress and further changes will be made to complete the migration. --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Iraq Jaber <iraq+github@zitadel.com> Co-authored-by: Iraq <66622793+kkrime@users.noreply.github.com> Co-authored-by: Tim Möhlmann <tim+github@zitadel.com>
22 lines
1.1 KiB
Go
22 lines
1.1 KiB
Go
// the test used the manly relies on the following patterns:
|
|
// - api:
|
|
// - some example stubs for the grpc api, it maps the calls and responses to the domain objects
|
|
//
|
|
// - domain:
|
|
// - hexagonal architecture, it defines its dependencies as interfaces and the dependencies must use the objects defined by this package
|
|
// - command pattern which implements the changes
|
|
// - the invoker decorates the commands by checking for events, tracing, logging, potentially caching, etc.
|
|
// - the database connections are manged in this package
|
|
// - the database connections are passed to the repositories
|
|
//
|
|
// - storage:
|
|
// - repository pattern, the repositories are defined as interfaces and the implementations are in the storage package
|
|
// - the repositories are used by the domain package to access the database
|
|
// - the eventstore to store events. At the beginning it writes to the same events table as the /internal package, afterwards it writes to a different table
|
|
//
|
|
// - telemetry:
|
|
// - logging for standard output
|
|
// - tracing for distributed tracing
|
|
// - metrics for monitoring
|
|
package v3
|