add docs

internal/repos/users_repo/repo.go

@@ -4,9 +4,11 @@ import (
 	"context"
 	"errors"
 	"evening_detective_server/internal/repos"
+	"evening_detective_server/internal/repos/user_agreements_repo"
 	"fmt"
 
 	"github.com/jackc/pgx/v5"
+	"github.com/jackc/pgx/v5/pgconn"
 	"github.com/jackc/pgx/v5/pgxpool"
 )
 
@@ -24,21 +26,40 @@ func NewUserRepo(pool *pgxpool.Pool) *UsersRepo {
 	}
 }
 
-func (s *UsersRepo) AddUser(
+// AddUserWithAgreements создаёт пользователя и фиксирует акцепты документов
+// (user_agreements) в одной транзакции: пользователь либо существует вместе с
+// записями о согласиях, либо не существует вовсе (доказуемое согласие,
+// ст. 9 152-ФЗ). Возвращает id созданного пользователя.
+func (s *UsersRepo) AddUserWithAgreements(
 	ctx context.Context,
 	username string,
 	email string,
 	passwordHash string,
 	roles []string,
-) error {
-	tag, err := s.pool.Exec(
+	agreements []user_agreements_repo.Agreement,
+) (int, error) {
+	// Инвариант «пользователь не существует без записей о согласиях»
+	// держится на том, что акцепты передаются всегда.
+	if len(agreements) == 0 {
+		return 0, errors.New("Не переданы записи об акцепте соглашений")
+	}
+
+	tx, err := s.pool.Begin(ctx)
+	if err != nil {
+		return 0, err
+	}
+	defer tx.Rollback(ctx) //nolint:errcheck
+
+	var id int
+	err = tx.QueryRow(
 		ctx,
 		`INSERT INTO users (username, email, password_hash, roles)
 		SELECT $1, $2, $3, $4
 		WHERE NOT EXISTS (
 			SELECT 1 FROM users 
 			WHERE username = $5 OR email = $6
-		)`,
+		)
+		RETURNING id`,
 		username,
 		email,
 		passwordHash,
@@ -46,14 +67,41 @@ func (s *UsersRepo) AddUser(
 
 		username,
 		email,
-	)
+	).Scan(&id)
 	if err != nil {
-		return err
+		// Ничего не вставлено — занят username или email.
+		if errors.Is(err, pgx.ErrNoRows) {
+			return 0, errors.New("Username или email уже используется")
+		}
+		// Гонка: между проверкой NOT EXISTS и INSERT другой запрос успел
+		// создать пользователя с тем же username/email — нарушение
+		// уникальности. Возвращаем тот же понятный клиенту ответ.
+		var pgErr *pgconn.PgError
+		if errors.As(err, &pgErr) && pgErr.Code == "23505" { // unique_violation
+			return 0, errors.New("Username или email уже используется")
+		}
+		return 0, err
 	}
-	if tag.RowsAffected() == 0 {
-		return errors.New("username или email уже используется")
+
+	for _, agreement := range agreements {
+		if _, err = tx.Exec(
+			ctx,
+			`INSERT INTO user_agreements (user_id, agreement_type, version, ip, user_agent)
+			VALUES ($1, $2, $3, $4, $5)`,
+			id,
+			agreement.AgreementType,
+			agreement.Version,
+			agreement.IP,
+			agreement.UserAgent,
+		); err != nil {
+			return 0, err
+		}
 	}
-	return nil
+
+	if err = tx.Commit(ctx); err != nil {
+		return 0, err
+	}
+	return id, nil
 }
 
 func (s *UsersRepo) UpdateUserPassword(
@@ -207,3 +255,62 @@ func (s *UsersRepo) DeleteUserRole(
 	)
 	return err
 }
+
+// DeleteUser удаляет учётную запись и персональные данные пользователя
+// (ст. 21 152-ФЗ — уничтожение ПДн при удалении аккаунта). Выполняется в одной
+// транзакции. Публичный контент пользователя (сценарии, команды) сохраняется:
+// FK-ограничения с ON DELETE SET NULL (миграция
+// 20260818232725_keep_content_on_user_delete.sql) обнуляют привязку к автору —
+// контент остаётся в обезличенном виде.
+func (s *UsersRepo) DeleteUser(
+	ctx context.Context,
+	userId int,
+) error {
+	tx, err := s.pool.Begin(ctx)
+	if err != nil {
+		return err
+	}
+	defer tx.Rollback(ctx) //nolint:errcheck
+
+	// Refresh-токены (FK CASCADE, удаляем явно для предсказуемости).
+	if _, err = tx.Exec(
+		ctx,
+		`DELETE FROM refresh_tokens WHERE user_id = $1`,
+		userId,
+	); err != nil {
+		return err
+	}
+
+	// Зафиксированные акцепты соглашений НЕ удаляются: ст. 9 ч. 4 152-ФЗ
+	// возлагает на оператора бремя доказывания получения согласия, поэтому
+	// факт акцепта (документ, версия, время) сохраняется в обезличенном виде:
+	// ссылка на пользователя и персональные данные внутри записи (ip,
+	// user_agent) обнуляются. FK ON DELETE SET NULL (миграция
+	// 20260818231943_create_user_agreements_table.sql) гарантирует, что при
+	// удалении users строки акцептов остаются с user_id = NULL.
+	if _, err = tx.Exec(
+		ctx,
+		`UPDATE user_agreements
+		SET user_id = NULL, ip = NULL, user_agent = NULL
+		WHERE user_id = $1`,
+		userId,
+	); err != nil {
+		return err
+	}
+
+	// Пользователь. Связанные сценарии (author_id) и команды (creator_id)
+	// обнуляются автоматически через ON DELETE SET NULL.
+	tag, err := tx.Exec(
+		ctx,
+		`DELETE FROM users WHERE id = $1`,
+		userId,
+	)
+	if err != nil {
+		return err
+	}
+	if tag.RowsAffected() == 0 {
+		return ErrUserNotFound
+	}
+
+	return tx.Commit(ctx)
+}