mirror of
https://github.com/zitadel/zitadel.git
synced 2025-12-24 01:27:43 +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>
78 lines
2.0 KiB
Go
78 lines
2.0 KiB
Go
package postgres
|
|
|
|
import (
|
|
"github.com/georgysavva/scany/v2/pgxscan"
|
|
"github.com/jackc/pgx/v5"
|
|
|
|
"github.com/zitadel/zitadel/backend/v3/storage/database"
|
|
)
|
|
|
|
var (
|
|
_ database.Rows = (*Rows)(nil)
|
|
_ database.CollectableRows = (*Rows)(nil)
|
|
_ database.Row = (*Row)(nil)
|
|
)
|
|
|
|
type Row struct{ pgx.Row }
|
|
|
|
// Scan implements [database.Row].
|
|
// Subtle: this method shadows the method ([pgx.Row]).Scan of Row.Row.
|
|
func (r *Row) Scan(dest ...any) error {
|
|
return wrapError(r.Row.Scan(dest...))
|
|
}
|
|
|
|
type Rows struct{ pgx.Rows }
|
|
|
|
// Err implements [database.Rows].
|
|
// Subtle: this method shadows the method ([pgx.Rows]).Err of Rows.Rows.
|
|
func (r *Rows) Err() error {
|
|
return wrapError(r.Rows.Err())
|
|
}
|
|
|
|
func (r *Rows) Scan(dest ...any) error {
|
|
return wrapError(r.Rows.Scan(dest...))
|
|
}
|
|
|
|
// Collect implements [database.CollectableRows].
|
|
// See [this page](https://github.com/georgysavva/scany/blob/master/dbscan/doc.go#L8) for additional details.
|
|
func (r *Rows) Collect(dest any) (err error) {
|
|
defer func() {
|
|
closeErr := r.Close()
|
|
if err == nil {
|
|
err = closeErr
|
|
}
|
|
}()
|
|
return wrapError(pgxscan.ScanAll(dest, r.Rows))
|
|
}
|
|
|
|
// CollectFirst implements [database.CollectableRows].
|
|
// See [this page](https://github.com/georgysavva/scany/blob/master/dbscan/doc.go#L8) for additional details.
|
|
func (r *Rows) CollectFirst(dest any) (err error) {
|
|
defer func() {
|
|
closeErr := r.Close()
|
|
if err == nil {
|
|
err = closeErr
|
|
}
|
|
}()
|
|
return wrapError(pgxscan.ScanRow(dest, r.Rows))
|
|
}
|
|
|
|
// CollectExactlyOneRow implements [database.CollectableRows].
|
|
// See [this page](https://github.com/georgysavva/scany/blob/master/dbscan/doc.go#L8) for additional details.
|
|
func (r *Rows) CollectExactlyOneRow(dest any) (err error) {
|
|
defer func() {
|
|
closeErr := r.Close()
|
|
if err == nil {
|
|
err = closeErr
|
|
}
|
|
}()
|
|
return wrapError(pgxscan.ScanOne(dest, r.Rows))
|
|
}
|
|
|
|
// Close implements [database.Rows].
|
|
// Subtle: this method shadows the method (Rows).Close of Rows.Rows.
|
|
func (r *Rows) Close() error {
|
|
r.Rows.Close()
|
|
return nil
|
|
}
|