Stage 1: backend foundation (Postgres, sessions, accounts, OTel)

- internal/postgres: pgx-over-database/sql pool (otelsql), embedded goose migrations into schema 'backend', committed go-jet code + cmd/jetgen tool. - internal/account: durable accounts + unified telegram/email identities (UUIDv7 keys), find-or-create provisioning with unique-conflict handling. - internal/session: opaque 256-bit tokens stored as a SHA-256 hash, revoke-only (no TTL); write-through cache gating /readyz; store + service. - internal/telemetry: OTel tracer/meter providers (none/stdout) + request-timing middleware; internal/config gains Postgres + OTel env loading. - internal/server: /api/v1 {public,user,internal,admin} skeleton + X-User-ID middleware; /readyz checks DB ping + cache; main wires telemetry -> db+migrate -> warm cache -> server. - Tests: unit + integration (build tag 'integration', testcontainers postgres:17) for migrations, accounts, sessions, readyz; new integration.yaml. - Docs: ARCHITECTURE, TESTING, PLAN refinements, root + backend READMEs. Session/account REST handlers deferred to Stage 6 (gateway); OTLP + dashboards to Stage 11.
2026-06-02 13:52:26 +02:00
parent da079b2bc6
commit eeaad62b10
45 changed files with 3461 additions and 92 deletions
@@ -0,0 +1,24 @@
+//
+// Code generated by go-jet DO NOT EDIT.
+//
+// WARNING: Changes to this file may cause incorrect behavior
+// and will be lost if the code is regenerated
+//
+
+package model
+
+import (
+	"github.com/google/uuid"
+	"time"
+)
+
+type Accounts struct {
+	AccountID           uuid.UUID `sql:"primary_key"`
+	DisplayName         string
+	PreferredLanguage   string
+	TimeZone            string
+	BlockChat           bool
+	BlockFriendRequests bool
+	CreatedAt           time.Time
+	UpdatedAt           time.Time
+}
@@ -0,0 +1,22 @@
+//
+// Code generated by go-jet DO NOT EDIT.
+//
+// WARNING: Changes to this file may cause incorrect behavior
+// and will be lost if the code is regenerated
+//
+
+package model
+
+import (
+	"github.com/google/uuid"
+	"time"
+)
+
+type Identities struct {
+	IdentityID uuid.UUID `sql:"primary_key"`
+	AccountID  uuid.UUID
+	Kind       string
+	ExternalID string
+	Confirmed  bool
+	CreatedAt  time.Time
+}
@@ -0,0 +1,23 @@
+//
+// Code generated by go-jet DO NOT EDIT.
+//
+// WARNING: Changes to this file may cause incorrect behavior
+// and will be lost if the code is regenerated
+//
+
+package model
+
+import (
+	"github.com/google/uuid"
+	"time"
+)
+
+type Sessions struct {
+	SessionID  uuid.UUID `sql:"primary_key"`
+	AccountID  uuid.UUID
+	TokenHash  string
+	Status     string
+	CreatedAt  time.Time
+	LastSeenAt *time.Time
+	RevokedAt  *time.Time
+}
@@ -0,0 +1,99 @@
+//
+// Code generated by go-jet DO NOT EDIT.
+//
+// WARNING: Changes to this file may cause incorrect behavior
+// and will be lost if the code is regenerated
+//
+
+package table
+
+import (
+	"github.com/go-jet/jet/v2/postgres"
+)
+
+var Accounts = newAccountsTable("backend", "accounts", "")
+
+type accountsTable struct {
+	postgres.Table
+
+	// Columns
+	AccountID           postgres.ColumnString
+	DisplayName         postgres.ColumnString
+	PreferredLanguage   postgres.ColumnString
+	TimeZone            postgres.ColumnString
+	BlockChat           postgres.ColumnBool
+	BlockFriendRequests postgres.ColumnBool
+	CreatedAt           postgres.ColumnTimestampz
+	UpdatedAt           postgres.ColumnTimestampz
+
+	AllColumns     postgres.ColumnList
+	MutableColumns postgres.ColumnList
+	DefaultColumns postgres.ColumnList
+}
+
+type AccountsTable struct {
+	accountsTable
+
+	EXCLUDED accountsTable
+}
+
+// AS creates new AccountsTable with assigned alias
+func (a AccountsTable) AS(alias string) *AccountsTable {
+	return newAccountsTable(a.SchemaName(), a.TableName(), alias)
+}
+
+// Schema creates new AccountsTable with assigned schema name
+func (a AccountsTable) FromSchema(schemaName string) *AccountsTable {
+	return newAccountsTable(schemaName, a.TableName(), a.Alias())
+}
+
+// WithPrefix creates new AccountsTable with assigned table prefix
+func (a AccountsTable) WithPrefix(prefix string) *AccountsTable {
+	return newAccountsTable(a.SchemaName(), prefix+a.TableName(), a.TableName())
+}
+
+// WithSuffix creates new AccountsTable with assigned table suffix
+func (a AccountsTable) WithSuffix(suffix string) *AccountsTable {
+	return newAccountsTable(a.SchemaName(), a.TableName()+suffix, a.TableName())
+}
+
+func newAccountsTable(schemaName, tableName, alias string) *AccountsTable {
+	return &AccountsTable{
+		accountsTable: newAccountsTableImpl(schemaName, tableName, alias),
+		EXCLUDED:      newAccountsTableImpl("", "excluded", ""),
+	}
+}
+
+func newAccountsTableImpl(schemaName, tableName, alias string) accountsTable {
+	var (
+		AccountIDColumn           = postgres.StringColumn("account_id")
+		DisplayNameColumn         = postgres.StringColumn("display_name")
+		PreferredLanguageColumn   = postgres.StringColumn("preferred_language")
+		TimeZoneColumn            = postgres.StringColumn("time_zone")
+		BlockChatColumn           = postgres.BoolColumn("block_chat")
+		BlockFriendRequestsColumn = postgres.BoolColumn("block_friend_requests")
+		CreatedAtColumn           = postgres.TimestampzColumn("created_at")
+		UpdatedAtColumn           = postgres.TimestampzColumn("updated_at")
+		allColumns                = postgres.ColumnList{AccountIDColumn, DisplayNameColumn, PreferredLanguageColumn, TimeZoneColumn, BlockChatColumn, BlockFriendRequestsColumn, CreatedAtColumn, UpdatedAtColumn}
+		mutableColumns            = postgres.ColumnList{DisplayNameColumn, PreferredLanguageColumn, TimeZoneColumn, BlockChatColumn, BlockFriendRequestsColumn, CreatedAtColumn, UpdatedAtColumn}
+		defaultColumns            = postgres.ColumnList{DisplayNameColumn, PreferredLanguageColumn, TimeZoneColumn, BlockChatColumn, BlockFriendRequestsColumn, CreatedAtColumn, UpdatedAtColumn}
+	)
+
+	return accountsTable{
+		Table: postgres.NewTable(schemaName, tableName, alias, allColumns...),
+
+		//Columns
+		AccountID:           AccountIDColumn,
+		DisplayName:         DisplayNameColumn,
+		PreferredLanguage:   PreferredLanguageColumn,
+		TimeZone:            TimeZoneColumn,
+		BlockChat:           BlockChatColumn,
+		BlockFriendRequests: BlockFriendRequestsColumn,
+		CreatedAt:           CreatedAtColumn,
+		UpdatedAt:           UpdatedAtColumn,
+
+		AllColumns:     allColumns,
+		MutableColumns: mutableColumns,
+		DefaultColumns: defaultColumns,
+	}
+}
@@ -0,0 +1,93 @@
+//
+// Code generated by go-jet DO NOT EDIT.
+//
+// WARNING: Changes to this file may cause incorrect behavior
+// and will be lost if the code is regenerated
+//
+
+package table
+
+import (
+	"github.com/go-jet/jet/v2/postgres"
+)
+
+var Identities = newIdentitiesTable("backend", "identities", "")
+
+type identitiesTable struct {
+	postgres.Table
+
+	// Columns
+	IdentityID postgres.ColumnString
+	AccountID  postgres.ColumnString
+	Kind       postgres.ColumnString
+	ExternalID postgres.ColumnString
+	Confirmed  postgres.ColumnBool
+	CreatedAt  postgres.ColumnTimestampz
+
+	AllColumns     postgres.ColumnList
+	MutableColumns postgres.ColumnList
+	DefaultColumns postgres.ColumnList
+}
+
+type IdentitiesTable struct {
+	identitiesTable
+
+	EXCLUDED identitiesTable
+}
+
+// AS creates new IdentitiesTable with assigned alias
+func (a IdentitiesTable) AS(alias string) *IdentitiesTable {
+	return newIdentitiesTable(a.SchemaName(), a.TableName(), alias)
+}
+
+// Schema creates new IdentitiesTable with assigned schema name
+func (a IdentitiesTable) FromSchema(schemaName string) *IdentitiesTable {
+	return newIdentitiesTable(schemaName, a.TableName(), a.Alias())
+}
+
+// WithPrefix creates new IdentitiesTable with assigned table prefix
+func (a IdentitiesTable) WithPrefix(prefix string) *IdentitiesTable {
+	return newIdentitiesTable(a.SchemaName(), prefix+a.TableName(), a.TableName())
+}
+
+// WithSuffix creates new IdentitiesTable with assigned table suffix
+func (a IdentitiesTable) WithSuffix(suffix string) *IdentitiesTable {
+	return newIdentitiesTable(a.SchemaName(), a.TableName()+suffix, a.TableName())
+}
+
+func newIdentitiesTable(schemaName, tableName, alias string) *IdentitiesTable {
+	return &IdentitiesTable{
+		identitiesTable: newIdentitiesTableImpl(schemaName, tableName, alias),
+		EXCLUDED:        newIdentitiesTableImpl("", "excluded", ""),
+	}
+}
+
+func newIdentitiesTableImpl(schemaName, tableName, alias string) identitiesTable {
+	var (
+		IdentityIDColumn = postgres.StringColumn("identity_id")
+		AccountIDColumn  = postgres.StringColumn("account_id")
+		KindColumn       = postgres.StringColumn("kind")
+		ExternalIDColumn = postgres.StringColumn("external_id")
+		ConfirmedColumn  = postgres.BoolColumn("confirmed")
+		CreatedAtColumn  = postgres.TimestampzColumn("created_at")
+		allColumns       = postgres.ColumnList{IdentityIDColumn, AccountIDColumn, KindColumn, ExternalIDColumn, ConfirmedColumn, CreatedAtColumn}
+		mutableColumns   = postgres.ColumnList{AccountIDColumn, KindColumn, ExternalIDColumn, ConfirmedColumn, CreatedAtColumn}
+		defaultColumns   = postgres.ColumnList{ConfirmedColumn, CreatedAtColumn}
+	)
+
+	return identitiesTable{
+		Table: postgres.NewTable(schemaName, tableName, alias, allColumns...),
+
+		//Columns
+		IdentityID: IdentityIDColumn,
+		AccountID:  AccountIDColumn,
+		Kind:       KindColumn,
+		ExternalID: ExternalIDColumn,
+		Confirmed:  ConfirmedColumn,
+		CreatedAt:  CreatedAtColumn,
+
+		AllColumns:     allColumns,
+		MutableColumns: mutableColumns,
+		DefaultColumns: defaultColumns,
+	}
+}
@@ -0,0 +1,96 @@
+//
+// Code generated by go-jet DO NOT EDIT.
+//
+// WARNING: Changes to this file may cause incorrect behavior
+// and will be lost if the code is regenerated
+//
+
+package table
+
+import (
+	"github.com/go-jet/jet/v2/postgres"
+)
+
+var Sessions = newSessionsTable("backend", "sessions", "")
+
+type sessionsTable struct {
+	postgres.Table
+
+	// Columns
+	SessionID  postgres.ColumnString
+	AccountID  postgres.ColumnString
+	TokenHash  postgres.ColumnString
+	Status     postgres.ColumnString
+	CreatedAt  postgres.ColumnTimestampz
+	LastSeenAt postgres.ColumnTimestampz
+	RevokedAt  postgres.ColumnTimestampz
+
+	AllColumns     postgres.ColumnList
+	MutableColumns postgres.ColumnList
+	DefaultColumns postgres.ColumnList
+}
+
+type SessionsTable struct {
+	sessionsTable
+
+	EXCLUDED sessionsTable
+}
+
+// AS creates new SessionsTable with assigned alias
+func (a SessionsTable) AS(alias string) *SessionsTable {
+	return newSessionsTable(a.SchemaName(), a.TableName(), alias)
+}
+
+// Schema creates new SessionsTable with assigned schema name
+func (a SessionsTable) FromSchema(schemaName string) *SessionsTable {
+	return newSessionsTable(schemaName, a.TableName(), a.Alias())
+}
+
+// WithPrefix creates new SessionsTable with assigned table prefix
+func (a SessionsTable) WithPrefix(prefix string) *SessionsTable {
+	return newSessionsTable(a.SchemaName(), prefix+a.TableName(), a.TableName())
+}
+
+// WithSuffix creates new SessionsTable with assigned table suffix
+func (a SessionsTable) WithSuffix(suffix string) *SessionsTable {
+	return newSessionsTable(a.SchemaName(), a.TableName()+suffix, a.TableName())
+}
+
+func newSessionsTable(schemaName, tableName, alias string) *SessionsTable {
+	return &SessionsTable{
+		sessionsTable: newSessionsTableImpl(schemaName, tableName, alias),
+		EXCLUDED:      newSessionsTableImpl("", "excluded", ""),
+	}
+}
+
+func newSessionsTableImpl(schemaName, tableName, alias string) sessionsTable {
+	var (
+		SessionIDColumn  = postgres.StringColumn("session_id")
+		AccountIDColumn  = postgres.StringColumn("account_id")
+		TokenHashColumn  = postgres.StringColumn("token_hash")
+		StatusColumn     = postgres.StringColumn("status")
+		CreatedAtColumn  = postgres.TimestampzColumn("created_at")
+		LastSeenAtColumn = postgres.TimestampzColumn("last_seen_at")
+		RevokedAtColumn  = postgres.TimestampzColumn("revoked_at")
+		allColumns       = postgres.ColumnList{SessionIDColumn, AccountIDColumn, TokenHashColumn, StatusColumn, CreatedAtColumn, LastSeenAtColumn, RevokedAtColumn}
+		mutableColumns   = postgres.ColumnList{AccountIDColumn, TokenHashColumn, StatusColumn, CreatedAtColumn, LastSeenAtColumn, RevokedAtColumn}
+		defaultColumns   = postgres.ColumnList{StatusColumn, CreatedAtColumn}
+	)
+
+	return sessionsTable{
+		Table: postgres.NewTable(schemaName, tableName, alias, allColumns...),
+
+		//Columns
+		SessionID:  SessionIDColumn,
+		AccountID:  AccountIDColumn,
+		TokenHash:  TokenHashColumn,
+		Status:     StatusColumn,
+		CreatedAt:  CreatedAtColumn,
+		LastSeenAt: LastSeenAtColumn,
+		RevokedAt:  RevokedAtColumn,
+
+		AllColumns:     allColumns,
+		MutableColumns: mutableColumns,
+		DefaultColumns: defaultColumns,
+	}
+}
@@ -0,0 +1,16 @@
+//
+// Code generated by go-jet DO NOT EDIT.
+//
+// WARNING: Changes to this file may cause incorrect behavior
+// and will be lost if the code is regenerated
+//
+
+package table
+
+// UseSchema sets a new schema name for all generated table SQL builder types. It is recommended to invoke
+// this method only once at the beginning of the program.
+func UseSchema(schema string) {
+	Accounts = Accounts.FromSchema(schema)
+	Identities = Identities.FromSchema(schema)
+	Sessions = Sessions.FromSchema(schema)
+}