PostgreSQL backup tool with Point-In-Time-Recovery and restore verification
TypeScript backupbackupsdatabasedatabase-backupdevopsdockergolangkubernetesmariadbmongodbmysqlpgpostgrespostgresqls3self-hostedsystem-administrationtoolsweb-ui
FEATURE (users): Hand the instance to whoever registers first, instead of seeding an admin account with an address no mail can reach
Rostislav Duginb0a598604cf7
diff --git a/README.md b/README.mdindex 7e610540..728019cb 100644--- a/README.md+++ b/README.md@@ -249,7 +249,7 @@ For more options (NodePort, TLS, HTTPRoute for Gateway API), see the [Helm chart## 🚀 Usage-1. **Access the dashboard**: Navigate to `http://localhost:4005`+1. **Create the first account**: Navigate to `http://localhost:4005` and sign up. The first account created on an instance administers it2. **Add your first database for backup**: Click "New Database" and follow the setup wizard3. **Configure schedule**: Choose from hourly, daily, weekly, monthly or cron intervals4. **Set database connection**: Enter your database credentials and connection details@@ -263,10 +263,18 @@ For more options (NodePort, TLS, HTTPRoute for Gateway API), see the [Helm chartIf you need to reset the password, you can use the built-in password reset command:```bash-docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="admin"+docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]"```-Replace `admin` with the actual email address of the user whose password you want to reset.+Replace `[email protected]` with the actual email address of the account whose password you want to reset. An instance created before the first account administered it still carries the placeholder address `admin` until its owner replaces it, so pass `--email="admin"` there.++If you do not remember which address administers the instance, list the administrator accounts:++```bash+docker exec -it databasus ./main --list-admins+```++The output names every administrator account with its email address, display name, creation date and active state, and marks the one the instance recognizes as its administrator. It prints no password material.### 💾 Backuping Databasus itselfdiff --git a/assets/readme/README.es.md b/assets/readme/README.es.mdindex 65137a79..9e556f2b 100644--- a/assets/readme/README.es.md+++ b/assets/readme/README.es.md@@ -249,7 +249,7 @@ Para más opciones (NodePort, TLS, HTTPRoute para Gateway API), consulte el [REA## 🚀 Uso-1. **Entre en el panel**: abra `http://localhost:4005`+1. **Cree la primera cuenta**: abra `http://localhost:4005` y regístrese. La primera cuenta creada en una instancia es la que la administra2. **Añada su primera base de datos para respaldar**: pulse "New Database" y siga el asistente3. **Configure la programación**: elija entre intervalos horarios, diarios, semanales, mensuales o cron4. **Indique la conexión a la base de datos**: introduzca sus credenciales y los datos de conexión@@ -263,10 +263,18 @@ Para más opciones (NodePort, TLS, HTTPRoute para Gateway API), consulte el [REASi necesita restablecer la contraseña, use el comando integrado:```bash-docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="admin"+docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]"```-Sustituya `admin` por la dirección de correo real del usuario cuya contraseña quiere restablecer.+Sustituya `[email protected]` por la dirección de correo real de la cuenta cuya contraseña quiere restablecer. Una instancia creada antes de que la primera cuenta la administrara todavía lleva la dirección provisional `admin` hasta que su propietario la reemplace, así que allí pase `--email="admin"`.++Si no recuerda qué dirección administra la instancia, liste las cuentas de administrador:++```bash+docker exec -it databasus ./main --list-admins+```++La salida nombra cada cuenta de administrador con su correo electrónico, nombre visible, fecha de creación y estado de actividad, y marca la que la instancia reconoce como su administrador. No imprime ninguna contraseña ni su hash.### 💾 Respaldar el propio Databasusdiff --git a/assets/readme/README.fr.md b/assets/readme/README.fr.mdindex 352bb512..2c5b331c 100644--- a/assets/readme/README.fr.md+++ b/assets/readme/README.fr.md@@ -249,7 +249,7 @@ Pour les autres options (NodePort, TLS, HTTPRoute pour Gateway API), consultez l## 🚀 Utilisation-1. **Ouvrez le tableau de bord** : rendez-vous sur `http://localhost:4005`+1. **Créez le premier compte** : rendez-vous sur `http://localhost:4005` et inscrivez-vous. Le premier compte créé sur une instance est celui qui l'administre2. **Ajoutez votre première base à sauvegarder** : cliquez sur "New Database" et suivez l'assistant3. **Configurez la planification** : toutes les heures, chaque jour, chaque semaine, chaque mois ou selon un intervalle cron4. **Renseignez la connexion** : saisissez les identifiants et les paramètres de connexion de votre base@@ -263,10 +263,18 @@ Pour les autres options (NodePort, TLS, HTTPRoute pour Gateway API), consultez lSi vous devez réinitialiser le mot de passe, utilisez la commande intégrée :```bash-docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="admin"+docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]"```-Remplacez `admin` par l'adresse e-mail de l'utilisateur dont vous voulez réinitialiser le mot de passe.+Remplacez `[email protected]` par l'adresse e-mail du compte dont vous voulez réinitialiser le mot de passe. Une instance créée avant que le premier compte ne l'administre porte encore l'adresse provisoire `admin` tant que son propriétaire ne l'a pas remplacée : indiquez alors `--email="admin"`.++Si vous ne savez plus quelle adresse administre l'instance, listez les comptes administrateurs :++```bash+docker exec -it databasus ./main --list-admins+```++La sortie nomme chaque compte administrateur avec son adresse e-mail, son nom affiché, sa date de création et son état d'activité, et marque celui que l'instance reconnaît comme son administrateur. Aucun mot de passe ni empreinte de mot de passe n'est affiché.### 💾 Sauvegarder Databasus lui-mêmediff --git a/assets/readme/README.pt.md b/assets/readme/README.pt.mdindex 705bf272..01cbbb6e 100644--- a/assets/readme/README.pt.md+++ b/assets/readme/README.pt.md@@ -249,7 +249,7 @@ Para mais opções (NodePort, TLS, HTTPRoute do Gateway API), veja o [README do## 🚀 Como usar-1. **Abra o painel**: acesse `http://localhost:4005`+1. **Crie a primeira conta**: acesse `http://localhost:4005` e cadastre-se. A primeira conta criada em uma instância é quem a administra2. **Adicione a sua primeira base de dados para backup**: clique em "New Database" e siga o assistente de configuração3. **Configure o agendamento**: escolha entre intervalos de hora em hora, diário, semanal, mensal ou cron4. **Informe a conexão com a base**: preencha as credenciais e os dados de conexão da sua base de dados@@ -263,10 +263,18 @@ Para mais opções (NodePort, TLS, HTTPRoute do Gateway API), veja o [README doSe precisar redefinir a senha, use o comando de redefinição já incluído:```bash-docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="admin"+docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]"```-Troque `admin` pelo e-mail do usuário cuja senha você quer redefinir.+Troque `[email protected]` pelo e-mail da conta cuja senha você quer redefinir. Uma instância criada antes de a primeira conta administrá-la ainda carrega o endereço provisório `admin` até que seu dono o substitua, então informe `--email="admin"` nesse caso.++Se você não lembra qual endereço administra a instância, liste as contas de administrador:++```bash+docker exec -it databasus ./main --list-admins+```++A saída nomeia cada conta de administrador com seu e-mail, nome de exibição, data de criação e estado de atividade, e marca aquela que a instância reconhece como seu administrador. Nenhuma senha ou hash de senha é impresso.### 💾 Fazer backup do próprio Databasusdiff --git a/assets/readme/README.ru.md b/assets/readme/README.ru.mdindex d4ca4e59..57c23f92 100644--- a/assets/readme/README.ru.md+++ b/assets/readme/README.ru.md@@ -249,7 +249,7 @@ helm install databasus oci://ghcr.io/databasus/charts/databasus \## 🚀 Использование-1. **Откройте панель**: перейдите на `http://localhost:4005`+1. **Создайте первую учетную запись**: перейдите на `http://localhost:4005` и зарегистрируйтесь. Первая учетная запись, созданная на инстансе, им и управляет2. **Добавьте первую базу для бекапа**: нажмите "New Database" и пройдите мастер настройки3. **Настройте расписание**: выберите интервал — каждый час, день, неделю, месяц или cron4. **Укажите подключение к базе**: введите учетные данные и параметры соединения@@ -263,10 +263,18 @@ helm install databasus oci://ghcr.io/databasus/charts/databasus \Если нужно сбросить пароль, воспользуйтесь встроенной командой:```bash-docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="admin"+docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]"```-Замените `admin` на настоящий адрес почты пользователя, которому меняете пароль.+Замените `[email protected]` на настоящий адрес почты учетной записи, которой меняете пароль. Инстанс, созданный до того, как первая учетная запись стала им управлять, до сих пор носит адрес-заглушку `admin`, пока владелец его не заменит, — там передавайте `--email="admin"`.++Если вы не помните, какой адрес управляет инстансом, выведите список учетных записей администраторов:++```bash+docker exec -it databasus ./main --list-admins+```++В выводе перечислены все учетные записи администраторов с их email, именем, датой создания и состоянием активности, а та, которую инстанс считает своим администратором, отмечена отдельно. Пароли и их хеши не выводятся.### 💾 Бекап самого Databasusdiff --git a/assets/readme/README.zh.md b/assets/readme/README.zh.mdindex 1d14105f..069af5c7 100644--- a/assets/readme/README.zh.md+++ b/assets/readme/README.zh.md@@ -249,7 +249,7 @@ helm install databasus oci://ghcr.io/databasus/charts/databasus \## 🚀 使用-1. **打开控制台**:访问 `http://localhost:4005`+1. **创建第一个账户**:访问 `http://localhost:4005` 并注册。实例上创建的第一个账户就是它的管理员2. **添加第一个要备份的数据库**:点击 "New Database",跟着向导走完3. **配置计划**:可选每小时、每天、每周、每月或 cron 周期4. **填写数据库连接**:输入数据库的凭据和连接信息@@ -263,10 +263,18 @@ helm install databasus oci://ghcr.io/databasus/charts/databasus \如果需要重置密码,可以用内置的密码重置命令:```bash-docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="admin"+docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]"```-把 `admin` 换成要重置密码的那个用户的邮箱地址。+把 `[email protected]` 换成要重置密码的那个账户的邮箱地址。在第一个账户成为管理员之前创建的实例,在其所有者替换之前仍使用占位地址 `admin`,此时请传入 `--email="admin"`。++如果你不记得哪个地址是该实例的管理员,可以列出管理员账户:++```bash+docker exec -it databasus ./main --list-admins+```++输出会列出每个管理员账户的邮箱、显示名称、创建日期和活动状态,并标记实例所认可的管理员。不会输出任何密码或密码哈希。### 💾 给 Databasus 自身做备份diff --git a/backend/cmd/main.go b/backend/cmd/main.goindex 27367901..5371b35b 100644--- a/backend/cmd/main.go+++ b/backend/cmd/main.go@@ -106,11 +106,7 @@ func main() {logger.ExitAfterFlush(1)}- err = users_services.GetUserService().CreateInitialAdmin(ctx)- if err != nil {- log.Error("failed to create initial admin", "error", err)- logger.ExitAfterFlush(1)- }+ listAdminsIfRequested(ctx, log, commandLineOptions)resetPasswordIfRequested(ctx, log, commandLineOptions)@@ -147,23 +143,51 @@ func main() {type commandLineOptions struct {shouldTestStorage bool+ shouldListAdmins boolnewPassword stringpasswordResetEmail string}func parseCommandLineOptions() commandLineOptions {shouldTestStorage := flag.Bool("test-storage", false, "Save and delete a local storage probe")+ shouldListAdmins := flag.Bool("list-admins", false, "Print every administrator account of this instance")newPassword := flag.String("new-password", "", "Set a new password for the user")passwordResetEmail := flag.String("email", "", "Email of the user to reset password")flag.Parse()return commandLineOptions{shouldTestStorage: *shouldTestStorage,+ shouldListAdmins: *shouldListAdmins,newPassword: *newPassword,passwordResetEmail: *passwordResetEmail,}}+// The listing only reads, so unlike the password reset below it installs no+// audit writer - the console path has none, and UserService dereferences its+// writer without a nil check.+func listAdminsIfRequested(+ ctx context.Context,+ log *slog.Logger,+ commandLineOptions commandLineOptions,+) {+ if !commandLineOptions.shouldListAdmins {+ return+ }++ listing, err := users_services.GetManagementService().RenderAdminListing(ctx)+ if err != nil {+ log.ErrorContext(ctx, "failed to list administrators", "error", err)+ logger.ExitAfterFlush(1)+ }++ // Printed rather than logged: the owner runs this to read the addresses, and+ // the logger masks them as the PII they otherwise are.+ fmt.Println(listing)++ logger.ExitAfterFlush(0)+}+func resetPasswordIfRequested(ctx context.Context,log *slog.Logger,diff --git a/backend/internal/features/users/controllers/e2e_test.go b/backend/internal/features/users/controllers/e2e_test.goindex 956e3391..73454b86 100644--- a/backend/internal/features/users/controllers/e2e_test.go+++ b/backend/internal/features/users/controllers/e2e_test.go@@ -1,18 +1,18 @@package users_controllersimport (- "context""net/http""testing""github.com/gin-gonic/gin""github.com/google/uuid""github.com/stretchr/testify/assert"+ "github.com/stretchr/testify/require"- audit_logs_models "databasus-backend/internal/features/audit_logs/models"users_dto "databasus-backend/internal/features/users/dto"users_enums "databasus-backend/internal/features/users/enums"users_middleware "databasus-backend/internal/features/users/middleware"+ users_repositories "databasus-backend/internal/features/users/repositories"users_services "databasus-backend/internal/features/users/services"users_testing "databasus-backend/internal/features/users/testing"test_utils "databasus-backend/internal/util/testing"@@ -20,107 +20,97 @@ import (func Test_AdminLifecycleE2E_CompletesSuccessfully(t *testing.T) {router := createE2ETestRouter()+ users_testing.ResetSettingsToDefaults(t.Context())+ users_testing.DeleteAllUsers()- users_testing.RecreateInitialAdmin(t.Context())-- // 1. Set initial admin password- adminPasswordRequest := users_dto.SetAdminPasswordRequestDTO{- Password: "adminpassword123",+ ownerEmail := "owner" + uuid.New().String() + "@example.com"+ signUpRequest := users_dto.SignUpRequestDTO{+ Email: ownerEmail,+ Password: "ownerpassword123",+ Name: "Owner",}- test_utils.MakePostRequest(+ var signUpResponse users_dto.SignInResponseDTO+ test_utils.MakePostRequestAndUnmarshal(t,router,- "/api/v1/users/admin/set-password",+ "/api/v1/users/signup","",- adminPasswordRequest,+ signUpRequest,http.StatusOK,+ &signUpResponse,)- // 2. Admin signs in- adminSigninRequest := users_dto.SignInRequestDTO{- Email: "admin",- Password: "adminpassword123",- }+ var profileResponse users_dto.UserProfileResponseDTO+ test_utils.MakeGetRequestAndUnmarshal(+ t,+ router,+ "/api/v1/users/me",+ "Bearer "+signUpResponse.Token,+ http.StatusOK,+ &profileResponse,+ )+ assert.Equal(t, users_enums.UserRoleAdmin, profileResponse.Role)- var adminSigninResponse users_dto.SignInResponseDTO+ rootAdmin, err := (&users_repositories.UserRepository{}).GetRootAdmin(t.Context())+ require.NoError(t, err)+ require.NotNil(t, rootAdmin)+ assert.Equal(t, signUpResponse.UserID, rootAdmin.ID)++ var signInResponse users_dto.SignInResponseDTOtest_utils.MakePostRequestAndUnmarshal(t,router,"/api/v1/users/signin","",- adminSigninRequest,+ users_dto.SignInRequestDTO{Email: ownerEmail, Password: "ownerpassword123"},http.StatusOK,- &adminSigninResponse,+ &signInResponse,)- // 3. Admin invites a user- workspaceID := uuid.New()- workspaceRole := users_enums.WorkspaceRoleMember- invitedUserEmail := "invited" + uuid.New().String() + "@example.com"- inviteRequest := users_dto.InviteUserRequestDTO{- Email: invitedUserEmail,- IntendedWorkspaceID: &workspaceID,- IntendedWorkspaceRole: &workspaceRole,- }- test_utils.MakePostRequest(+ changedEmail := "changed" + uuid.New().String() + "@example.com"+ test_utils.MakePutRequest(t,router,- "/api/v1/users/invite",- "Bearer "+adminSigninResponse.Token,- inviteRequest,+ "/api/v1/users/me",+ "Bearer "+signInResponse.Token,+ users_dto.UpdateUserInfoRequestDTO{Email: &changedEmail},http.StatusOK,)- // 4. Invited user signs up- userSignupRequest := users_dto.SignUpRequestDTO{- Email: invitedUserEmail,- Password: "userpassword123",- Name: "Invited User",- }test_utils.MakePostRequest(t,router,- "/api/v1/users/signup",+ "/api/v1/users/signin","",- userSignupRequest,+ users_dto.SignInRequestDTO{Email: changedEmail, Password: "ownerpassword123"},http.StatusOK,)- // 5. User signs in- userSigninRequest := users_dto.SignInRequestDTO{- Email: invitedUserEmail,- Password: "userpassword123",- }-- var userSigninResponse users_dto.SignInResponseDTO- test_utils.MakePostRequestAndUnmarshal(+ test_utils.MakePostRequest(t,router,"/api/v1/users/signin","",- userSigninRequest,- http.StatusOK,- &userSigninResponse,+ users_dto.SignInRequestDTO{Email: ownerEmail, Password: "ownerpassword123"},+ http.StatusBadRequest,)- // 6. Admin lists users and sees new user- var listUsersResponse users_dto.ListUsersResponseDTO- test_utils.MakeGetRequestAndUnmarshal(- t,- router,- "/api/v1/users",- "Bearer "+adminSigninResponse.Token,- http.StatusOK,- &listUsersResponse,- )- assert.GreaterOrEqual(t, len(listUsersResponse.Users), 2) // Admin + new user+ rootAdminAfterChange, err := (&users_repositories.UserRepository{}).GetRootAdmin(t.Context())+ require.NoError(t, err)+ require.NotNil(t, rootAdminAfterChange)+ assert.Equal(t, signUpResponse.UserID, rootAdminAfterChange.ID)+ assert.Equal(t, changedEmail, rootAdminAfterChange.Email)}func Test_UserLifecycleE2E_CompletesSuccessfully(t *testing.T) {router := createE2ETestRouter()users_testing.ResetSettingsToDefaults(t.Context())+ // An account has to exist first: the registration below is an ordinary one+ // only because the instance has already been claimed.+ users_testing.RecreateInitialAdmin(t.Context())+// 1. User registersuserEmail := "testuser" + uuid.New().String() + "@example.com"userSignupRequest := users_dto.SignUpRequestDTO{@@ -188,7 +178,8 @@ func createUserTestRouter() *gin.Engine {GetUserController().RegisterProtectedRoutes(protected.(*gin.RouterGroup))// Setup audit log service- users_services.GetUserService().SetAuditLogWriter(&AuditLogWriterStub{})+ auditLogRecorder := users_testing.InstallAuditLogRecorder()+ users_services.GetUserService().SetAuditLogWriter(auditLogRecorder)return router}@@ -204,9 +195,10 @@ func createSettingsTestRouter() *gin.Engine {GetSettingsController().RegisterRoutes(protected.(*gin.RouterGroup))// Setup audit log service- users_services.GetUserService().SetAuditLogWriter(&AuditLogWriterStub{})- users_services.GetSettingsService().SetAuditLogWriter(&AuditLogWriterStub{})- users_services.GetManagementService().SetAuditLogWriter(&AuditLogWriterStub{})+ auditLogRecorder := users_testing.InstallAuditLogRecorder()+ users_services.GetUserService().SetAuditLogWriter(auditLogRecorder)+ users_services.GetSettingsService().SetAuditLogWriter(auditLogRecorder)+ users_services.GetManagementService().SetAuditLogWriter(auditLogRecorder)return router}@@ -222,9 +214,10 @@ func createManagementTestRouter() *gin.Engine {GetManagementController().RegisterRoutes(protected.(*gin.RouterGroup))// Setup audit log service- users_services.GetUserService().SetAuditLogWriter(&AuditLogWriterStub{})- users_services.GetSettingsService().SetAuditLogWriter(&AuditLogWriterStub{})- users_services.GetManagementService().SetAuditLogWriter(&AuditLogWriterStub{})+ auditLogRecorder := users_testing.InstallAuditLogRecorder()+ users_services.GetUserService().SetAuditLogWriter(auditLogRecorder)+ users_services.GetSettingsService().SetAuditLogWriter(auditLogRecorder)+ users_services.GetManagementService().SetAuditLogWriter(auditLogRecorder)return router}@@ -245,14 +238,10 @@ func createE2ETestRouter() *gin.Engine {GetManagementController().RegisterRoutes(protected.(*gin.RouterGroup))// Setup audit log service- users_services.GetUserService().SetAuditLogWriter(&AuditLogWriterStub{})- users_services.GetSettingsService().SetAuditLogWriter(&AuditLogWriterStub{})- users_services.GetManagementService().SetAuditLogWriter(&AuditLogWriterStub{})+ auditLogRecorder := users_testing.InstallAuditLogRecorder()+ users_services.GetUserService().SetAuditLogWriter(auditLogRecorder)+ users_services.GetSettingsService().SetAuditLogWriter(auditLogRecorder)+ users_services.GetManagementService().SetAuditLogWriter(auditLogRecorder)return router}--type AuditLogWriterStub struct{}--func (a *AuditLogWriterStub) WriteAuditLog(context.Context, audit_logs_models.AuditEntry) {-}diff --git a/backend/internal/features/users/controllers/management_controller_test.go b/backend/internal/features/users/controllers/management_controller_test.goindex 4509566c..dd4d3062 100644--- a/backend/internal/features/users/controllers/management_controller_test.go+++ b/backend/internal/features/users/controllers/management_controller_test.go@@ -8,11 +8,13 @@ import ("github.com/gin-gonic/gin""github.com/google/uuid""github.com/stretchr/testify/assert"+ "github.com/stretchr/testify/require""databasus-backend/internal/features/audit_logs"users_dto "databasus-backend/internal/features/users/dto"users_enums "databasus-backend/internal/features/users/enums"users_middleware "databasus-backend/internal/features/users/middleware"+ users_repositories "databasus-backend/internal/features/users/repositories"users_services "databasus-backend/internal/features/users/services"users_testing "databasus-backend/internal/features/users/testing"workspaces_controllers "databasus-backend/internal/features/workspaces/controllers"@@ -793,3 +795,121 @@ func createInviteWorkspaceTestRouter() *gin.Engine {return router}++func Test_ManageAdmins_WhenBootstrapAdminHasChangedAddress_AllThreeActionsSucceed(t *testing.T) {+ // The management router is built last: it installs the recorder on all three+ // services, and the user router would otherwise leave the management service+ // writing into an earlier one.+ userRouter := createUserTestRouter()+ router := createManagementTestRouter()+ auditLogRecorder := users_testing.GetAuditLogRecorder()++ rootAdmin := users_testing.RecreateInitAdminAndGetAccess(t.Context())++ changedEmail := "moved" + uuid.New().String() + "@example.com"+ test_utils.MakePutRequest(+ t,+ userRouter,+ "/api/v1/users/me",+ "Bearer "+rootAdmin.Token,+ users_dto.UpdateUserInfoRequestDTO{Email: &changedEmail},+ http.StatusOK,+ )++ targetUser := users_testing.CreateTestUser(t.Context(), users_enums.UserRoleMember)++ response := test_utils.MakePutRequest(+ t,+ router,+ "/api/v1/users/"+targetUser.UserID.String()+"/role",+ "Bearer "+rootAdmin.Token,+ users_dto.ChangeUserRoleRequestDTO{Role: users_enums.UserRoleAdmin},+ http.StatusOK,+ )+ assert.Contains(t, string(response.Body), "User role changed successfully")++ response = test_utils.MakePostRequest(+ t,+ router,+ "/api/v1/users/"+targetUser.UserID.String()+"/deactivate",+ "Bearer "+rootAdmin.Token,+ nil,+ http.StatusOK,+ )+ assert.Contains(t, string(response.Body), "User deactivated successfully")++ response = test_utils.MakePostRequest(+ t,+ router,+ "/api/v1/users/"+targetUser.UserID.String()+"/activate",+ "Bearer "+rootAdmin.Token,+ nil,+ http.StatusOK,+ )+ assert.Contains(t, string(response.Body), "User activated successfully")++ assert.True(t, auditLogRecorder.HasEntryContaining("User role changed", targetUser.Email))+ assert.True(t, auditLogRecorder.HasEntryContaining("User deactivated", targetUser.Email))+}++// The property here holds by composition of three separate rules and nothing in+// the code states it, so an edit to any one of them could remove it silently.+func Test_ManageAdmins_AgainstTheBootstrapAdmin_IsAlwaysRefused(t *testing.T) {+ router := createManagementTestRouter()++ rootAdmin := users_testing.RecreateInitAdminAndGetAccess(t.Context())++ recordedRootAdmin, err := (&users_repositories.UserRepository{}).GetRootAdmin(t.Context())+ require.NoError(t, err)+ require.NotNil(t, recordedRootAdmin)+ require.Equal(t, rootAdmin.UserID, recordedRootAdmin.ID)++ ordinaryAdmin := users_testing.CreateTestUser(t.Context(), users_enums.UserRoleAdmin)++ response := test_utils.MakePutRequest(+ t,+ router,+ "/api/v1/users/"+rootAdmin.UserID.String()+"/role",+ "Bearer "+ordinaryAdmin.Token,+ users_dto.ChangeUserRoleRequestDTO{Role: users_enums.UserRoleMember},+ http.StatusBadRequest,+ )+ assert.Contains(t, string(response.Body), "only the root admin user")++ response = test_utils.MakePostRequest(+ t,+ router,+ "/api/v1/users/"+rootAdmin.UserID.String()+"/deactivate",+ "Bearer "+ordinaryAdmin.Token,+ nil,+ http.StatusBadRequest,+ )+ assert.Contains(t, string(response.Body), "only the root admin user")++ response = test_utils.MakePutRequest(+ t,+ router,+ "/api/v1/users/"+rootAdmin.UserID.String()+"/role",+ "Bearer "+rootAdmin.Token,+ users_dto.ChangeUserRoleRequestDTO{Role: users_enums.UserRoleMember},+ http.StatusBadRequest,+ )+ assert.Contains(t, string(response.Body), "cannot change your own role")++ response = test_utils.MakePostRequest(+ t,+ router,+ "/api/v1/users/"+rootAdmin.UserID.String()+"/deactivate",+ "Bearer "+rootAdmin.Token,+ nil,+ http.StatusBadRequest,+ )+ assert.Contains(t, string(response.Body), "cannot deactivate your own account")++ unchangedRootAdmin, err := (&users_repositories.UserRepository{}).GetRootAdmin(t.Context())+ require.NoError(t, err)+ require.NotNil(t, unchangedRootAdmin)+ assert.Equal(t, rootAdmin.UserID, unchangedRootAdmin.ID)+ assert.Equal(t, users_enums.UserRoleAdmin, unchangedRootAdmin.Role)+ assert.Equal(t, users_enums.UserStatusActive, unchangedRootAdmin.Status)+}diff --git a/backend/internal/features/users/controllers/user_controller.go b/backend/internal/features/users/controllers/user_controller.goindex 9bed0d69..393e6122 100644--- a/backend/internal/features/users/controllers/user_controller.go+++ b/backend/internal/features/users/controllers/user_controller.go@@ -27,9 +27,7 @@ func (c *UserController) RegisterRoutes(router *gin.RouterGroup) {router.POST("/users/signup", c.SignUp)router.POST("/users/signin", c.SignIn)- // Admin password setup (no auth required)- router.GET("/users/admin/has-password", c.IsAdminHasPassword)- router.POST("/users/admin/set-password", c.SetAdminPassword)+ router.GET("/users/is-any-user-exist", c.HasAnyUser)// Password reset (no auth required)router.POST("/users/send-reset-password-code", c.SendResetPasswordCode)@@ -167,33 +165,22 @@ func (c *UserController) SignIn(ctx *gin.Context) {ctx.JSON(http.StatusOK, response)}-// Admin password endpoints-func (c *UserController) IsAdminHasPassword(ctx *gin.Context) {- hasPassword, err := c.userService.IsRootAdminHasPassword(ctx.Request.Context())+// HasAnyUser+// @Summary Check whether the instance holds any account+// @Description Tells the entry screen whether to offer signing in or the registration that claims the instance+// @Tags users+// @Produce json+// @Success 200 {object} users_dto.HasAnyUserResponseDTO+// @Failure 500+// @Router /users/is-any-user-exist [get]+func (c *UserController) HasAnyUser(ctx *gin.Context) {+ hasAnyUser, err := c.userService.HasAnyUser()if err != nil {- ctx.JSON(- http.StatusInternalServerError,- gin.H{"error": err.Error()},- )- return- }-- ctx.JSON(http.StatusOK, user_dto.IsAdminHasPasswordResponseDTO{HasPassword: hasPassword})-}--func (c *UserController) SetAdminPassword(ctx *gin.Context) {- var request user_dto.SetAdminPasswordRequestDTO- if err := ctx.ShouldBindJSON(&request); err != nil {- ctx.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})- return- }-- if err := c.userService.SetRootAdminPassword(ctx.Request.Context(), request.Password); err != nil {- ctx.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})+ ctx.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})return}- ctx.JSON(http.StatusOK, gin.H{"message": "Admin password set successfully"})+ ctx.JSON(http.StatusOK, user_dto.HasAnyUserResponseDTO{HasAnyUser: hasAnyUser})}// ChangePassworddiff --git a/backend/internal/features/users/controllers/user_controller_test.go b/backend/internal/features/users/controllers/user_controller_test.goindex f59c9a5d..76c381a1 100644--- a/backend/internal/features/users/controllers/user_controller_test.go+++ b/backend/internal/features/users/controllers/user_controller_test.go@@ -11,14 +11,18 @@ import ("net/http/httptest""strings""testing"+ "time""github.com/gin-gonic/gin""github.com/google/uuid""github.com/stretchr/testify/assert"+ "github.com/stretchr/testify/require""golang.org/x/oauth2"users_dto "databasus-backend/internal/features/users/dto"users_enums "databasus-backend/internal/features/users/enums"+ users_models "databasus-backend/internal/features/users/models"+ users_repositories "databasus-backend/internal/features/users/repositories"users_services "databasus-backend/internal/features/users/services"users_testing "databasus-backend/internal/features/users/testing""databasus-backend/internal/util/ratelimiter"@@ -29,6 +33,8 @@ type failingRateLimitCounter struct {err error}+const bootstrapAdminPassword = "ownerpassword123"+func (c failingRateLimitCounter) RecordAttemptAndCheckIsAllowed(context.Context,ratelimiter.Attempt,@@ -275,103 +281,6 @@ func Test_SignInUser_WithInvalidJSON_ReturnsBadRequest(t *testing.T) {assert.Contains(t, string(resp.Body), "Invalid request format")}-func Test_CheckAdminHasPassword_WhenAdminHasNoPassword_ReturnsFalse(t *testing.T) {- router := createUserTestRouter()-- users_testing.RecreateInitialAdmin(t.Context())-- var response users_dto.IsAdminHasPasswordResponseDTO- test_utils.MakeGetRequestAndUnmarshal(- t,- router,- "/api/v1/users/admin/has-password",- "",- http.StatusOK,- &response,- )-- assert.False(t, response.HasPassword)-}--func Test_SetAdminPassword_WithValidPassword_PasswordSet(t *testing.T) {- router := createUserTestRouter()-- users_testing.RecreateInitialAdmin(t.Context())-- request := users_dto.SetAdminPasswordRequestDTO{- Password: "adminpassword123",- }-- test_utils.MakePostRequest(- t,- router,- "/api/v1/users/admin/set-password",- "",- request,- http.StatusOK,- )-- // Now check that admin has password- var hasPasswordResponse users_dto.IsAdminHasPasswordResponseDTO- test_utils.MakeGetRequestAndUnmarshal(- t,- router,- "/api/v1/users/admin/has-password",- "",- http.StatusOK,- &hasPasswordResponse,- )-- assert.True(t, hasPasswordResponse.HasPassword)-}--func Test_SetAdminPassword_WithInvalidPassword_ReturnsBadRequest(t *testing.T) {- router := createUserTestRouter()-- testCases := []struct {- name string- password string- }{- {- name: "short password",- password: "short",- },- {- name: "empty password",- password: "",- },- }-- for _, tc := range testCases {- t.Run(tc.name, func(t *testing.T) {- request := users_dto.SetAdminPasswordRequestDTO{- Password: tc.password,- }-- test_utils.MakePostRequest(- t,- router,- "/api/v1/users/admin/set-password",- "",- request,- http.StatusBadRequest,- )- })- }-}--func Test_SetAdminPassword_WithInvalidJSON_ReturnsBadRequest(t *testing.T) {- router := createUserTestRouter()-- // Test with invalid JSON structure- test_utils.MakeRequest(t, router, test_utils.RequestOptions{- Method: "POST",- URL: "/api/v1/users/admin/set-password",- Body: "invalid json",- ExpectedStatus: http.StatusBadRequest,- })-}-func Test_ChangeUserPassword_WithValidData_PasswordChanged(t *testing.T) {router := createUserTestRouter()email := "changepass" + uuid.New().String() + "@example.com"@@ -758,27 +667,6 @@ func Test_UpdateUserInfo_WithTakenEmail_ReturnsBadRequest(t *testing.T) {assert.Contains(t, string(resp.Body), "already taken")}-func Test_UpdateUserInfo_WhenAdminTriesToChangeEmail_ReturnsBadRequest(t *testing.T) {- router := createUserTestRouter()- adminUser := users_testing.RecreateInitAdminAndGetAccess(t.Context())-- newEmail := "[email protected]"- request := users_dto.UpdateUserInfoRequestDTO{- Email: &newEmail,- }-- resp := test_utils.MakePutRequest(- t,- router,- "/api/v1/users/me",- "Bearer "+adminUser.Token,- request,- http.StatusBadRequest,- )-- assert.Contains(t, string(resp.Body), "admin email cannot be changed")-}-func Test_GitHubOAuth_WithValidCode_ReturnsToken(t *testing.T) {testID := uuid.New().String()[:8]testEmail := "github-user-" + testID + "@example.com"@@ -1257,3 +1145,620 @@ func Test_SignIn_WithExcessiveAttempts_RateLimitEnforced(t *testing.T) {)assert.Contains(t, string(resp.Body), "Rate limit exceeded")}++func Test_SignUp_WhenInstanceHoldsNoAccount_AccountAdministersTheInstance(t *testing.T) {+ router := createUserTestRouter()+ auditLogRecorder := users_testing.GetAuditLogRecorder()+ users_testing.ResetSettingsToDefaults(t.Context())+ users_testing.DeleteAllUsers()++ email := "first" + uuid.New().String() + "@example.com"+ signUpResponse := signUpViaAPI(t, router, email)++ profile := getOwnProfile(t, router, signUpResponse.Token)+ assert.Equal(t, users_enums.UserRoleAdmin, profile.Role)++ rootAdmin, err := (&users_repositories.UserRepository{}).GetRootAdmin(t.Context())+ require.NoError(t, err)+ require.NotNil(t, rootAdmin)+ assert.Equal(t, signUpResponse.UserID, rootAdmin.ID)++ assert.True(t, auditLogRecorder.HasEntryContaining("administers", email))+}++func Test_SignUp_WhenInstanceAlreadyHoldsAnAccount_AccountIsOrdinaryMember(t *testing.T) {+ router := createUserTestRouter()+ users_testing.ResetSettingsToDefaults(t.Context())+ users_testing.DeleteAllUsers()++ signUpViaAPI(t, router, "first"+uuid.New().String()+"@example.com")+ secondResponse := signUpViaAPI(t, router, "second"+uuid.New().String()+"@example.com")++ profile := getOwnProfile(t, router, secondResponse.Token)+ assert.Equal(t, users_enums.UserRoleMember, profile.Role)++ rootAdmin, err := (&users_repositories.UserRepository{}).GetRootAdmin(t.Context())+ require.NoError(t, err)+ require.NotNil(t, rootAdmin)+ assert.NotEqual(t, secondResponse.UserID, rootAdmin.ID)+}++func Test_SignUp_WhenInstanceIsEmptyAndExternalRegistrationDisabled_AccountStillTakesTheInstance(t *testing.T) {+ router := createUserTestRouter()+ defer users_testing.ResetSettingsToDefaults(t.Context())++ users_testing.DisableExternalRegistrations(t.Context())+ users_testing.DeleteAllUsers()++ signUpResponse := signUpViaAPI(t, router, "first"+uuid.New().String()+"@example.com")++ profile := getOwnProfile(t, router, signUpResponse.Token)+ assert.Equal(t, users_enums.UserRoleAdmin, profile.Role)+}++func Test_SignUp_WhenInstanceHoldsAnAccountAndExternalRegistrationDisabled_ReturnsBadRequest(t *testing.T) {+ router := createUserTestRouter()+ defer users_testing.ResetSettingsToDefaults(t.Context())++ users_testing.ResetSettingsToDefaults(t.Context())+ users_testing.RecreateInitialAdmin(t.Context())+ users_testing.DisableExternalRegistrations(t.Context())++ response := test_utils.MakePostRequest(+ t,+ router,+ "/api/v1/users/signup",+ "",+ users_dto.SignUpRequestDTO{+ Email: "refused" + uuid.New().String() + "@example.com",+ Password: "userpassword123",+ Name: "Refused User",+ },+ http.StatusBadRequest,+ )++ assert.Contains(t, string(response.Body), "external registration is disabled")+}++func Test_SignUp_WhenBootstrapAdminAlreadyRecorded_RegistersAsMemberAndLeavesRecordAlone(t *testing.T) {+ router := createUserTestRouter()+ users_testing.ResetSettingsToDefaults(t.Context())++ bootstrapAdmin := users_testing.RecreateInitialAdmin(t.Context())++ signUpResponse := signUpViaAPI(t, router, "member"+uuid.New().String()+"@example.com")++ profile := getOwnProfile(t, router, signUpResponse.Token)+ assert.Equal(t, users_enums.UserRoleMember, profile.Role)++ rootAdmin, err := (&users_repositories.UserRepository{}).GetRootAdmin(t.Context())+ require.NoError(t, err)+ require.NotNil(t, rootAdmin)+ assert.Equal(t, bootstrapAdmin.ID, rootAdmin.ID)+}++func Test_SignUp_WhenEmailBelongsToAnotherAccount_ReturnsDuplicateRefusal(t *testing.T) {+ router := createUserTestRouter()+ users_testing.ResetSettingsToDefaults(t.Context())+ users_testing.RecreateInitialAdmin(t.Context())++ takenEmail := "taken" + uuid.New().String() + "@example.com"+ signUpViaAPI(t, router, takenEmail)++ response := test_utils.MakePostRequest(+ t,+ router,+ "/api/v1/users/signup",+ "",+ users_dto.SignUpRequestDTO{+ Email: takenEmail,+ Password: "userpassword123",+ Name: "Duplicate User",+ },+ http.StatusBadRequest,+ )++ assert.Contains(t, string(response.Body), "already exists")+}++func Test_SignUp_WhenEmailIsNotAnAddress_ReturnsBadRequestAndCreatesNoAccount(t *testing.T) {+ router := createUserTestRouter()+ users_testing.ResetSettingsToDefaults(t.Context())+ users_testing.DeleteAllUsers()++ test_utils.MakePostRequest(+ t,+ router,+ "/api/v1/users/signup",+ "",+ users_dto.SignUpRequestDTO{+ Email: "admin",+ Password: "userpassword123",+ Name: "Not An Address",+ },+ http.StatusBadRequest,+ )++ assert.False(t, hasAnyUserViaAPI(t, router))++ signUpViaAPI(t, router, "valid"+uuid.New().String()+"@example.com")+ assert.True(t, hasAnyUserViaAPI(t, router))+}++func Test_HasAnyUser_WhenInstanceHoldsNoAccount_AnswersFalse(t *testing.T) {+ router := createUserTestRouter()+ users_testing.ResetSettingsToDefaults(t.Context())+ users_testing.DeleteAllUsers()++ assert.False(t, hasAnyUserViaAPI(t, router))+}++func Test_HasAnyUser_WhenInstanceHoldsAnAccount_AnswersTrue(t *testing.T) {+ router := createUserTestRouter()+ users_testing.ResetSettingsToDefaults(t.Context())+ users_testing.DeleteAllUsers()+ users_testing.RecreateInitialAdmin(t.Context())++ assert.True(t, hasAnyUserViaAPI(t, router))+}++// The spec refuses any way to set a password on an existing account without+// authenticating as it or proving control of its address.+func Test_SetPasswordOnExistingAccount_WhenCallerIsAnonymous_IsRefused(t *testing.T) {+ router := createUserTestRouter()++ test_utils.MakeRequest(t, router, test_utils.RequestOptions{+ Method: http.MethodGet,+ URL: "/api/v1/users/admin/has-password",+ ExpectedStatus: http.StatusNotFound,+ })++ test_utils.MakeRequest(t, router, test_utils.RequestOptions{+ Method: http.MethodPost,+ URL: "/api/v1/users/admin/set-password",+ Body: `{"password":"adminpassword123"}`,+ ExpectedStatus: http.StatusNotFound,+ })+}++func Test_GitHubOAuth_WhenInstanceHoldsNoAccount_AccountAdministersTheInstance(t *testing.T) {+ createUserTestRouter()+ users_testing.ResetSettingsToDefaults(t.Context())+ users_testing.DeleteAllUsers()++ email := "github-first-" + uuid.New().String()[:8] + "@example.com"+ mockServer := newGitHubOAuthMockServer(email, int64(uuid.New().ID()))+ defer mockServer.Close()++ response, err := users_services.GetUserService().HandleGitHubOAuthWithMockEndpoint(+ t.Context(),+ "test-code",+ "http://localhost:3000/auth/callback",+ gitHubOAuthEndpoint(mockServer.URL),+ mockServer.URL+"/user",+ )++ require.NoError(t, err)+ assertAccountAdministersTheInstance(t, response.UserID)+}++func Test_GoogleOAuth_WhenInstanceHoldsNoAccount_AccountAdministersTheInstance(t *testing.T) {+ createUserTestRouter()+ users_testing.ResetSettingsToDefaults(t.Context())+ users_testing.DeleteAllUsers()++ email := "google-first-" + uuid.New().String()[:8] + "@example.com"+ mockServer := newGoogleOAuthMockServer(email, "google-"+uuid.New().String()[:8])+ defer mockServer.Close()++ response, err := users_services.GetUserService().HandleGoogleOAuthWithMockEndpoint(+ t.Context(),+ "test-code",+ "http://localhost:3000/auth/callback",+ googleOAuthEndpoint(mockServer.URL),+ mockServer.URL+"/userinfo",+ )++ require.NoError(t, err)+ assertAccountAdministersTheInstance(t, response.UserID)+}++func assertAccountAdministersTheInstance(t *testing.T, userID uuid.UUID) {+ t.Helper()++ repository := &users_repositories.UserRepository{}++ user, err := repository.GetUserByID(t.Context(), userID)+ require.NoError(t, err)+ assert.Equal(t, users_enums.UserRoleAdmin, user.Role)++ rootAdmin, err := repository.GetRootAdmin(t.Context())+ require.NoError(t, err)+ require.NotNil(t, rootAdmin)+ assert.Equal(t, userID, rootAdmin.ID)+}++func signUpViaAPI(t *testing.T, router *gin.Engine, email string) users_dto.SignInResponseDTO {+ t.Helper()++ var response users_dto.SignInResponseDTO+ test_utils.MakePostRequestAndUnmarshal(+ t,+ router,+ "/api/v1/users/signup",+ "",+ users_dto.SignUpRequestDTO{+ Email: email,+ Password: "userpassword123",+ Name: "Test User",+ },+ http.StatusOK,+ &response,+ )++ return response+}++func getOwnProfile(t *testing.T, router *gin.Engine, token string) users_dto.UserProfileResponseDTO {+ t.Helper()++ var profile users_dto.UserProfileResponseDTO+ test_utils.MakeGetRequestAndUnmarshal(+ t,+ router,+ "/api/v1/users/me",+ "Bearer "+token,+ http.StatusOK,+ &profile,+ )++ return profile+}++func hasAnyUserViaAPI(t *testing.T, router *gin.Engine) bool {+ t.Helper()++ var response users_dto.HasAnyUserResponseDTO+ test_utils.MakeGetRequestAndUnmarshal(+ t,+ router,+ "/api/v1/users/is-any-user-exist",+ "",+ http.StatusOK,+ &response,+ )++ return response.HasAnyUser+}++func gitHubOAuthEndpoint(serverURL string) oauth2.Endpoint {+ return oauth2.Endpoint{+ AuthURL: serverURL + "/login/oauth/authorize",+ TokenURL: serverURL + "/login/oauth/access_token",+ }+}++func googleOAuthEndpoint(serverURL string) oauth2.Endpoint {+ return oauth2.Endpoint{+ AuthURL: serverURL + "/auth",+ TokenURL: serverURL + "/token",+ }+}++func newGitHubOAuthMockServer(email string, oauthID int64) *httptest.Server {+ return httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {+ switch r.URL.Path {+ case "/login/oauth/access_token":+ w.Header().Set("Content-Type", "application/json")+ _ = json.NewEncoder(w).Encode(map[string]string{+ "access_token": "mock-access-token",+ "token_type": "bearer",+ })+ case "/user":+ w.Header().Set("Content-Type", "application/json")+ _ = json.NewEncoder(w).Encode(map[string]any{+ "id": oauthID,+ "email": email,+ "name": "GitHub Test User",+ "login": "githubtest",+ })+ default:+ w.WriteHeader(http.StatusNotFound)+ }+ }))+}++func newGoogleOAuthMockServer(email, oauthID string) *httptest.Server {+ return httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {+ switch r.URL.Path {+ case "/token":+ w.Header().Set("Content-Type", "application/json")+ _ = json.NewEncoder(w).Encode(map[string]string{+ "access_token": "mock-access-token",+ "token_type": "Bearer",+ })+ case "/userinfo":+ w.Header().Set("Content-Type", "application/json")+ _ = json.NewEncoder(w).Encode(map[string]any{+ "id": oauthID,+ "email": email,+ "name": "Google Test User",+ })+ default:+ w.WriteHeader(http.StatusNotFound)+ }+ }))+}++func Test_UpdateUserInfo_WhenBootstrapAdminChangesEmail_SignInMovesToTheNewAddress(t *testing.T) {+ router := createUserTestRouter()+ auditLogRecorder := users_testing.GetAuditLogRecorder()+ owner, ownerEmail := claimInstanceViaAPI(t, router)++ changedEmail := "changed" + uuid.New().String() + "@example.com"+ test_utils.MakePutRequest(+ t,+ router,+ "/api/v1/users/me",+ "Bearer "+owner.Token,+ users_dto.UpdateUserInfoRequestDTO{Email: &changedEmail},+ http.StatusOK,+ )++ signInViaAPI(t, router, changedEmail, http.StatusOK)+ signInViaAPI(t, router, ownerEmail, http.StatusBadRequest)++ rootAdmin, err := (&users_repositories.UserRepository{}).GetRootAdmin(t.Context())+ require.NoError(t, err)+ require.NotNil(t, rootAdmin)+ assert.Equal(t, owner.UserID, rootAdmin.ID)++ assert.True(t, auditLogRecorder.HasEntryContaining("Email changed from", ownerEmail, changedEmail))++ // The token carries the user id and the password creation time, never the+ // address, so it survives the change.+ profile := getOwnProfile(t, router, owner.Token)+ assert.Equal(t, changedEmail, profile.Email)+}++func Test_UpdateUserInfo_WhenBootstrapAdminSubmitsUnusableEmail_ChangeIsRejected(t *testing.T) {+ router := createUserTestRouter()+ owner, ownerEmail := claimInstanceViaAPI(t, router)++ otherEmail := "other" + uuid.New().String() + "@example.com"+ signUpViaAPI(t, router, otherEmail)++ notAnAddress := "admin"+ test_utils.MakePutRequest(+ t,+ router,+ "/api/v1/users/me",+ "Bearer "+owner.Token,+ users_dto.UpdateUserInfoRequestDTO{Email: ¬AnAddress},+ http.StatusBadRequest,+ )++ response := test_utils.MakePutRequest(+ t,+ router,+ "/api/v1/users/me",+ "Bearer "+owner.Token,+ users_dto.UpdateUserInfoRequestDTO{Email: &otherEmail},+ http.StatusBadRequest,+ )+ assert.Contains(t, string(response.Body), "already taken")++ profile := getOwnProfile(t, router, owner.Token)+ assert.Equal(t, ownerEmail, profile.Email)+}++func Test_ResetPassword_WhenRequestedByBootstrapAdmin_PasswordIsReplaced(t *testing.T) {+ router := createUserTestRouter()+ mockEmailSender := users_testing.NewMockEmailSender()+ users_services.GetUserService().SetEmailSender(mockEmailSender)++ _, ownerEmail := claimInstanceViaAPI(t, router)++ test_utils.MakePostRequest(+ t,+ router,+ "/api/v1/users/send-reset-password-code",+ "",+ users_dto.SendResetPasswordCodeRequestDTO{Email: ownerEmail},+ http.StatusOK,+ )++ require.Len(t, mockEmailSender.SentEmails, 1)+ assert.Equal(t, ownerEmail, mockEmailSender.SentEmails[0].To)++ code := extractCodeFromEmail(mockEmailSender.SentEmails[0].Body)+ require.Len(t, code, 6)++ test_utils.MakePostRequest(+ t,+ router,+ "/api/v1/users/reset-password",+ "",+ users_dto.ResetPasswordRequestDTO{+ Email: ownerEmail,+ Code: code,+ NewPassword: "resetpassword123",+ },+ http.StatusOK,+ )++ test_utils.MakePostRequest(+ t,+ router,+ "/api/v1/users/signin",+ "",+ users_dto.SignInRequestDTO{Email: ownerEmail, Password: "resetpassword123"},+ http.StatusOK,+ )+}++func Test_SignIn_WithUnknownAddressOnSingleUserInstance_DisclosesNothingAboutTheInstance(t *testing.T) {+ router := createUserTestRouter()+ users_testing.ResetSettingsToDefaults(t.Context())+ users_testing.DeleteAllUsers()+ claimInstanceViaAPI(t, router)++ response := signInViaAPI(+ t,+ router,+ "unknown"+uuid.New().String()+"@example.com",+ http.StatusBadRequest,+ )++ assert.NotContains(t, string(response.Body), "admin")+ assert.NotContains(t, string(response.Body), "1")+}++func Test_SignIn_WhenAccountHasNoPassword_IsRefusedLikeAWrongPassword(t *testing.T) {+ router := createUserTestRouter()+ users_testing.ResetSettingsToDefaults(t.Context())+ users_testing.RecreateInitialAdmin(t.Context())++ email := "oauth-only-" + uuid.New().String()[:8] + "@example.com"+ mockServer := newGitHubOAuthMockServer(email, int64(uuid.New().ID()))+ defer mockServer.Close()++ _, err := users_services.GetUserService().HandleGitHubOAuthWithMockEndpoint(+ t.Context(),+ "test-code",+ "http://localhost:3000/auth/callback",+ gitHubOAuthEndpoint(mockServer.URL),+ mockServer.URL+"/user",+ )+ require.NoError(t, err)++ response := signInViaAPI(t, router, email, http.StatusBadRequest)+ assert.Contains(t, string(response.Body), "password is incorrect")+}++func Test_SignIn_WhenAccountHasNotCompletedSignUp_IsRefused(t *testing.T) {+ router := createUserTestRouter()+ users_testing.ResetSettingsToDefaults(t.Context())++ inviter := users_testing.CreateTestUser(t.Context(), users_enums.UserRoleAdmin)+ invitedEmail := "invited" + uuid.New().String() + "@example.com"++ test_utils.MakePostRequest(+ t,+ router,+ "/api/v1/users/invite",+ "Bearer "+inviter.Token,+ users_dto.InviteUserRequestDTO{Email: invitedEmail},+ http.StatusOK,+ )++ response := signInViaAPI(t, router, invitedEmail, http.StatusBadRequest)+ assert.Contains(t, string(response.Body), "not passed sign up yet")+}++func Test_SignIn_WhenAccountIsDeactivated_IsRefused(t *testing.T) {+ managementRouter := createManagementTestRouter()+ userRouter := createUserTestRouter()+ users_testing.ResetSettingsToDefaults(t.Context())++ rootAdmin := users_testing.RecreateInitAdminAndGetAccess(t.Context())+ memberEmail := "deactivated" + uuid.New().String() + "@example.com"+ member := signUpViaAPI(t, userRouter, memberEmail)++ test_utils.MakePostRequest(+ t,+ managementRouter,+ "/api/v1/users/"+member.UserID.String()+"/deactivate",+ "Bearer "+rootAdmin.Token,+ nil,+ http.StatusOK,+ )++ response := signInViaAPI(t, userRouter, memberEmail, http.StatusBadRequest)+ assert.Contains(t, string(response.Body), "deactivated")+}++// Test_SignIn_WhenUpgradedInstanceStillUsesThePlaceholderAddress_Succeeds pins the+// half of the upgrade scenario a test can reach. SignInRequestDTO.Email binds+// `required` alone on purpose: adding `email` beside it, for symmetry with the+// registration DTO, would lock out every upgraded instance that has not yet moved+// off the placeholder. This test is what makes that edit fail.+func Test_SignIn_WhenUpgradedInstanceStillUsesThePlaceholderAddress_Succeeds(t *testing.T) {+ router := createUserTestRouter()+ users_testing.ResetSettingsToDefaults(t.Context())+ users_testing.DeleteAllUsers()++ repository := &users_repositories.UserRepository{}+ placeholderAdmin := &users_models.User{+ ID: uuid.New(),+ Email: "admin",+ Name: "Admin",+ PasswordCreationTime: time.Now().UTC(),+ CreatedAt: time.Now().UTC(),+ Role: users_enums.UserRoleAdmin,+ Status: users_enums.UserStatusActive,+ IsRootAdmin: true,+ }+ require.NoError(t, repository.CreateUser(placeholderAdmin))++ require.NoError(t, users_services.GetUserService().ChangeUserPasswordByEmail(+ t.Context(),+ "admin",+ bootstrapAdminPassword,+ ))++ test_utils.MakePostRequest(+ t,+ router,+ "/api/v1/users/signin",+ "",+ users_dto.SignInRequestDTO{Email: "admin", Password: bootstrapAdminPassword},+ http.StatusOK,+ )+}++// claimInstanceViaAPI empties the instance and registers the account that takes+// it, returning a token for the bootstrap administrator and its address.+func claimInstanceViaAPI(t *testing.T, router *gin.Engine) (users_dto.SignInResponseDTO, string) {+ t.Helper()++ users_testing.ResetSettingsToDefaults(t.Context())+ users_testing.DeleteAllUsers()++ email := "owner" + uuid.New().String() + "@example.com"++ var response users_dto.SignInResponseDTO+ test_utils.MakePostRequestAndUnmarshal(+ t,+ router,+ "/api/v1/users/signup",+ "",+ users_dto.SignUpRequestDTO{+ Email: email,+ Password: bootstrapAdminPassword,+ Name: "Owner",+ },+ http.StatusOK,+ &response,+ )++ return response, email+}++func signInViaAPI(+ t *testing.T,+ router *gin.Engine,+ email string,+ expectedStatus int,+) *test_utils.TestResponse {+ t.Helper()++ return test_utils.MakePostRequest(+ t,+ router,+ "/api/v1/users/signin",+ "",+ users_dto.SignInRequestDTO{Email: email, Password: bootstrapAdminPassword},+ expectedStatus,+ )+}diff --git a/backend/internal/features/users/dto/dto.go b/backend/internal/features/users/dto/dto.goindex dc092be4..94577196 100644--- a/backend/internal/features/users/dto/dto.go+++ b/backend/internal/features/users/dto/dto.go@@ -9,7 +9,7 @@ import ()type SignUpRequestDTO struct {- Email string `json:"email" binding:"required"`+ Email string `json:"email" binding:"required,email"`Password string `json:"password" binding:"required,min=8"`Name string `json:"name" binding:"required"`CloudflareTurnstileToken *string `json:"cloudflareTurnstileToken"`@@ -27,12 +27,10 @@ type SignInResponseDTO struct {Token string `json:"token"`}-type SetAdminPasswordRequestDTO struct {- Password string `json:"password" binding:"required,min=8"`-}--type IsAdminHasPasswordResponseDTO struct {- HasPassword bool `json:"hasPassword"`+// The wire name is isExist rather than hasAnyUser because the client already+// reads that key (frontend/src/entity/users/api/userApi.ts).+type HasAnyUserResponseDTO struct {+ HasAnyUser bool `json:"isExist"`}type ChangePasswordRequestDTO struct {diff --git a/backend/internal/features/users/models/user.go b/backend/internal/features/users/models/user.goindex 592b293b..4abe4f4d 100644--- a/backend/internal/features/users/models/user.go+++ b/backend/internal/features/users/models/user.go@@ -18,6 +18,7 @@ type User struct {Status users_enums.UserStatus `json:"status"`GitHubOAuthID *string `json:"-" gorm:"column:github_oauth_id"`GoogleOAuthID *string `json:"-" gorm:"column:google_oauth_id"`+ IsRootAdmin bool `json:"-" gorm:"column:is_root_admin"`CreatedAt time.Time `json:"createdAt"`}diff --git a/backend/internal/features/users/repositories/user_repository.go b/backend/internal/features/users/repositories/user_repository.goindex 4218b5ca..911e3de3 100644--- a/backend/internal/features/users/repositories/user_repository.go+++ b/backend/internal/features/users/repositories/user_repository.go@@ -3,7 +3,6 @@ package users_repositoriesimport ("context""errors"- "fmt""time""github.com/google/uuid"@@ -53,6 +52,23 @@ func (r *UserRepository) GetUserByID(ctx context.Context, userID uuid.UUID) (*usreturn &user, nil}+// The record lives in a column rather than in the text of an email address, so+// the account keeps it after its owner moves to a real one. Returns nil when no+// account holds the record yet.+func (r *UserRepository) GetRootAdmin(ctx context.Context) (*users_models.User, error) {+ var user users_models.User++ if err := storage.GetDb().WithContext(ctx).Where("is_root_admin").First(&user).Error; err != nil {+ if errors.Is(err, gorm.ErrRecordNotFound) {+ return nil, nil+ }++ return nil, err+ }++ return &user, nil+}+func (r *UserRepository) UpdateUserPassword(userID uuid.UUID, hashedPassword string) error {return storage.GetDb().Model(&users_models.User{}).Where("id = ?", userID).@@ -62,30 +78,6 @@ func (r *UserRepository) UpdateUserPassword(userID uuid.UUID, hashedPassword str}).Error}-func (r *UserRepository) CreateInitialAdmin(ctx context.Context) error {- admin, err := r.GetUserByEmail(ctx, "admin")- if err != nil {- return fmt.Errorf("failed to get admin user: %w", err)- }-- if admin != nil {- return nil- }-- admin = &users_models.User{- ID: uuid.New(),- Email: "admin",- Name: "Admin",- HashedPassword: nil,- PasswordCreationTime: time.Now().UTC(),- Role: users_enums.UserRoleAdmin,- Status: users_enums.UserStatusActive,- CreatedAt: time.Now().UTC(),- }-- return storage.GetDb().Create(admin).Error-}-func (r *UserRepository) GetUsers(ctx context.Context,limit, offset int,@@ -144,20 +136,17 @@ func (r *UserRepository) UpdateUserRole(userID uuid.UUID, role users_enums.UserR}).Error}-func (r *UserRepository) RenameUserEmailForTests(oldEmail, newEmail string) error {- result := storage.GetDb().Model(&users_models.User{}).- Where("email = ?", oldEmail).- Update("email", newEmail)-- if result.Error != nil {- return result.Error- }+func (r *UserRepository) GetAdmins(ctx context.Context) ([]*users_models.User, error) {+ var admins []*users_models.User- if result.RowsAffected == 0 {- return nil+ if err := storage.GetDb().WithContext(ctx).+ Where("role = ?", users_enums.UserRoleAdmin).+ Order("created_at ASC").+ Find(&admins).Error; err != nil {+ return nil, err}- return nil+ return admins, nil}func (r *UserRepository) UpdateUserInfo(userID uuid.UUID, name, email *string) error {diff --git a/backend/internal/features/users/services/admin_listing.go b/backend/internal/features/users/services/admin_listing.gonew file mode 100644index 00000000..c423a229--- /dev/null+++ b/backend/internal/features/users/services/admin_listing.go@@ -0,0 +1,60 @@+package users_services++import (+ "context"+ "fmt"+ "strings"++ users_models "databasus-backend/internal/features/users/models"+)++// NoAdminsMessage is what an instance nobody has registered on answers with. It+// is a sentence rather than an empty listing because the owner running the+// command is trying to find out why they cannot sign in.+const NoAdminsMessage = "This instance has no administrator: no account has been created on it yet."++// The active state is part of the answer because a deactivated administrator+// otherwise reads as an address that should work. Nothing else is rendered: no+// password, no password hash, no token.+//+// The listing writes no audit entry. It runs from the console, where no feature+// has installed an audit writer, and it must not acquire a code path that+// assumes one.+func (s *UserManagementService) RenderAdminListing(ctx context.Context) (string, error) {+ admins, err := s.userRepository.GetAdmins(ctx)+ if err != nil {+ return "", fmt.Errorf("failed to list administrators: %w", err)+ }++ if len(admins) == 0 {+ return NoAdminsMessage, nil+ }++ lines := make([]string, 0, len(admins))+ for _, admin := range admins {+ lines = append(lines, renderAdminLine(admin))+ }++ return strings.Join(lines, "\n"), nil+}++func renderAdminLine(admin *users_models.User) string {+ activeState := "inactive"+ if admin.IsActiveUser() {+ activeState = "active"+ }++ line := fmt.Sprintf(+ "%s | %s | created %s | %s",+ admin.Email,+ admin.Name,+ admin.CreatedAt.UTC().Format("2006-01-02"),+ activeState,+ )++ if admin.IsRootAdmin {+ line += " | bootstrap administrator"+ }++ return line+}diff --git a/backend/internal/features/users/services/admin_listing_test.go b/backend/internal/features/users/services/admin_listing_test.gonew file mode 100644index 00000000..8221585a--- /dev/null+++ b/backend/internal/features/users/services/admin_listing_test.go@@ -0,0 +1,67 @@+package users_services_test++import (+ "strings"+ "testing"++ "github.com/stretchr/testify/assert"+ "github.com/stretchr/testify/require"++ users_enums "databasus-backend/internal/features/users/enums"+ users_repositories "databasus-backend/internal/features/users/repositories"+ users_services "databasus-backend/internal/features/users/services"+ users_testing "databasus-backend/internal/features/users/testing"+)++func Test_RenderAdminListing_WithSeveralAdministrators_MarksTheBootstrapOneAndOmitsMembers(t *testing.T) {+ users_testing.DeleteAllUsers()++ bootstrapAdmin := users_testing.RecreateInitialAdmin(t.Context())+ ordinaryAdmin := users_testing.CreateTestUser(t.Context(), users_enums.UserRoleAdmin)+ deactivatedAdmin := users_testing.CreateTestUser(t.Context(), users_enums.UserRoleAdmin)+ member := users_testing.CreateTestUser(t.Context(), users_enums.UserRoleMember)++ require.NoError(t, (&users_repositories.UserRepository{}).UpdateUserStatus(+ deactivatedAdmin.UserID,+ users_enums.UserStatusInactive,+ ))++ listing, err := users_services.GetManagementService().RenderAdminListing(t.Context())+ require.NoError(t, err)++ assert.Contains(t, listing, bootstrapAdmin.Email+" |")+ assert.Contains(t, listing, ordinaryAdmin.Email+" |")+ assert.Contains(t, listing, deactivatedAdmin.Email+" |")+ assert.NotContains(t, listing, member.Email)++ assert.Contains(t, adminLineFor(t, listing, bootstrapAdmin.Email), "bootstrap administrator")+ assert.NotContains(t, adminLineFor(t, listing, ordinaryAdmin.Email), "bootstrap administrator")++ assert.Contains(t, adminLineFor(t, listing, deactivatedAdmin.Email), "inactive")+ assert.Contains(t, adminLineFor(t, listing, ordinaryAdmin.Email), "active")++ assert.NotContains(t, listing, "$2a$")+}++func Test_RenderAdminListing_WhenNobodyHasRegistered_ReportsNoAdministrator(t *testing.T) {+ users_testing.DeleteAllUsers()++ listing, err := users_services.GetManagementService().RenderAdminListing(t.Context())+ require.NoError(t, err)++ assert.Equal(t, users_services.NoAdminsMessage, listing)+}++func adminLineFor(t *testing.T, listing, email string) string {+ t.Helper()++ for _, line := range strings.Split(listing, "\n") {+ if strings.HasPrefix(line, email+" |") {+ return line+ }+ }++ t.Fatalf("no line for %s in listing:\n%s", email, listing)++ return ""+}diff --git a/backend/internal/features/users/services/management_service.go b/backend/internal/features/users/services/management_service.goindex cd77b745..05c1dc0d 100644--- a/backend/internal/features/users/services/management_service.go+++ b/backend/internal/features/users/services/management_service.go@@ -70,8 +70,8 @@ func (s *UserManagementService) DeactivateUser(return fmt.Errorf("failed to get user: %w", err)}- // Only user with email "admin" can deactivate ADMIN users- if user.Role == user_enums.UserRoleAdmin && deactivatedBy.Email != "admin" {+ // Only the instance's bootstrap administrator can deactivate ADMIN accounts+ if user.Role == user_enums.UserRoleAdmin && !deactivatedBy.IsRootAdmin {return errors.New("only the root admin user can deactivate admin accounts")}@@ -104,8 +104,8 @@ func (s *UserManagementService) ActivateUser(return fmt.Errorf("failed to get user: %w", err)}- // Only user with email "admin" can activate ADMIN users- if user.Role == user_enums.UserRoleAdmin && activatedBy.Email != "admin" {+ // Only the instance's bootstrap administrator can reactivate ADMIN accounts+ if user.Role == user_enums.UserRoleAdmin && !activatedBy.IsRootAdmin {return errors.New("only the root admin user can activate admin accounts")}@@ -149,9 +149,9 @@ func (s *UserManagementService) ChangeUserRole(return fmt.Errorf("failed to get user: %w", err)}- // Only user with email "admin" can promote users to ADMIN or demote ADMIN users+ // Only the instance's bootstrap administrator can grant or revoke the ADMIN roleif (newRole == user_enums.UserRoleAdmin || user.Role == user_enums.UserRoleAdmin) &&- changedBy.Email != "admin" {+ !changedBy.IsRootAdmin {return errors.New("only the root admin user can promote users to admin or demote admin users",)diff --git a/backend/internal/features/users/services/user_services.go b/backend/internal/features/users/services/user_services.goindex de5cae86..8cb93fd6 100644--- a/backend/internal/features/users/services/user_services.go+++ b/backend/internal/features/users/services/user_services.go@@ -13,6 +13,7 @@ import ("github.com/golang-jwt/jwt/v4""github.com/google/uuid"+ "github.com/jackc/pgx/v5/pgconn""golang.org/x/crypto/bcrypt""golang.org/x/oauth2""golang.org/x/oauth2/github"@@ -29,6 +30,11 @@ import (users_repositories "databasus-backend/internal/features/users/repositories")+// bootstrapAdminIndexName is the partial unique index that admits a single+// bootstrap administrator. Naming it is what lets a lost race be told apart from+// a duplicate address, which must keep failing as it always has.+const bootstrapAdminIndexName = "idx_users_is_root_admin"+type UserService struct {userRepository *users_repositories.UserRepositorysecretKeyService *secrets.SecretKeyService@@ -91,7 +97,7 @@ func (s *UserService) SignUp(ctx context.Context, request *users_dto.SignUpRequereturn nil, fmt.Errorf("failed to get updated user: %w", err)}- s.auditLogWriter.WriteAuditLog(ctx, audit_logs_models.AuditEntry{+ s.writeAuditLog(ctx, audit_logs_models.AuditEntry{Message: fmt.Sprintf("Invited user completed registration: %s", updatedUser.Email),UserID: &updatedUser.ID,WorkspaceID: nil,@@ -100,41 +106,33 @@ func (s *UserService) SignUp(ctx context.Context, request *users_dto.SignUpRequereturn updatedUser, nil}- // Get settings to check registration policy for new users- settings, err := s.settingsService.GetSettings(ctx)+ user, err := s.createAccountClaimingEmptyInstance(+ ctx,+ func(isTakingTheInstance bool) *users_models.User {+ return buildRegisteredUser(request, hashedPasswordStr, isTakingTheInstance)+ },+ )if err != nil {- return nil, fmt.Errorf("failed to get settings: %w", err)- }-- // Check if external registrations are allowed- if !settings.IsAllowExternalRegistrations {- return nil, errors.New("external registration is disabled")- }-- user := &users_models.User{- ID: uuid.New(),- Email: request.Email,- Name: request.Name,- HashedPassword: &hashedPasswordStr,- PasswordCreationTime: time.Now().UTC(),- Role: users_enums.UserRoleMember,- Status: users_enums.UserStatusActive,- CreatedAt: time.Now().UTC(),- }-- if err := s.userRepository.CreateUser(user); err != nil {- return nil, fmt.Errorf("failed to create user: %w", err)+ return nil, err}- s.auditLogWriter.WriteAuditLog(ctx, audit_logs_models.AuditEntry{+ s.writeAuditLog(ctx, audit_logs_models.AuditEntry{Message: fmt.Sprintf("User registered with email: %s", user.Email),UserID: &user.ID,WorkspaceID: nil,})+ s.writeInstanceClaimedAuditLog(ctx, user)+return user, nil}+func isBootstrapAdminTaken(err error) bool {+ var pgError *pgconn.PgError++ return errors.As(err, &pgError) && pgError.ConstraintName == bootstrapAdminIndexName+}+func (s *UserService) SignIn(ctx context.Context,request *users_dto.SignInRequestDTO,@@ -149,17 +147,6 @@ func (s *UserService) SignIn(}if user == nil {- usersCount, err := s.userRepository.GetUsersCount()- if err != nil {- return nil, fmt.Errorf("failed to get users count: %w", err)- }-- if usersCount == 1 {- return nil, errors.New(- "user with this email does not exist, seems you need to sign in as \"admin\"",- )- }-s.logger.WarnContext(ctx, "sign-in refused: no user with this email", "email", request.Email)return nil, errors.New("user with this email does not exist")@@ -178,6 +165,15 @@ func (s *UserService) SignIn(return nil, errors.New("user account is deactivated")}+ // An account created through an external identity provider has no password+ // hash at all. Refuse it the way a wrong password is refused, rather than+ // dereferencing nil and taking the process down.+ if !user.HasPassword() {+ s.logger.WarnContext(ctx, "sign-in refused: the account has no password", "user_id", user.ID)++ return nil, errors.New("password is incorrect")+ }+err = bcrypt.CompareHashAndPassword([]byte(*user.HashedPassword), []byte(request.Password))if err != nil {s.logger.WarnContext(ctx, "sign-in refused: incorrect password", "user_id", user.ID)@@ -192,7 +188,7 @@ func (s *UserService) SignIn(return nil, err}- s.auditLogWriter.WriteAuditLog(ctx, audit_logs_models.AuditEntry{+ s.writeAuditLog(ctx, audit_logs_models.AuditEntry{Message: fmt.Sprintf("User signed in with email: %s", user.Email),UserID: &user.ID,WorkspaceID: nil,@@ -288,59 +284,19 @@ func (s *UserService) GenerateAccessToken(}, nil}-func (s *UserService) CreateInitialAdmin(ctx context.Context) error {- return s.userRepository.CreateInitialAdmin(ctx)-}-func (s *UserService) GetUsersCount() (int64, error) {return s.userRepository.GetUsersCount()}-func (s *UserService) IsRootAdminHasPassword(ctx context.Context) (bool, error) {- admin, err := s.userRepository.GetUserByEmail(ctx, "admin")- if err != nil {- return false, fmt.Errorf("failed to get admin user: %w", err)- }-- if admin == nil {- return false, errors.New("admin user does not exist")- }-- return admin.HasPassword(), nil-}--func (s *UserService) SetRootAdminPassword(ctx context.Context, password string) error {- admin, err := s.userRepository.GetUserByEmail(ctx, "admin")- if err != nil {- return fmt.Errorf("failed to get admin user: %w", err)- }-- if admin == nil {- return errors.New("admin user does not exist")- }-- if admin.HasPassword() {- return errors.New("admin password is already set")- }-- hashedPassword, err := bcrypt.GenerateFromPassword([]byte(password), bcrypt.DefaultCost)+// The entry screen asks this to decide between offering a sign-in and offering+// the registration that claims the instance.+func (s *UserService) HasAnyUser() (bool, error) {+ isUnclaimed, err := s.isInstanceUnclaimed()if err != nil {- return fmt.Errorf("failed to hash password: %w", err)+ return false, err}- if err := s.userRepository.UpdateUserPassword(admin.ID, string(hashedPassword)); err != nil {- return fmt.Errorf("failed to set admin password: %w", err)- }-- if s.auditLogWriter != nil {- s.auditLogWriter.WriteAuditLog(ctx, audit_logs_models.AuditEntry{- Message: "Admin password set",- UserID: &admin.ID,- WorkspaceID: nil,- })- }-- return nil+ return !isUnclaimed, nil}func (s *UserService) ChangeUserPasswordByEmail(ctx context.Context, email, newPassword string) error {@@ -362,7 +318,7 @@ func (s *UserService) ChangeUserPassword(ctx context.Context, userID uuid.UUID,return fmt.Errorf("failed to update password: %w", err)}- s.auditLogWriter.WriteAuditLog(ctx, audit_logs_models.AuditEntry{+ s.writeAuditLog(ctx, audit_logs_models.AuditEntry{Message: "Password changed",UserID: &userID,WorkspaceID: nil,@@ -415,7 +371,7 @@ func (s *UserService) InviteUser(if request.IntendedWorkspaceID != nil {message += " for workspace"}- s.auditLogWriter.WriteAuditLog(ctx, audit_logs_models.AuditEntry{+ s.writeAuditLog(ctx, audit_logs_models.AuditEntry{Message: message,UserID: &invitedBy.ID,WorkspaceID: request.IntendedWorkspaceID,@@ -465,10 +421,6 @@ func (s *UserService) UpdateUserInfo(oldEmail := user.EmailoldName := user.Name- if user.Email == "admin" && request.Email != nil && *request.Email != user.Email {- return errors.New("admin email cannot be changed")- }-if request.Email != nil && *request.Email != user.Email {existingUser, err := s.userRepository.GetUserByEmail(ctx, *request.Email)if err != nil {@@ -499,14 +451,14 @@ func (s *UserService) UpdateUserInfo(if len(auditMessages) > 0 {for _, message := range auditMessages {- s.auditLogWriter.WriteAuditLog(ctx, audit_logs_models.AuditEntry{+ s.writeAuditLog(ctx, audit_logs_models.AuditEntry{Message: message,UserID: &userID,WorkspaceID: nil,})}} else {- s.auditLogWriter.WriteAuditLog(ctx, audit_logs_models.AuditEntry{+ s.writeAuditLog(ctx, audit_logs_models.AuditEntry{Message: "User info updated",UserID: &userID,WorkspaceID: nil,@@ -648,13 +600,11 @@ func (s *UserService) SendResetPasswordCode(ctx context.Context, email string) e}// Audit log- if s.auditLogWriter != nil {- s.auditLogWriter.WriteAuditLog(ctx, audit_logs_models.AuditEntry{- Message: fmt.Sprintf("Password reset code sent to: %s", user.Email),- UserID: &user.ID,- WorkspaceID: nil,- })- }+ s.writeAuditLog(ctx, audit_logs_models.AuditEntry{+ Message: fmt.Sprintf("Password reset code sent to: %s", user.Email),+ UserID: &user.ID,+ WorkspaceID: nil,+ })return nil}@@ -692,17 +642,160 @@ func (s *UserService) ResetPassword(ctx context.Context, email, code, newPasswor}// Audit log- if s.auditLogWriter != nil {- s.auditLogWriter.WriteAuditLog(ctx, audit_logs_models.AuditEntry{- Message: "Password reset via email code",- UserID: &user.ID,- WorkspaceID: nil,- })+ s.writeAuditLog(ctx, audit_logs_models.AuditEntry{+ Message: "Password reset via email code",+ UserID: &user.ID,+ WorkspaceID: nil,+ })++ return nil+}++// Every audit entry this service writes goes through here, because the console+// path reaches the service without installing a writer and a missing entry must+// not take the process down.+func (s *UserService) writeAuditLog(ctx context.Context, entry audit_logs_models.AuditEntry) {+ if s.auditLogWriter == nil {+ return+ }++ s.auditLogWriter.WriteAuditLog(ctx, entry)+}++func (s *UserService) isInstanceUnclaimed() (bool, error) {+ usersCount, err := s.userRepository.GetUsersCount()+ if err != nil {+ return false, fmt.Errorf("failed to get users count: %w", err)+ }++ return usersCount == 0, nil+}++func (s *UserService) checkExternalRegistrationAllowed(ctx context.Context) error {+ settings, err := s.settingsService.GetSettings(ctx)+ if err != nil {+ return fmt.Errorf("failed to get settings: %w", err)+ }++ if !settings.IsAllowExternalRegistrations {+ return errors.New("external registration is disabled")}return nil}+// Both entry points that insert a new account share this path. An instance+// holding no account hands the account the administrator role and records it as+// the bootstrap administrator, and the question is asked before the registration+// policy rather than inside the insert, because an empty instance whose policy+// forbids registration would otherwise never gain an administrator at all.+//+// Losing the race for that record is not a failure: the partial unique index+// admits one flagged account, so the loser is built again as an ordinary+// account - now under the registration policy it was allowed to skip.+func (s *UserService) createAccountClaimingEmptyInstance(+ ctx context.Context,+ build func(isTakingTheInstance bool) *users_models.User,+) (*users_models.User, error) {+ isTakingTheInstance, err := s.isInstanceUnclaimed()+ if err != nil {+ return nil, err+ }++ if !isTakingTheInstance {+ if err := s.checkExternalRegistrationAllowed(ctx); err != nil {+ return nil, err+ }+ }++ user := build(isTakingTheInstance)++ err = s.userRepository.CreateUser(user)+ if err == nil {+ return user, nil+ }++ // Anything but the contested bootstrap record - a duplicate address above all -+ // stays the failure it has always been.+ if !isTakingTheInstance || !isBootstrapAdminTaken(err) {+ return nil, fmt.Errorf("failed to create user: %w", err)+ }++ if err := s.checkExternalRegistrationAllowed(ctx); err != nil {+ return nil, err+ }++ user = build(false)++ if err := s.userRepository.CreateUser(user); err != nil {+ return nil, fmt.Errorf("failed to create user: %w", err)+ }++ return user, nil+}++func buildRegisteredUser(+ request *users_dto.SignUpRequestDTO,+ hashedPassword string,+ isTakingTheInstance bool,+) *users_models.User {+ return &users_models.User{+ ID: uuid.New(),+ Email: request.Email,+ Name: request.Name,+ HashedPassword: &hashedPassword,+ PasswordCreationTime: time.Now().UTC(),+ Role: roleForNewAccount(isTakingTheInstance),+ Status: users_enums.UserStatusActive,+ IsRootAdmin: isTakingTheInstance,+ CreatedAt: time.Now().UTC(),+ }+}++func buildOAuthUser(+ email, name string,+ githubOAuthID, googleOAuthID *string,+ isTakingTheInstance bool,+) *users_models.User {+ return &users_models.User{+ ID: uuid.New(),+ Email: email,+ Name: name,+ HashedPassword: nil,+ PasswordCreationTime: time.Now().UTC(),+ Role: roleForNewAccount(isTakingTheInstance),+ Status: users_enums.UserStatusActive,+ GitHubOAuthID: githubOAuthID,+ GoogleOAuthID: googleOAuthID,+ IsRootAdmin: isTakingTheInstance,+ CreatedAt: time.Now().UTC(),+ }+}++func roleForNewAccount(isTakingTheInstance bool) users_enums.UserRole {+ if isTakingTheInstance {+ return users_enums.UserRoleAdmin+ }++ return users_enums.UserRoleMember+}++// The log has to explain an administrator nobody appointed.+func (s *UserService) writeInstanceClaimedAuditLog(ctx context.Context, user *users_models.User) {+ if !user.IsRootAdmin {+ return+ }++ s.writeAuditLog(ctx, audit_logs_models.AuditEntry{+ Message: fmt.Sprintf(+ "First account on the instance now administers it: %s",+ user.Email,+ ),+ UserID: &user.ID,+ WorkspaceID: nil,+ })+}+func (s *UserService) handleGitHubOAuthWithEndpoint(ctx context.Context,code, redirectUri string,@@ -873,13 +966,11 @@ func (s *UserService) getOrCreateUserFromOAuth(return nil, err}- if s.auditLogWriter != nil {- s.auditLogWriter.WriteAuditLog(ctx, audit_logs_models.AuditEntry{- Message: fmt.Sprintf("User signed in via %s", provider),- UserID: &existingUser.ID,- WorkspaceID: nil,- })- }+ s.writeAuditLog(ctx, audit_logs_models.AuditEntry{+ Message: fmt.Sprintf("User signed in via %s", provider),+ UserID: &existingUser.ID,+ WorkspaceID: nil,+ })return &users_dto.OAuthCallbackResponseDTO{UserID: tokenResponse.UserID,@@ -927,13 +1018,11 @@ func (s *UserService) getOrCreateUserFromOAuth(return nil, err}- if s.auditLogWriter != nil {- s.auditLogWriter.WriteAuditLog(ctx, audit_logs_models.AuditEntry{- Message: fmt.Sprintf("%s OAuth linked to existing account", provider),- UserID: &user.ID,- WorkspaceID: nil,- })- }+ s.writeAuditLog(ctx, audit_logs_models.AuditEntry{+ Message: fmt.Sprintf("%s OAuth linked to existing account", provider),+ UserID: &user.ID,+ WorkspaceID: nil,+ })return &users_dto.OAuthCallbackResponseDTO{UserID: tokenResponse.UserID,@@ -943,15 +1032,6 @@ func (s *UserService) getOrCreateUserFromOAuth(}, nil}- settings, err := s.settingsService.GetSettings(ctx)- if err != nil {- return nil, fmt.Errorf("failed to get settings: %w", err)- }-- if !settings.IsAllowExternalRegistrations {- return nil, errors.New("external registration is disabled")- }-var githubOAuthID *stringvar googleOAuthID *stringif provider == "github" {@@ -960,21 +1040,14 @@ func (s *UserService) getOrCreateUserFromOAuth(googleOAuthID = &oauthID}- newUser := &users_models.User{- ID: uuid.New(),- Email: email,- Name: name,- HashedPassword: nil,- PasswordCreationTime: time.Now().UTC(),- Role: users_enums.UserRoleMember,- Status: users_enums.UserStatusActive,- GitHubOAuthID: githubOAuthID,- GoogleOAuthID: googleOAuthID,- CreatedAt: time.Now().UTC(),- }-- if err := s.userRepository.CreateUser(newUser); err != nil {- return nil, fmt.Errorf("failed to create user: %w", err)+ newUser, err := s.createAccountClaimingEmptyInstance(+ ctx,+ func(isTakingTheInstance bool) *users_models.User {+ return buildOAuthUser(email, name, githubOAuthID, googleOAuthID, isTakingTheInstance)+ },+ )+ if err != nil {+ return nil, err}tokenResponse, err := s.GenerateAccessToken(ctx, newUser)@@ -982,13 +1055,13 @@ func (s *UserService) getOrCreateUserFromOAuth(return nil, err}- if s.auditLogWriter != nil {- s.auditLogWriter.WriteAuditLog(ctx, audit_logs_models.AuditEntry{- Message: fmt.Sprintf("User registered via %s OAuth: %s", provider, email),- UserID: &newUser.ID,- WorkspaceID: nil,- })- }+ s.writeAuditLog(ctx, audit_logs_models.AuditEntry{+ Message: fmt.Sprintf("User registered via %s OAuth: %s", provider, email),+ UserID: &newUser.ID,+ WorkspaceID: nil,+ })++ s.writeInstanceClaimedAuditLog(ctx, newUser)return &users_dto.OAuthCallbackResponseDTO{UserID: tokenResponse.UserID,diff --git a/backend/internal/features/users/testing/audit_log_utils.go b/backend/internal/features/users/testing/audit_log_utils.gonew file mode 100644index 00000000..7078f00e--- /dev/null+++ b/backend/internal/features/users/testing/audit_log_utils.go@@ -0,0 +1,77 @@+package users_testing++import (+ "context"+ "strings"+ "sync"++ audit_logs_models "databasus-backend/internal/features/audit_logs/models"+)++// A test asserts that an action was recorded instead of discarding it.+type RecordingAuditLogWriter struct {+ mutex sync.Mutex+ entries []audit_logs_models.AuditEntry+}++func (w *RecordingAuditLogWriter) WriteAuditLog(_ context.Context, entry audit_logs_models.AuditEntry) {+ w.mutex.Lock()+ defer w.mutex.Unlock()++ w.entries = append(w.entries, entry)+}++func (w *RecordingAuditLogWriter) GetEntries() []audit_logs_models.AuditEntry {+ w.mutex.Lock()+ defer w.mutex.Unlock()++ return append([]audit_logs_models.AuditEntry(nil), w.entries...)+}++// Callers match fragments rather than the whole list because the setup a test+// needs first - creating an account, signing in - writes entries of its own.+func (w *RecordingAuditLogWriter) HasEntryContaining(fragments ...string) bool {+ for _, entry := range w.GetEntries() {+ if containsAll(entry.Message, fragments) {+ return true+ }+ }++ return false+}++func containsAll(message string, fragments []string) bool {+ for _, fragment := range fragments {+ if !strings.Contains(message, fragment) {+ return false+ }+ }++ return true+}++var (+ currentAuditLogRecorder = &RecordingAuditLogWriter{}+ currentAuditLogRecorderMutex sync.Mutex+)++// InstallAuditLogRecorder hands out a fresh recorder and makes it the one+// GetAuditLogRecorder returns. Test routers install one each time they are built,+// so a test never reads the entries another test left behind.+func InstallAuditLogRecorder() *RecordingAuditLogWriter {+ recorder := &RecordingAuditLogWriter{}++ currentAuditLogRecorderMutex.Lock()+ defer currentAuditLogRecorderMutex.Unlock()++ currentAuditLogRecorder = recorder++ return recorder+}++func GetAuditLogRecorder() *RecordingAuditLogWriter {+ currentAuditLogRecorderMutex.Lock()+ defer currentAuditLogRecorderMutex.Unlock()++ return currentAuditLogRecorder+}diff --git a/backend/internal/features/users/testing/user_utils.go b/backend/internal/features/users/testing/user_utils.goindex 33873b2a..94c18a34 100644--- a/backend/internal/features/users/testing/user_utils.go+++ b/backend/internal/features/users/testing/user_utils.go@@ -13,29 +13,11 @@ import (users_models "databasus-backend/internal/features/users/models"users_repositories "databasus-backend/internal/features/users/repositories"users_services "databasus-backend/internal/features/users/services"+ "databasus-backend/internal/storage")func CreateTestUser(ctx context.Context, role users_enums.UserRole) *users_dto.SignInResponseDTO {- userID := uuid.New()- email := fmt.Sprintf("%s-%[email protected]", strings.ToLower(string(role)), userID.String()[:8])-- hashedPassword := "$2a$10$test"- user := &users_models.User{- ID: userID,- Email: email,- Name: "Test User",- HashedPassword: &hashedPassword,- PasswordCreationTime: time.Now().UTC(),- CreatedAt: time.Now().UTC(),- Role: role,- Status: users_enums.UserStatusActive,- }-- userRepository := &users_repositories.UserRepository{}- err := userRepository.CreateUser(user)- if err != nil {- panic(err)- }+ user := insertTestUser(role, false)response, err := users_services.GetUserService().GenerateAccessToken(ctx, user)if err != nil {@@ -47,33 +29,69 @@ func CreateTestUser(ctx context.Context, role users_enums.UserRole) *users_dto.Sreturn response}+// The token is minted from the account RecreateInitialAdmin just created rather+// than read back by address, which would hand a nil user to GenerateAccessToken+// once that address changes.func RecreateInitAdminAndGetAccess(ctx context.Context) *users_dto.SignInResponseDTO {- RecreateInitialAdmin(ctx)-- userRepository := &users_repositories.UserRepository{}- user, err := userRepository.GetUserByEmail(ctx, "admin")- if err != nil {- panic(err)- }+ user := RecreateInitialAdmin(ctx)response, err := users_services.GetUserService().GenerateAccessToken(ctx, user)if err != nil {panic(err)}+ response.Email = user.Email+return response}-func RecreateInitialAdmin(ctx context.Context) {- userRepository := &users_repositories.UserRepository{}- err := userRepository.RenameUserEmailForTests("admin", "admin-"+uuid.New().String())+// The outgoing account is found by the bootstrap-administrator record, not by+// its address: a test that moves the bootstrap administrator to a real address+// would otherwise leave the record behind, and the partial unique index would+// refuse the next bootstrap account.+func RecreateInitialAdmin(ctx context.Context) *users_models.User {+ err := storage.GetDb().WithContext(ctx).Model(&users_models.User{}).+ Where("is_root_admin").+ Updates(map[string]any{+ "email": "retired-admin-" + uuid.New().String(),+ "is_root_admin": false,+ }).Errorif err != nil {- panic(err)+ panic(fmt.Errorf("failed to retire the current bootstrap administrator: %w", err))}- userService := users_services.GetUserService()- err = userService.CreateInitialAdmin(ctx)- if err != nil {- panic(err)+ return insertTestUser(users_enums.UserRoleAdmin, true)+}++// No test may assume an instance that holds no account: the per-run slot+// databases are shared across packages and carry whatever earlier ones left in+// them, so a test keyed on the account-creation rule has to say so.+func DeleteAllUsers() {+ if err := storage.GetDb().Exec("DELETE FROM users").Error; err != nil {+ panic(fmt.Errorf("failed to empty the users table: %w", err))+ }+}++func insertTestUser(role users_enums.UserRole, isRootAdmin bool) *users_models.User {+ userID := uuid.New()+ hashedPassword := "$2a$10$test"++ user := &users_models.User{+ ID: userID,+ Email: fmt.Sprintf("%s-%[email protected]", strings.ToLower(string(role)), userID.String()[:8]),+ Name: "Test User",+ HashedPassword: &hashedPassword,+ PasswordCreationTime: time.Now().UTC(),+ CreatedAt: time.Now().UTC(),+ Role: role,+ Status: users_enums.UserStatusActive,+ IsRootAdmin: isRootAdmin,+ }++ userRepository := &users_repositories.UserRepository{}+ if err := userRepository.CreateUser(user); err != nil {+ panic(fmt.Errorf("failed to create a test user: %w", err))}++ return user}diff --git a/backend/internal/features/users/testing/user_utils_test.go b/backend/internal/features/users/testing/user_utils_test.gonew file mode 100644index 00000000..9cce3822--- /dev/null+++ b/backend/internal/features/users/testing/user_utils_test.go@@ -0,0 +1,62 @@+package users_testing_test++import (+ "errors"+ "testing"+ "time"++ "github.com/google/uuid"+ "github.com/jackc/pgx/v5/pgconn"+ "github.com/stretchr/testify/assert"+ "github.com/stretchr/testify/require"++ users_enums "databasus-backend/internal/features/users/enums"+ users_models "databasus-backend/internal/features/users/models"+ users_repositories "databasus-backend/internal/features/users/repositories"+ users_testing "databasus-backend/internal/features/users/testing"+)++func Test_RecreateInitialAdmin_WhenBootstrapAddressHasChanged_MovesRecordToFreshAccount(t *testing.T) {+ repository := &users_repositories.UserRepository{}+ outgoingAdmin := users_testing.RecreateInitialAdmin(t.Context())++ changedEmail := "owner-" + uuid.New().String() + "@example.com"+ require.NoError(t, repository.UpdateUserInfo(outgoingAdmin.ID, nil, &changedEmail))++ freshAdmin := users_testing.RecreateInitialAdmin(t.Context())++ rootAdmin, err := repository.GetRootAdmin(t.Context())+ require.NoError(t, err)+ require.NotNil(t, rootAdmin)+ assert.Equal(t, freshAdmin.ID, rootAdmin.ID)++ retiredAdmin, err := repository.GetUserByID(t.Context(), outgoingAdmin.ID)+ require.NoError(t, err)+ assert.False(t, retiredAdmin.IsRootAdmin)+ assert.NotEqual(t, changedEmail, retiredAdmin.Email)+}++func Test_CreateUser_WhenInstanceAlreadyHasBootstrapAdmin_DatabaseRefusesSecondOne(t *testing.T) {+ users_testing.RecreateInitialAdmin(t.Context())++ hashedPassword := "$2a$10$test"+ secondRootAdmin := &users_models.User{+ ID: uuid.New(),+ Email: "second-root-admin-" + uuid.New().String() + "@example.com",+ Name: "Second Root Admin",+ HashedPassword: &hashedPassword,+ PasswordCreationTime: time.Now().UTC(),+ CreatedAt: time.Now().UTC(),+ Role: users_enums.UserRoleAdmin,+ Status: users_enums.UserStatusActive,+ IsRootAdmin: true,+ }++ err := (&users_repositories.UserRepository{}).CreateUser(secondRootAdmin)++ require.Error(t, err)++ var pgError *pgconn.PgError+ require.True(t, errors.As(err, &pgError))+ assert.Equal(t, "idx_users_is_root_admin", pgError.ConstraintName)+}diff --git a/backend/migrations/20260920125147_add_is_root_admin_to_users.sql b/backend/migrations/20260920125147_add_is_root_admin_to_users.sqlnew file mode 100644index 00000000..e2069069--- /dev/null+++ b/backend/migrations/20260920125147_add_is_root_admin_to_users.sql@@ -0,0 +1,57 @@+-- +goose Up+-- +goose StatementBegin++-- The instance recognizes its bootstrap administrator by this flag rather than+-- by the text of an email address, so that account can be renamed freely.+ALTER TABLE users ADD COLUMN is_root_admin BOOLEAN NOT NULL DEFAULT FALSE;++-- At most one account may carry the flag. This also settles the race between+-- two registrations arriving on an empty instance at the same moment: the+-- database admits one of them and refuses the other.+CREATE UNIQUE INDEX idx_users_is_root_admin ON users (is_root_admin) WHERE is_root_admin;++-- Drop the account previous versions seeded at startup when nobody ever signed+-- in as it - no password and no linked identity - and it is the only row the+-- instance holds. Such an instance is then indistinguishable from a fresh one,+-- and the first account created on it administers it.+--+-- The "only row" condition matters: an instance can hold ordinary members while+-- its seeded account was never claimed, because POST /users/signup answers+-- regardless of what the authentication screen offers. There the seeded row is+-- the only ADMIN-role account, so deleting it would leave those members with no+-- administrator and no way to appoint one. It is kept and flagged instead, and+-- its owner takes it over with the password-reset console command.+DELETE FROM users+WHERE email = 'admin'+ AND hashed_password IS NULL+ AND github_oauth_id IS NULL+ AND google_oauth_id IS NULL+ AND (SELECT COUNT(*) FROM users) = 1;++-- Carry the record onto the account the owner already signs in with: the seeded+-- row when it is still there, and otherwise the oldest administrator, which is+-- what an instance whose seeded row was renamed by hand looks like. An empty+-- database backfills nothing.+UPDATE users+SET is_root_admin = TRUE+WHERE id = (+ SELECT id+ FROM users+ WHERE role = 'ADMIN'+ ORDER BY (email = 'admin') DESC, created_at ASC+ LIMIT 1+);++-- +goose StatementEnd++-- +goose Down+-- +goose StatementBegin++-- The seeded account the up step deleted is not restored: an instance that was+-- never claimed rolls back to a state where the old binary seeds it again at+-- startup, which is exactly where it was.+DROP INDEX IF EXISTS idx_users_is_root_admin;++ALTER TABLE users DROP COLUMN IF EXISTS is_root_admin;++-- +goose StatementEnddiff --git a/frontend/src/entity/users/api/userApi.ts b/frontend/src/entity/users/api/userApi.tsindex 2a520d5d..877e7659 100644--- a/frontend/src/entity/users/api/userApi.ts+++ b/frontend/src/entity/users/api/userApi.ts@@ -5,12 +5,10 @@ import { apiHelper } from '../../../shared/api/apiHelper';import type { ChangePasswordRequest } from '../model/ChangePasswordRequest';import type { InviteUserRequest } from '../model/InviteUserRequest';import type { InviteUserResponse } from '../model/InviteUserResponse';-import type { IsAdminHasPasswordResponse } from '../model/IsAdminHasPasswordResponse';import type { OAuthCallbackRequest } from '../model/OAuthCallbackRequest';import type { OAuthCallbackResponse } from '../model/OAuthCallbackResponse';import type { ResetPasswordRequest } from '../model/ResetPasswordRequest';import type { SendResetPasswordCodeRequest } from '../model/SendResetPasswordCodeRequest';-import type { SetAdminPasswordRequest } from '../model/SetAdminPasswordRequest';import type { SignInRequest } from '../model/SignInRequest';import type { SignInResponse } from '../model/SignInResponse';import type { SignUpRequest } from '../model/SignUpRequest';@@ -73,23 +71,6 @@ export const userApi = {});},- async isAdminHasPassword(): Promise<IsAdminHasPasswordResponse> {- const requestOptions: RequestOptions = new RequestOptions();- return apiHelper.fetchGetJson(- `${getApplicationServer()}/api/v1/users/admin/has-password`,- requestOptions,- );- },-- async setAdminPassword(request: SetAdminPasswordRequest): Promise<{ message: string }> {- const requestOptions: RequestOptions = new RequestOptions();- requestOptions.setBody(JSON.stringify(request));- return apiHelper.fetchPostJson(- `${getApplicationServer()}/api/v1/users/admin/set-password`,- requestOptions,- );- },-async changePassword(request: ChangePasswordRequest): Promise<{ message: string }> {const requestOptions: RequestOptions = new RequestOptions();requestOptions.setBody(JSON.stringify(request));diff --git a/frontend/src/entity/users/index.ts b/frontend/src/entity/users/index.tsindex 9a132a9b..85147f19 100644--- a/frontend/src/entity/users/index.ts+++ b/frontend/src/entity/users/index.ts@@ -7,8 +7,6 @@ export { userManagementApi } from './api/userManagementApi';export type { SignInRequest } from './model/SignInRequest';export type { SignInResponse } from './model/SignInResponse';export type { SignUpRequest } from './model/SignUpRequest';-export type { SetAdminPasswordRequest } from './model/SetAdminPasswordRequest';-export type { IsAdminHasPasswordResponse } from './model/IsAdminHasPasswordResponse';export type { ChangePasswordRequest } from './model/ChangePasswordRequest';export type { InviteUserRequest } from './model/InviteUserRequest';export type { InviteUserResponse } from './model/InviteUserResponse';diff --git a/frontend/src/entity/users/model/IsAdminHasPasswordResponse.ts b/frontend/src/entity/users/model/IsAdminHasPasswordResponse.tsdeleted file mode 100644index 3d00c3bd..00000000--- a/frontend/src/entity/users/model/IsAdminHasPasswordResponse.ts+++ /dev/null@@ -1,3 +0,0 @@-export interface IsAdminHasPasswordResponse {- hasPassword: boolean;-}diff --git a/frontend/src/entity/users/model/SetAdminPasswordRequest.ts b/frontend/src/entity/users/model/SetAdminPasswordRequest.tsdeleted file mode 100644index c5f0b88a..00000000--- a/frontend/src/entity/users/model/SetAdminPasswordRequest.ts+++ /dev/null@@ -1,3 +0,0 @@-export interface SetAdminPasswordRequest {- password: string;-}diff --git a/frontend/src/features/users/index.ts b/frontend/src/features/users/index.tsindex e86e1b7e..459da774 100644--- a/frontend/src/features/users/index.ts+++ b/frontend/src/features/users/index.ts@@ -1,4 +1,3 @@-export { AdminPasswordComponent } from './ui/AdminPasswordComponent';export { AuthNavbarComponent } from './ui/AuthNavbarComponent';export { ProfileComponent } from './ui/ProfileComponent';export { RequestResetPasswordComponent } from './ui/RequestResetPasswordComponent';diff --git a/frontend/src/features/users/ui/AdminPasswordComponent.tsx b/frontend/src/features/users/ui/AdminPasswordComponent.tsxdeleted file mode 100644index 7c0a035b..00000000--- a/frontend/src/features/users/ui/AdminPasswordComponent.tsx+++ /dev/null@@ -1,147 +0,0 @@-import { EyeInvisibleOutlined, EyeTwoTone } from '@ant-design/icons';-import { App, Button, Input } from 'antd';-import { type JSX, useState } from 'react';-import { useTranslation } from 'react-i18next';--import { userApi } from '../../../entity/users';-import { translateApiError } from '../../../shared/i18n';--interface AdminPasswordComponentProps {- onPasswordSet?: () => void;-}--export function AdminPasswordComponent({- onPasswordSet,-}: AdminPasswordComponentProps): JSX.Element {- const { t } = useTranslation();- const { message } = App.useApp();- const [password, setPassword] = useState('');- const [passwordVisible, setPasswordVisible] = useState(false);- const [confirmPassword, setConfirmPassword] = useState('');- const [confirmPasswordVisible, setConfirmPasswordVisible] = useState(false);-- const [isLoading, setLoading] = useState(false);-- const [passwordError, setPasswordError] = useState(false);- const [confirmPasswordError, setConfirmPasswordError] = useState(false);-- const [adminPasswordError, setAdminPasswordError] = useState<unknown>();-- const validateFields = (): boolean => {- if (!password) {- setPasswordError(true);- return false;- }-- if (password.length < 8) {- setPasswordError(true);- message.error(t('users.validation.passwordTooShort', { minLength: 8 }));- return false;- }- setPasswordError(false);-- if (!confirmPassword) {- setConfirmPasswordError(true);- return false;- }- if (password !== confirmPassword) {- setConfirmPasswordError(true);- return false;- }- setConfirmPasswordError(false);-- return true;- };-- const onSetPassword = async () => {- setAdminPasswordError(undefined);-- if (validateFields()) {- setLoading(true);-- try {- await userApi.setAdminPassword({- password,- });-- // Automatically sign in as admin after setting password- await userApi.signIn({- // eslint-disable-next-line i18next/no-literal-string -- login of the built-in admin account- email: 'admin',- password,- });-- // Notify parent component that password was set successfully- onPasswordSet?.();- } catch (e) {- setAdminPasswordError(e);- }- }-- setLoading(false);- };-- return (- <div className="w-full max-w-[300px]">- <div className="mb-5 text-center text-2xl font-bold">{t('users.adminPassword.title')}</div>-- <div className="mx-auto mb-4 max-w-[250px] text-center text-sm text-gray-600 dark:text-gray-400">- {t('users.adminPassword.description')}- </div>-- <div className="my-1 text-xs font-semibold">{t('users.fields.email')}</div>- <Input value="admin" disabled />-- <div className="my-1 text-xs font-semibold">{t('common.fields.password')}</div>- <Input.Password- placeholder="********"- value={password}- onChange={(e) => {- setPasswordError(false);- setPassword(e.currentTarget.value);- }}- status={passwordError ? 'error' : undefined}- iconRender={(visible) => (visible ? <EyeTwoTone /> : <EyeInvisibleOutlined />)}- visibilityToggle={{ visible: passwordVisible, onVisibleChange: setPasswordVisible }}- autoComplete="new-password"- />-- <div className="my-1 text-xs font-semibold">{t('users.fields.confirmPassword')}</div>- <Input.Password- placeholder="********"- value={confirmPassword}- status={confirmPasswordError ? 'error' : undefined}- onChange={(e) => {- setConfirmPasswordError(false);- setConfirmPassword(e.currentTarget.value);- }}- iconRender={(visible) => (visible ? <EyeTwoTone /> : <EyeInvisibleOutlined />)}- autoComplete="new-password"- visibilityToggle={{- visible: confirmPasswordVisible,- onVisibleChange: setConfirmPasswordVisible,- }}- />-- <div className="mt-3" />-- <Button- disabled={isLoading}- loading={isLoading}- className="w-full"- onClick={() => {- onSetPassword();- }}- type="primary"- >- {t('users.adminPassword.submit')}- </Button>-- {adminPasswordError !== undefined && (- <div className="mt-3 flex justify-center text-center text-sm text-red-600">- {translateApiError(adminPasswordError, t)}- </div>- )}- </div>- );-}diff --git a/frontend/src/features/users/ui/ProfileComponent.tsx b/frontend/src/features/users/ui/ProfileComponent.tsxindex d7a5babe..3504327c 100644--- a/frontend/src/features/users/ui/ProfileComponent.tsx+++ b/frontend/src/features/users/ui/ProfileComponent.tsx@@ -134,15 +134,12 @@ export function ProfileComponent({ contentHeight }: Props) {}setEditNameError(false);- // Validate email (only if not admin)- if (user?.email !== 'admin') {- if (!editEmail || editEmail.trim() === '') {- setEditEmailError(true);- message.error(t('users.validation.emailRequired'));- return;- }- setEditEmailError(false);+ if (!editEmail || editEmail.trim() === '') {+ setEditEmailError(true);+ message.error(t('users.validation.emailRequired'));+ return;}+ setEditEmailError(false);setIsUpdatingProfile(true);@@ -153,8 +150,7 @@ export function ProfileComponent({ contentHeight }: Props) {if (editName !== user?.name) {request.name = editName;}- // Only include email if not admin and changed- if (user?.email !== 'admin' && editEmail !== user?.email) {+ if (editEmail !== user?.email) {request.email = editEmail;}@@ -231,13 +227,7 @@ export function ProfileComponent({ contentHeight }: Props) {placeholder={t('users.profile.emailPlaceholder')}type="email"className="mb-4"- disabled={user.email === 'admin'}/>- {user.email === 'admin' && (- <div className="mb-4 text-xs text-gray-500 dark:text-gray-400">- {t('users.profile.adminEmailReadOnly')}- </div>- )}<div className="mt-2 mb-1 text-xs font-semibold dark:text-gray-200">{t('users.profile.role')}diff --git a/frontend/src/features/users/ui/SignInComponent.tsx b/frontend/src/features/users/ui/SignInComponent.tsxindex d51555fd..37a13031 100644--- a/frontend/src/features/users/ui/SignInComponent.tsx+++ b/frontend/src/features/users/ui/SignInComponent.tsx@@ -47,6 +47,8 @@ export function SignInComponent({return false;}+ // 'admin' is not an address, but an instance created before the first account+ // administered it still signs in with that login until its owner replaces it.if (!FormValidator.isValidEmail(email) && email !== 'admin') {setEmailError(true);return false;diff --git a/frontend/src/features/users/ui/SignUpComponent.tsx b/frontend/src/features/users/ui/SignUpComponent.tsxindex 04f53c67..915b1e4a 100644--- a/frontend/src/features/users/ui/SignUpComponent.tsx+++ b/frontend/src/features/users/ui/SignUpComponent.tsx@@ -19,9 +19,13 @@ import { GoogleOAuthComponent } from './oauth/GoogleOAuthComponent';interface SignUpComponentProps {onSwitchToSignIn?: () => void;+ isClaimingInstance?: boolean;}-export function SignUpComponent({ onSwitchToSignIn }: SignUpComponentProps): JSX.Element {+export function SignUpComponent({+ onSwitchToSignIn,+ isClaimingInstance,+}: SignUpComponentProps): JSX.Element {const { t } = useTranslation();const { message } = App.useApp();const [name, setName] = useState('');@@ -111,6 +115,12 @@ export function SignUpComponent({ onSwitchToSignIn }: SignUpComponentProps): JSX<div className="w-full max-w-[300px]"><div className="mb-5 text-center text-2xl font-bold">{t('users.signUp.title')}</div>+ {isClaimingInstance && (+ <div className="mb-5 text-center text-sm text-gray-600 dark:text-gray-400">+ {t('users.signUp.administersInstance')}+ </div>+ )}+<div className="mt-4"><div className="space-y-2"><GithubOAuthComponent />diff --git a/frontend/src/pages/AuthPageComponent.tsx b/frontend/src/pages/AuthPageComponent.tsxindex ea12b8c8..1edac6e9 100644--- a/frontend/src/pages/AuthPageComponent.tsx+++ b/frontend/src/pages/AuthPageComponent.tsx@@ -5,7 +5,6 @@ import { useTranslation } from 'react-i18next';import { userApi } from '../entity/users';import {- AdminPasswordComponent,AuthNavbarComponent,RequestResetPasswordComponent,ResetPasswordComponent,@@ -17,7 +16,7 @@ import { translateApiError } from '../shared/i18n';export function AuthPageComponent() {const { t } = useTranslation();- const [isAdminHasPassword, setIsAdminHasPassword] = useState(false);+ const [isAnyUserExist, setIsAnyUserExist] = useState(true);const [authMode, setAuthMode] = useState<'signIn' | 'signUp' | 'requestReset' | 'resetPassword'>('signUp',);@@ -25,22 +24,19 @@ export function AuthPageComponent() {const [isLoading, setLoading] = useState(true);const screenHeight = useScreenHeight();- const checkAdminPasswordStatus = () => {+ useEffect(() => {setLoading(true);userApi- .isAdminHasPassword()- .then((response) => {- setIsAdminHasPassword(response.hasPassword);+ .isAnyUserExists()+ .then((isExist) => {+ setIsAnyUserExist(isExist);setLoading(false);}).catch((e) => {- alert(t('app.auth.adminPasswordCheckFailed', { error: translateApiError(e, t) }));+ alert(t('app.auth.accountsCheckFailed', { error: translateApiError(e, t) }));+ setLoading(false);});- };-- useEffect(() => {- checkAdminPasswordStatus();}, []);return (@@ -55,31 +51,30 @@ export function AuthPageComponent() {<AuthNavbarComponent /><div className="mt-10 flex justify-center sm:mt-[10vh]">- {isAdminHasPassword ? (- authMode === 'signUp' ? (- <SignUpComponent onSwitchToSignIn={() => setAuthMode('signIn')} />- ) : authMode === 'signIn' ? (- <SignInComponent- onSwitchToSignUp={() => setAuthMode('signUp')}- onSwitchToResetPassword={() => setAuthMode('requestReset')}- />- ) : authMode === 'requestReset' ? (- <RequestResetPasswordComponent- onSwitchToSignIn={() => setAuthMode('signIn')}- onSwitchToResetPassword={(email) => {- setResetEmail(email);- setAuthMode('resetPassword');- }}- />- ) : (- <ResetPasswordComponent- onSwitchToSignIn={() => setAuthMode('signIn')}- onSwitchToRequestCode={() => setAuthMode('requestReset')}- initialEmail={resetEmail}- />- )+ {authMode === 'signUp' ? (+ <SignUpComponent+ onSwitchToSignIn={isAnyUserExist ? () => setAuthMode('signIn') : undefined}+ isClaimingInstance={!isAnyUserExist}+ />+ ) : authMode === 'signIn' ? (+ <SignInComponent+ onSwitchToSignUp={() => setAuthMode('signUp')}+ onSwitchToResetPassword={() => setAuthMode('requestReset')}+ />+ ) : authMode === 'requestReset' ? (+ <RequestResetPasswordComponent+ onSwitchToSignIn={() => setAuthMode('signIn')}+ onSwitchToResetPassword={(email) => {+ setResetEmail(email);+ setAuthMode('resetPassword');+ }}+ />) : (- <AdminPasswordComponent onPasswordSet={checkAdminPasswordStatus} />+ <ResetPasswordComponent+ onSwitchToSignIn={() => setAuthMode('signIn')}+ onSwitchToRequestCode={() => setAuthMode('requestReset')}+ initialEmail={resetEmail}+ />)}</div></div>diff --git a/frontend/src/shared/i18n/locales/en.ts b/frontend/src/shared/i18n/locales/en.tsindex 62b7bcb7..580fdc7b 100644--- a/frontend/src/shared/i18n/locales/en.ts+++ b/frontend/src/shared/i18n/locales/en.ts@@ -104,7 +104,7 @@ export const en = {placeholder: 'Paste your connection string here...',},auth: {- adminPasswordCheckFailed: 'Failed to check admin password status: {{error}}',+ accountsCheckFailed: 'Failed to check whether the instance has any account: {{error}}',},oauthCallback: {failedTitle: 'Authentication Failed',@@ -866,13 +866,9 @@ export const en = {title: 'Sign up',namePlaceholder: 'John Doe',submit: 'Sign up',+ administersInstance: 'This is the first account on this instance, so it will administer it.',hasAccount: 'Already have an account? <signInLink>Sign in</signInLink>',},- adminPassword: {- title: 'Sign up admin',- description: 'Then you will be able to sign in with login "admin" and password you set',- submit: 'Set password',- },requestPasswordReset: {title: 'Reset password',description: "Enter your email address and we'll send you a reset code.",@@ -897,7 +893,6 @@ export const en = {userId: 'User ID',namePlaceholder: 'Enter your name',emailPlaceholder: 'Enter your email',- adminEmailReadOnly: 'Admin email cannot be changed',role: 'Role',saveChanges: 'Save changes',noChanges: 'No changes to save',diff --git a/frontend/src/shared/i18n/locales/es.ts b/frontend/src/shared/i18n/locales/es.tsindex eeeb517b..7ab6536d 100644--- a/frontend/src/shared/i18n/locales/es.ts+++ b/frontend/src/shared/i18n/locales/es.ts@@ -105,8 +105,7 @@ export const es: typeof en = {placeholder: 'Pegue aquí la cadena de conexión...',},auth: {- adminPasswordCheckFailed:- 'No se pudo comprobar si la contraseña de administrador está configurada: {{error}}',+ accountsCheckFailed: 'No se pudo comprobar si la instancia tiene alguna cuenta: {{error}}',},oauthCallback: {failedTitle: 'Error de autenticación',@@ -887,14 +886,9 @@ export const es: typeof en = {title: 'Registro',namePlaceholder: 'Juan Pérez',submit: 'Registrarse',+ administersInstance: 'Esta es la primera cuenta de esta instancia, así que la administrará.',hasAccount: '¿Ya tiene cuenta? <signInLink>Inicie sesión</signInLink>',},- adminPassword: {- title: 'Registro del administrador',- description:- 'Después podrá iniciar sesión con el usuario "admin" y la contraseña que establezca',- submit: 'Establecer contraseña',- },requestPasswordReset: {title: 'Restablecer contraseña',description:@@ -920,7 +914,6 @@ export const es: typeof en = {userId: 'ID de usuario',namePlaceholder: 'Introduzca su nombre',emailPlaceholder: 'Introduzca su correo electrónico',- adminEmailReadOnly: 'El correo electrónico del administrador no se puede cambiar',role: 'Rol',saveChanges: 'Guardar cambios',noChanges: 'No hay cambios que guardar',diff --git a/frontend/src/shared/i18n/locales/fr.ts b/frontend/src/shared/i18n/locales/fr.tsindex 5bf4031e..9639a1da 100644--- a/frontend/src/shared/i18n/locales/fr.ts+++ b/frontend/src/shared/i18n/locales/fr.ts@@ -105,8 +105,7 @@ export const fr: typeof en = {placeholder: 'Collez votre chaîne de connexion ici...',},auth: {- adminPasswordCheckFailed:- 'Impossible de vérifier si le mot de passe administrateur est défini : {{error}}',+ accountsCheckFailed: "Impossible de vérifier si l'instance possède un compte : {{error}}",},oauthCallback: {failedTitle: "Échec de l'authentification",@@ -893,14 +892,10 @@ export const fr: typeof en = {title: 'Inscription',namePlaceholder: 'Jean Dupont',submit: "S'inscrire",+ administersInstance:+ "Il s'agit du premier compte de cette instance : il en sera l'administrateur.",hasAccount: 'Vous avez déjà un compte ? <signInLink>Connectez-vous</signInLink>',},- adminPassword: {- title: 'Créer le compte administrateur',- description:- "Vous pourrez ensuite vous connecter avec l'identifiant « admin » et le mot de passe choisi",- submit: 'Définir le mot de passe',- },requestPasswordReset: {title: 'Réinitialiser le mot de passe',description:@@ -928,7 +923,6 @@ export const fr: typeof en = {userId: 'ID utilisateur',namePlaceholder: 'Saisissez votre nom',emailPlaceholder: 'Saisissez votre e-mail',- adminEmailReadOnly: "L'e-mail de l'administrateur ne peut pas être modifié",role: 'Rôle',saveChanges: 'Enregistrer les modifications',noChanges: 'Aucune modification à enregistrer',diff --git a/frontend/src/shared/i18n/locales/pt.ts b/frontend/src/shared/i18n/locales/pt.tsindex 5dca31db..729c3566 100644--- a/frontend/src/shared/i18n/locales/pt.ts+++ b/frontend/src/shared/i18n/locales/pt.ts@@ -105,8 +105,8 @@ export const pt: typeof en = {placeholder: 'Cole aqui a string de conexão...',},auth: {- adminPasswordCheckFailed:- 'Não foi possível verificar se a senha do administrador está definida: {{error}}',+ accountsCheckFailed:+ 'Não foi possível verificar se a instância possui alguma conta: {{error}}',},oauthCallback: {failedTitle: 'Falha na autenticação',@@ -883,13 +883,9 @@ export const pt: typeof en = {title: 'Criar conta',namePlaceholder: 'João Silva',submit: 'Criar conta',+ administersInstance: 'Esta é a primeira conta desta instância, portanto ela a administrará.',hasAccount: 'Já tem uma conta? <signInLink>Entre</signInLink>',},- adminPassword: {- title: 'Cadastro do administrador',- description: 'Depois disso, você poderá entrar com o login "admin" e a senha que definir',- submit: 'Definir senha',- },requestPasswordReset: {title: 'Redefinir senha',description: 'Digite seu endereço de e-mail e enviaremos um código de redefinição.',@@ -914,7 +910,6 @@ export const pt: typeof en = {userId: 'ID do usuário',namePlaceholder: 'Digite seu nome',emailPlaceholder: 'Digite seu e-mail',- adminEmailReadOnly: 'O e-mail do administrador não pode ser alterado',role: 'Papel',saveChanges: 'Salvar alterações',noChanges: 'Não há alterações para salvar',diff --git a/frontend/src/shared/i18n/locales/ru.ts b/frontend/src/shared/i18n/locales/ru.tsindex faf6af80..da23913c 100644--- a/frontend/src/shared/i18n/locales/ru.ts+++ b/frontend/src/shared/i18n/locales/ru.ts@@ -105,7 +105,7 @@ export const ru: typeof en = {placeholder: 'Вставьте строку подключения...',},auth: {- adminPasswordCheckFailed: 'Не удалось проверить, задан ли пароль администратора: {{error}}',+ accountsCheckFailed: 'Не удалось проверить, есть ли на инстансе учетные записи: {{error}}',},oauthCallback: {failedTitle: 'Не удалось войти',@@ -869,13 +869,9 @@ export const ru: typeof en = {title: 'Регистрация',namePlaceholder: 'Иван Иванов',submit: 'Зарегистрироваться',+ administersInstance: 'Это первая учетная запись на инстансе — она будет им управлять.',hasAccount: 'Уже есть аккаунт? <signInLink>Войдите</signInLink>',},- adminPassword: {- title: 'Регистрация администратора',- description: 'После этого вы сможете входить с логином «admin» и паролем, который зададите',- submit: 'Задать пароль',- },requestPasswordReset: {title: 'Сброс пароля',description: 'Укажите email, и мы отправим на него код для сброса пароля.',@@ -900,7 +896,6 @@ export const ru: typeof en = {userId: 'ID пользователя',namePlaceholder: 'Введите имя',emailPlaceholder: 'Введите email',- adminEmailReadOnly: 'Email администратора изменить нельзя',role: 'Роль',saveChanges: 'Сохранить изменения',noChanges: 'Изменений нет',diff --git a/frontend/src/shared/i18n/locales/zh.ts b/frontend/src/shared/i18n/locales/zh.tsindex 148ff8ed..804b0cbe 100644--- a/frontend/src/shared/i18n/locales/zh.ts+++ b/frontend/src/shared/i18n/locales/zh.ts@@ -104,7 +104,7 @@ export const zh: typeof en = {placeholder: '在此粘贴连接字符串',},auth: {- adminPasswordCheckFailed: '无法检查管理员密码状态:{{error}}',+ accountsCheckFailed: '无法检查该实例是否已有账户:{{error}}',},oauthCallback: {failedTitle: '认证失败',@@ -834,13 +834,9 @@ export const zh: typeof en = {title: '注册',namePlaceholder: '张三',submit: '注册',+ administersInstance: '这是该实例上的第一个账户,它将成为实例的管理员。',hasAccount: '已有账号?<signInLink>登录</signInLink>',},- adminPassword: {- title: '注册管理员',- description: '之后你就可以用登录名“admin”和你设置的密码登录',- submit: '设置密码',- },requestPasswordReset: {title: '重置密码',description: '输入你的邮箱地址,我们会给你发送重置码。',@@ -865,7 +861,6 @@ export const zh: typeof en = {userId: '用户 ID',namePlaceholder: '输入你的姓名',emailPlaceholder: '输入你的邮箱',- adminEmailReadOnly: '管理员邮箱不能修改',role: '角色',saveChanges: '保存更改',noChanges: '没有需要保存的更改',diff --git a/openspec/changes/replace-seeded-admin-with-first-signup/.openspec.yaml b/openspec/changes/archive/2026-09-20-replace-seeded-admin-with-first-signup/.openspec.yamlsimilarity index 100%rename from openspec/changes/replace-seeded-admin-with-first-signup/.openspec.yamlrename to openspec/changes/archive/2026-09-20-replace-seeded-admin-with-first-signup/.openspec.yamldiff --git a/openspec/changes/replace-seeded-admin-with-first-signup/design.md b/openspec/changes/archive/2026-09-20-replace-seeded-admin-with-first-signup/design.mdsimilarity index 100%rename from openspec/changes/replace-seeded-admin-with-first-signup/design.mdrename to openspec/changes/archive/2026-09-20-replace-seeded-admin-with-first-signup/design.mddiff --git a/openspec/changes/replace-seeded-admin-with-first-signup/proposal.md b/openspec/changes/archive/2026-09-20-replace-seeded-admin-with-first-signup/proposal.mdsimilarity index 100%rename from openspec/changes/replace-seeded-admin-with-first-signup/proposal.mdrename to openspec/changes/archive/2026-09-20-replace-seeded-admin-with-first-signup/proposal.mddiff --git a/openspec/changes/replace-seeded-admin-with-first-signup/specs/root-admin-account/spec.md b/openspec/changes/archive/2026-09-20-replace-seeded-admin-with-first-signup/specs/root-admin-account/spec.mdsimilarity index 100%rename from openspec/changes/replace-seeded-admin-with-first-signup/specs/root-admin-account/spec.mdrename to openspec/changes/archive/2026-09-20-replace-seeded-admin-with-first-signup/specs/root-admin-account/spec.mddiff --git a/openspec/changes/replace-seeded-admin-with-first-signup/tasks.md b/openspec/changes/archive/2026-09-20-replace-seeded-admin-with-first-signup/tasks.mdsimilarity index 100%rename from openspec/changes/replace-seeded-admin-with-first-signup/tasks.mdrename to openspec/changes/archive/2026-09-20-replace-seeded-admin-with-first-signup/tasks.mddiff --git a/website/app/(en)/access-management/page.tsx b/website/app/(en)/access-management/page.tsxindex e6dd45e3..e4b385ab 100644--- a/website/app/(en)/access-management/page.tsx+++ b/website/app/(en)/access-management/page.tsx@@ -217,8 +217,8 @@ export default function AccessManagementPage() {</table><p>- Usually, there is only one <code>admin</code> user in the system- which you create when you first launch Databasus.+ Usually, there is only one administrator in the system: the+ first account created on the instance, which administers it.</p><p>diff --git a/website/app/(en)/page.tsx b/website/app/(en)/page.tsxindex 501b8f7b..1e2841db 100644--- a/website/app/(en)/page.tsx+++ b/website/app/(en)/page.tsx@@ -221,6 +221,14 @@ export default function Index() {text: "Databasus supports physical, full, incremental, WAL and logical backups. Physical backups are a file-level copy of the entire database cluster — faster to back up and restore for large datasets than logical dumps, and built on PostgreSQL 17's native backup mechanism, so we rely on PostgreSQL's own battle-tested tooling instead of re-inventing it. Full backups are a complete, self-contained copy of the cluster, the base every backup chain starts from. Incremental backups store only what changed since the previous backup, so backups stay small and fast. WAL streaming continuously captures the database write stream, enabling Point-in-time recovery (PITR) for disaster recovery and near-zero data loss. Logical backups are a native dump of the database in its engine-specific binary format, compressed and streamed directly to storage with no intermediate files. All of these backups can run over an SSH tunnel if you have a requirement for non-public connections, so the database never has to be exposed publicly. SSH tunneling is built in.",},},+ {+ "@type": "Question",+ name: "I forgot my admin email or password",+ acceptedAnswer: {+ "@type": "Answer",+ text: 'The first account created on the instance administers it. If you cannot remember which address that is, run docker exec -it databasus ./main --list-admins on the server where Databasus runs — it names every administrator account with its email address, display name, creation date and active state, and prints no password material. To set a new password for that account, run docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]". An instance created before the first account administered it still carries the placeholder address admin until its owner replaces it. Both commands are documented on the password page.',+ },+ },],}),}}@@ -1646,6 +1654,33 @@ export default function Index() {</>}/>+ <FaqItem+ number="15"+ question="I forgot my admin email or password"+ answer={+ <>+ The first account created on the instance administers it. If+ you cannot remember which address that is, run docker exec -it+ databasus ./main --list-admins on the server where Databasus+ runs — it names every administrator account with its email+ address, display name, creation date and active state, and+ prints no password material. To set a new password for that+ account, run docker exec -it databasus ./main+ --new-password="YourNewSecurePassword123"+ --email="[email protected]". An instance created+ before the first account administered it still carries the+ placeholder address admin until its owner replaces it. Both+ commands are documented on the{" "}+ <a+ href="/password"+ className="text-blue-400 hover:text-blue-600"+ >+ password page+ </a>+ .+ </>+ }+ /></div></div></section>diff --git a/website/app/(en)/password/page.tsx b/website/app/(en)/password/page.tsxindex 972810d0..10044aca 100644--- a/website/app/(en)/password/page.tsx+++ b/website/app/(en)/password/page.tsx@@ -38,7 +38,8 @@ export const metadata: Metadata = {};export default function PasswordResetPage() {- const resetPasswordCommand = `docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="admin"`;+ const resetPasswordCommand = `docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]"`;+ const listAdminsCommand = `docker exec -it databasus ./main --list-admins`;return (<>@@ -137,11 +138,40 @@ export default function PasswordResetPage() {special characters.</li><li>- <strong>--email</strong>: The email address of the user whose- password you want to reset (e.g., <code>admin</code>,{" "}- <code>[email protected]</code>).+ <strong>--email</strong>: The email address of the account+ whose password you want to reset (e.g.,{" "}+ <code>[email protected]</code>). An instance created before+ the first account administered it still carries the+ placeholder address <code>admin</code> until its owner+ replaces it, so pass <code>admin</code> there.</li></ul>++ <h2 id="list-admins">List administrator accounts</h2>++ <p>+ If you do not remember which address administers the instance,+ list the administrator accounts on the server where Databasus is+ running:+ </p>++ <div className="relative my-6">+ <pre className="overflow-x-auto rounded-lg bg-gray-900 p-4 text-sm text-gray-100">+ <code>{listAdminsCommand}</code>+ </pre>+ <div className="absolute right-2 top-2">+ <CopyButton text={listAdminsCommand} />+ </div>+ </div>++ <p>+ The output names every administrator account with its email+ address, display name, creation date and active state, and marks+ the one the instance recognizes as its administrator. It prints+ no password, no password hash and no token. On an instance where+ nobody has created an account yet, it reports that the instance+ has no administrator.+ </p></article></div></main>diff --git a/website/app/[lang]/access-management/content/es.tsx b/website/app/[lang]/access-management/content/es.tsxindex 0f365923..e6fe795c 100644--- a/website/app/[lang]/access-management/content/es.tsx+++ b/website/app/[lang]/access-management/content/es.tsx@@ -225,8 +225,8 @@ export default function AccessManagementPage() {</table><p>- Normalmente hay un solo usuario <code>admin</code> en el- sistema: el que se crea al iniciar Databasus por primera vez.+ Normalmente hay un solo administrador en el sistema: la primera+ cuenta creada en la instancia, que es la que la administra.</p><p>diff --git a/website/app/[lang]/access-management/content/fr.tsx b/website/app/[lang]/access-management/content/fr.tsxindex 067dc2b1..caf8ec9a 100644--- a/website/app/[lang]/access-management/content/fr.tsx+++ b/website/app/[lang]/access-management/content/fr.tsx@@ -233,9 +233,9 @@ export default function AccessManagementPage() {</table><p>- En général, il n'y a qu'un seul utilisateur{" "}- <code>admin</code> dans le système, celui que vous créez au- premier lancement de Databasus.+ En général, il n'y a qu'un seul administrateur dans le+ système : le premier compte créé sur l'instance, qui+ l'administre.</p><p>diff --git a/website/app/[lang]/access-management/content/pt.tsx b/website/app/[lang]/access-management/content/pt.tsxindex c43514d9..0561fcd2 100644--- a/website/app/[lang]/access-management/content/pt.tsx+++ b/website/app/[lang]/access-management/content/pt.tsx@@ -225,8 +225,8 @@ export default function AccessManagementPage() {</table><p>- Normalmente, há apenas um usuário <code>admin</code> no sistema,- criado na primeira vez que você inicia o Databasus.+ Normalmente, há apenas um administrador no sistema: a primeira+ conta criada na instância, que é quem a administra.</p><p>diff --git a/website/app/[lang]/access-management/content/ru.tsx b/website/app/[lang]/access-management/content/ru.tsxindex 702340f5..e2de0e64 100644--- a/website/app/[lang]/access-management/content/ru.tsx+++ b/website/app/[lang]/access-management/content/ru.tsx@@ -221,8 +221,8 @@ export default function AccessManagementPage() {</table><p>- Обычно в системе только один пользователь <code>admin</code>,- которого вы создаете при первом запуске Databasus.+ Обычно в системе только один администратор — первая учетная+ запись, созданная на инстансе: она им и управляет.</p><p>diff --git a/website/app/[lang]/access-management/content/zh.tsx b/website/app/[lang]/access-management/content/zh.tsxindex 79a6651e..101af5f9 100644--- a/website/app/[lang]/access-management/content/zh.tsx+++ b/website/app/[lang]/access-management/content/zh.tsx@@ -207,8 +207,7 @@ export default function AccessManagementPage() {</table><p>- 通常系统里只有一个 <code>admin</code> 用户,即你首次启动- Databasus 时创建的那个。+ 通常系统里只有一个管理员:实例上创建的第一个账户,它就是该实例的管理员。</p><p>diff --git a/website/app/[lang]/content/es.tsx b/website/app/[lang]/content/es.tsxindex 5b7cbf10..620e3af4 100644--- a/website/app/[lang]/content/es.tsx+++ b/website/app/[lang]/content/es.tsx@@ -221,6 +221,14 @@ export default function Index() {text: "Databasus admite copias físicas, completas, incrementales, de WAL y lógicas. Las copias físicas son una copia a nivel de archivos de todo el clúster de la base de datos: más rápidas de crear y restaurar en conjuntos de datos grandes que los volcados lógicos, y construidas sobre el mecanismo nativo de respaldo de PostgreSQL 17, así que nos apoyamos en las herramientas probadas de PostgreSQL en lugar de reinventarlas. Las copias completas son una copia íntegra y autocontenida del clúster, la base de la que parte cada cadena de respaldos. Las copias incrementales guardan solo lo que cambió desde la copia anterior, así que los respaldos se mantienen pequeños y rápidos. El streaming de WAL captura de forma continua el flujo de escritura de la base de datos, lo que habilita la recuperación a un punto en el tiempo (PITR) para recuperación ante desastres y una pérdida de datos casi nula. Las copias lógicas son un volcado nativo de la base de datos en su formato binario específico del motor, comprimido y transmitido directamente al almacenamiento sin archivos intermedios. Todas estas copias pueden ejecutarse por un túnel SSH si necesita conexiones no públicas, de modo que la base de datos nunca tiene que exponerse públicamente. El túnel SSH viene integrado.",},},+ {+ "@type": "Question",+ name: "Olvidé el correo o la contraseña del administrador",+ acceptedAnswer: {+ "@type": "Answer",+ text: 'La primera cuenta creada en la instancia es la que la administra. Si no recuerda cuál es esa dirección, ejecute docker exec -it databasus ./main --list-admins en el servidor donde se ejecuta Databasus: nombra cada cuenta de administrador con su correo electrónico, nombre visible, fecha de creación y estado de actividad, y no imprime ninguna contraseña. Para establecer una nueva contraseña para esa cuenta, ejecute docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]". Una instancia creada antes de que la primera cuenta la administrara todavía lleva la dirección provisional admin hasta que su propietario la reemplace. Ambos comandos están documentados en la página de contraseña.',+ },+ },],}),}}@@ -1688,6 +1696,34 @@ export default function Index() {</>}/>+ <FaqItem+ number="15"+ question="Olvidé el correo o la contraseña del administrador"+ answer={+ <>+ La primera cuenta creada en la instancia es la que la+ administra. Si no recuerda cuál es esa dirección, ejecute+ docker exec -it databasus ./main --list-admins en el servidor+ donde se ejecuta Databasus: nombra cada cuenta de+ administrador con su correo electrónico, nombre visible, fecha+ de creación y estado de actividad, y no imprime ninguna+ contraseña. Para establecer una nueva contraseña para esa+ cuenta, ejecute docker exec -it databasus ./main+ --new-password="YourNewSecurePassword123"+ --email="[email protected]". Una instancia creada+ antes de que la primera cuenta la administrara todavía lleva+ la dirección provisional admin hasta que su propietario la+ reemplace. Ambos comandos están documentados en+ <a+ href="/es/password"+ className="text-blue-400 hover:text-blue-600"+ >+ la página de contraseña+ </a>+ .+ </>+ }+ /></div></div></section>diff --git a/website/app/[lang]/content/fr.tsx b/website/app/[lang]/content/fr.tsxindex b02df917..2b0cfb15 100644--- a/website/app/[lang]/content/fr.tsx+++ b/website/app/[lang]/content/fr.tsx@@ -221,6 +221,14 @@ export default function Index() {text: "Databasus prend en charge les sauvegardes physiques, complètes, incrémentales, WAL et logiques. Les sauvegardes physiques sont une copie au niveau fichier de l'ensemble du cluster de base de données : plus rapides à sauvegarder et à restaurer pour les gros volumes que les dumps logiques, et construites sur le mécanisme de sauvegarde natif de PostgreSQL 17, nous nous appuyons donc sur l'outillage éprouvé de PostgreSQL au lieu de le réinventer. Les sauvegardes complètes sont une copie intégrale et autonome du cluster, la base de départ de chaque chaîne de sauvegardes. Les sauvegardes incrémentales ne stockent que ce qui a changé depuis la sauvegarde précédente, elles restent donc petites et rapides. Le streaming WAL capture en continu le flux d'écriture de la base, ce qui permet la récupération à un instant donné (PITR) pour la reprise après sinistre et une perte de données quasi nulle. Les sauvegardes logiques sont un dump natif de la base dans son format binaire propre au moteur, compressé et envoyé en flux directement vers le stockage sans fichiers intermédiaires. Toutes ces sauvegardes peuvent passer par un tunnel SSH si vous exigez des connexions non publiques, la base n'a donc jamais à être exposée publiquement. Le tunnel SSH est intégré.",},},+ {+ "@type": "Question",+ name: "J'ai oublié l'e-mail ou le mot de passe de l'administrateur",+ acceptedAnswer: {+ "@type": "Answer",+ text: "Le premier compte créé sur l'instance est celui qui l'administre. Si vous ne savez plus quelle est cette adresse, exécutez docker exec -it databasus ./main --list-admins sur le serveur où Databasus tourne : la commande nomme chaque compte administrateur avec son adresse e-mail, son nom affiché, sa date de création et son état d'activité, et n'affiche aucun mot de passe. Pour définir un nouveau mot de passe pour ce compte, exécutez docker exec -it databasus ./main --new-password=\"YourNewSecurePassword123\" --email=\"[email protected]\". Une instance créée avant que le premier compte ne l'administre porte encore l'adresse provisoire admin tant que son propriétaire ne l'a pas remplacée. Les deux commandes sont documentées sur la page mot de passe.",+ },+ },],}),}}@@ -1702,6 +1710,36 @@ export default function Index() {</>}/>+ <FaqItem+ number="15"+ question="J'ai oublié l'e-mail ou le mot de passe de l'administrateur"+ answer={+ <>+ Le premier compte créé sur l'instance est celui qui+ l'administre. Si vous ne savez plus quelle est cette+ adresse, exécutez docker exec -it databasus ./main+ --list-admins sur le serveur où Databasus tourne : la commande+ nomme chaque compte administrateur avec son adresse e-mail,+ son nom affiché, sa date de création et son état+ d'activité, et n'affiche aucun mot de passe. Pour+ définir un nouveau mot de passe pour ce compte, exécutez+ docker exec -it databasus ./main+ --new-password="YourNewSecurePassword123"+ --email="[email protected]". Une instance créée+ avant que le premier compte ne l'administre porte encore+ l'adresse provisoire admin tant que son propriétaire ne+ l'a pas remplacée. Les deux commandes sont documentées+ sur la+ <a+ href="/fr/password"+ className="text-blue-400 hover:text-blue-600"+ >+ page mot de passe+ </a>+ .+ </>+ }+ /></div></div></section>diff --git a/website/app/[lang]/content/pt.tsx b/website/app/[lang]/content/pt.tsxindex 417074bd..0e1c02e5 100644--- a/website/app/[lang]/content/pt.tsx+++ b/website/app/[lang]/content/pt.tsx@@ -221,6 +221,14 @@ export default function Index() {text: "O Databasus suporta backups físicos, completos, incrementais, de WAL e lógicos. Os backups físicos são uma cópia no nível de arquivos de todo o cluster da base de dados — mais rápidos de fazer e de restaurar para grandes volumes de dados do que dumps lógicos, e construídos sobre o mecanismo nativo de backup do PostgreSQL 17, então usamos as ferramentas testadas do próprio PostgreSQL em vez de reinventá-las. Os backups completos são uma cópia integral e autossuficiente do cluster, a base de onde parte toda cadeia de backups. Os backups incrementais guardam apenas o que mudou desde o backup anterior, mantendo os backups pequenos e rápidos. O streaming de WAL captura continuamente o fluxo de escrita da base, permitindo Point-in-Time Recovery (PITR) para recuperação de desastres e perda de dados próxima de zero. Os backups lógicos são um dump nativo da base no formato binário do próprio motor, comprimido e enviado diretamente ao armazenamento, sem arquivos intermediários. Todos esses backups podem passar por um túnel SSH se você precisar de conexões não públicas, então a base de dados nunca precisa ficar exposta publicamente. O túnel SSH já vem integrado.",},},+ {+ "@type": "Question",+ name: "Esqueci o email ou a senha do administrador",+ acceptedAnswer: {+ "@type": "Answer",+ text: 'A primeira conta criada na instância é quem a administra. Se você não lembra qual é esse endereço, execute docker exec -it databasus ./main --list-admins no servidor onde o Databasus está em execução: ele nomeia cada conta de administrador com seu endereço de email, nome de exibição, data de criação e estado de atividade, e não imprime nenhuma senha. Para definir uma nova senha para essa conta, execute docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]". Uma instância criada antes de a primeira conta administrá-la ainda carrega o endereço provisório admin até que seu dono o substitua. Os dois comandos estão documentados na página de senha.',+ },+ },],}),}}@@ -1675,6 +1683,34 @@ export default function Index() {</>}/>+ <FaqItem+ number="15"+ question="Esqueci o email ou a senha do administrador"+ answer={+ <>+ A primeira conta criada na instância é quem a administra. Se+ você não lembra qual é esse endereço, execute docker exec -it+ databasus ./main --list-admins no servidor onde o Databasus+ está em execução: ele nomeia cada conta de administrador com+ seu endereço de email, nome de exibição, data de criação e+ estado de atividade, e não imprime nenhuma senha. Para definir+ uma nova senha para essa conta, execute docker exec -it+ databasus ./main+ --new-password="YourNewSecurePassword123"+ --email="[email protected]". Uma instância criada+ antes de a primeira conta administrá-la ainda carrega o+ endereço provisório admin até que seu dono o substitua. Os+ dois comandos estão documentados na+ <a+ href="/pt/password"+ className="text-blue-400 hover:text-blue-600"+ >+ página de senha+ </a>+ .+ </>+ }+ /></div></div></section>diff --git a/website/app/[lang]/content/ru.tsx b/website/app/[lang]/content/ru.tsxindex ce0073fb..2b078e8c 100644--- a/website/app/[lang]/content/ru.tsx+++ b/website/app/[lang]/content/ru.tsx@@ -221,6 +221,14 @@ export default function Index() {text: "Databasus поддерживает физические, полные, инкрементальные, WAL и логические бекапы. Физический бекап — это копия всего кластера базы данных на уровне файлов: для больших объемов данных он быстрее логических дампов и при копировании, и при восстановлении, а построен он на нативном механизме бекапов PostgreSQL 17, то есть мы опираемся на проверенный инструментарий самого PostgreSQL вместо того, чтобы изобретать свой. Полный бекап — это самодостаточная копия кластера, основа, с которой начинается каждая цепочка бекапов. Инкрементальный бекап хранит только изменения с прошлого бекапа, поэтому бекапы остаются маленькими и быстрыми. Потоковая передача WAL непрерывно захватывает поток записи базы, обеспечивая Point-in-Time Recovery (PITR) для аварийного восстановления с почти нулевой потерей данных. Логический бекап — нативный дамп базы в бинарном формате конкретного движка, сжимаемый и передаваемый в хранилище потоком без промежуточных файлов. Все эти бекапы могут работать через SSH-туннель, если вам нельзя открывать публичные подключения — базу вообще не нужно выставлять наружу. SSH-туннелирование встроено.",},},+ {+ "@type": "Question",+ name: "Я забыл email или пароль администратора",+ acceptedAnswer: {+ "@type": "Answer",+ text: 'Первая учетная запись, созданная на инстансе, им и управляет. Если вы не помните, какой это адрес, выполните docker exec -it databasus ./main --list-admins на сервере, где запущен Databasus — команда перечислит все учетные записи администраторов с их email, именем, датой создания и состоянием активности и не выведет ни одного пароля. Чтобы задать новый пароль этой учетной записи, выполните docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]". Инстанс, созданный до того, как первая учетная запись стала им управлять, до сих пор носит адрес-заглушку admin, пока владелец его не заменит. Обе команды описаны на странице про пароль.',+ },+ },],}),}}@@ -1638,6 +1646,34 @@ export default function Index() {</>}/>+ <FaqItem+ number="15"+ question="Я забыл email или пароль администратора"+ answer={+ <>+ Первая учетная запись, созданная на инстансе, им и управляет.+ Если вы не помните, какой это адрес, выполните docker exec -it+ databasus ./main --list-admins на сервере, где запущен+ Databasus — команда перечислит все учетные записи+ администраторов с их email, именем, датой создания и+ состоянием активности и не выведет ни одного пароля. Чтобы+ задать новый пароль этой учетной записи, выполните docker exec+ -it databasus ./main+ --new-password="YourNewSecurePassword123"+ --email="[email protected]". Инстанс, созданный до+ того, как первая учетная запись стала им управлять, до сих пор+ носит адрес-заглушку admin, пока владелец его не заменит. Обе+ команды описаны на+ <a+ href="/ru/password"+ className="text-blue-400 hover:text-blue-600"+ >+ странице про пароль+ </a>+ .+ </>+ }+ /></div></div></section>diff --git a/website/app/[lang]/content/zh.tsx b/website/app/[lang]/content/zh.tsxindex 001d16ec..2be70fad 100644--- a/website/app/[lang]/content/zh.tsx+++ b/website/app/[lang]/content/zh.tsx@@ -221,6 +221,14 @@ export default function Index() {text: "Databasus 支持物理备份、全量备份、增量备份、WAL 备份和逻辑备份。物理备份是对整个数据库集群的文件级复制,对大数据集来说备份和恢复都比逻辑转储更快,并且构建在 PostgreSQL 17 的原生备份机制之上,我们依赖 PostgreSQL 自身久经考验的工具,而不是重新造轮子。全量备份是集群的完整、自包含副本,是每条备份链的起点。增量备份只存储自上次备份以来的变化,让备份保持小而快。WAL 流式复制持续捕获数据库的写入流,支持时间点恢复(PITR),用于灾难恢复并将数据丢失降到接近于零。逻辑备份是数据库引擎专用二进制格式的原生转储,压缩后直接流式写入存储,没有中间文件。如果你要求非公开连接,所有这些备份都可以通过 SSH 隧道运行,数据库永远无需公开暴露。SSH 隧道是内置功能。",},},+ {+ "@type": "Question",+ name: "我忘记了管理员邮箱或密码",+ acceptedAnswer: {+ "@type": "Answer",+ text: '实例上创建的第一个账户就是它的管理员。如果你不记得那个地址,可以在运行 Databasus 的服务器上执行 docker exec -it databasus ./main --list-admins:它会列出每个管理员账户的邮箱、显示名称、创建日期和活动状态,并且不会输出任何密码。要为该账户设置新密码,请执行 docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]"。在第一个账户成为管理员之前创建的实例,在其所有者替换之前仍使用占位地址 admin。这两条命令都记录在密码页面上。',+ },+ },],}),}}@@ -1567,6 +1575,28 @@ export default function Index() {</>}/>+ <FaqItem+ number="15"+ question="我忘记了管理员邮箱或密码"+ answer={+ <>+ 实例上创建的第一个账户就是它的管理员。如果你不记得那个地址,可以在运行+ Databasus 的服务器上执行 docker exec -it databasus ./main+ --list-admins:它会列出每个管理员账户的邮箱、显示名称、创建日期和活动状态,并且不会输出任何密码。要为该账户设置新密码,请执行+ docker exec -it databasus ./main+ --new-password="YourNewSecurePassword123"+ --email="[email protected]"。在第一个账户成为管理员之前创建的实例,在其所有者替换之前仍使用占位地址+ admin。这两条命令都记录在+ <a+ href="/zh/password"+ className="text-blue-400 hover:text-blue-600"+ >+ 密码页面+ </a>+ 上。+ </>+ }+ /></div></div></section>diff --git a/website/app/[lang]/password/content/es.tsx b/website/app/[lang]/password/content/es.tsxindex c04c817d..942e727e 100644--- a/website/app/[lang]/password/content/es.tsx+++ b/website/app/[lang]/password/content/es.tsx@@ -1,9 +1,5 @@import type { Metadata } from "next";-import {- OG_LOCALES,- getLanguageAlternates,- getLocalizedUrl,-} from "@/app/i18n";+import { OG_LOCALES, getLanguageAlternates, getLocalizedUrl } from "@/app/i18n";import { CopyButton } from "@/app/components/CopyButton";import DocsNavbarComponent from "@/app/components/DocsNavbarComponent";import DocsSidebarComponent from "@/app/components/DocsSidebarComponent";@@ -43,7 +39,8 @@ export const metadata: Metadata = {};export default function PasswordResetPage() {- const resetPasswordCommand = `docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="admin"`;+ const resetPasswordCommand = `docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]"`;+ const listAdminsCommand = `docker exec -it databasus ./main --list-admins`;return (<>@@ -144,11 +141,41 @@ export default function PasswordResetPage() {caracteres especiales.</li><li>- <strong>--email</strong>: el correo electrónico del usuario+ <strong>--email</strong>: el correo electrónico de la cuentacuya contraseña quiere restablecer (por ejemplo,{" "}- <code>admin</code>, <code>[email protected]</code>).+ <code>[email protected]</code>). Una instancia creada antes de+ que la primera cuenta la administrara todavía lleva la+ dirección provisional <code>admin</code> hasta que su+ propietario la reemplace, así que allí indique{" "}+ <code>admin</code>.</li></ul>++ <h2 id="list-admins">Listar las cuentas de administrador</h2>++ <p>+ Si no recuerda qué dirección administra la instancia, liste las+ cuentas de administrador en el servidor donde se ejecuta+ Databasus:+ </p>++ <div className="relative my-6">+ <pre className="overflow-x-auto rounded-lg bg-gray-900 p-4 text-sm text-gray-100">+ <code>{listAdminsCommand}</code>+ </pre>+ <div className="absolute right-2 top-2">+ <CopyButton text={listAdminsCommand} lang="es" />+ </div>+ </div>++ <p>+ La salida nombra cada cuenta de administrador con su correo+ electrónico, nombre visible, fecha de creación y estado de+ actividad, y marca la que la instancia reconoce como su+ administrador. No imprime ninguna contraseña, ni su hash, ni+ ningún token. En una instancia donde todavía nadie ha creado una+ cuenta, informa de que la instancia no tiene administrador.+ </p></article></div></main>diff --git a/website/app/[lang]/password/content/fr.tsx b/website/app/[lang]/password/content/fr.tsxindex dba28a8e..95e87676 100644--- a/website/app/[lang]/password/content/fr.tsx+++ b/website/app/[lang]/password/content/fr.tsx@@ -39,7 +39,8 @@ export const metadata: Metadata = {};export default function PasswordResetPage() {- const resetPasswordCommand = `docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="admin"`;+ const resetPasswordCommand = `docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]"`;+ const listAdminsCommand = `docker exec -it databasus ./main --list-admins`;return (<>@@ -143,12 +144,42 @@ export default function PasswordResetPage() {lettres, de chiffres et de caractères spéciaux.</li><li>- <strong>--email</strong> : l'adresse e-mail de- l'utilisateur dont vous voulez réinitialiser le mot de- passe (par exemple <code>admin</code>,{" "}- <code>[email protected]</code>).+ <strong>--email</strong> : l'adresse e-mail du compte+ dont vous voulez réinitialiser le mot de passe (par exemple{" "}+ <code>[email protected]</code>). Une instance créée avant que+ le premier compte ne l'administre porte encore+ l'adresse provisoire <code>admin</code> tant que son+ propriétaire ne l'a pas remplacée : indiquez alors{" "}+ <code>admin</code>.</li></ul>++ <h2 id="list-admins">Lister les comptes administrateurs</h2>++ <p>+ Si vous ne savez plus quelle adresse administre l'instance,+ listez les comptes administrateurs sur le serveur où Databasus+ tourne :+ </p>++ <div className="relative my-6">+ <pre className="overflow-x-auto rounded-lg bg-gray-900 p-4 text-sm text-gray-100">+ <code>{listAdminsCommand}</code>+ </pre>+ <div className="absolute right-2 top-2">+ <CopyButton text={listAdminsCommand} lang="fr" />+ </div>+ </div>++ <p>+ La sortie nomme chaque compte administrateur avec son adresse+ e-mail, son nom affiché, sa date de création et son état+ d'activité, et marque celui que l'instance reconnaît+ comme son administrateur. Aucun mot de passe, empreinte de mot+ de passe ni jeton n'est affiché. Sur une instance où+ personne n'a encore créé de compte, elle indique que+ l'instance n'a pas d'administrateur.+ </p></article></div></main>diff --git a/website/app/[lang]/password/content/pt.tsx b/website/app/[lang]/password/content/pt.tsxindex f36d8ee2..3c881e42 100644--- a/website/app/[lang]/password/content/pt.tsx+++ b/website/app/[lang]/password/content/pt.tsx@@ -39,7 +39,8 @@ export const metadata: Metadata = {};export default function PasswordResetPage() {- const resetPasswordCommand = `docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="admin"`;+ const resetPasswordCommand = `docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]"`;+ const listAdminsCommand = `docker exec -it databasus ./main --list-admins`;return (<>@@ -140,11 +141,40 @@ export default function PasswordResetPage() {especiais.</li><li>- <strong>--email</strong>: o endereço de email do usuário cuja- senha você quer redefinir (por exemplo, <code>admin</code>,{" "}- <code>[email protected]</code>).+ <strong>--email</strong>: o endereço de email da conta cuja+ senha você quer redefinir (por exemplo,{" "}+ <code>[email protected]</code>). Uma instância criada antes de+ a primeira conta administrá-la ainda carrega o endereço+ provisório <code>admin</code> até que seu dono o substitua,+ então informe <code>admin</code> nesse caso.</li></ul>++ <h2 id="list-admins">Listar as contas de administrador</h2>++ <p>+ Se você não lembra qual endereço administra a instância, liste+ as contas de administrador no servidor onde o Databasus está em+ execução:+ </p>++ <div className="relative my-6">+ <pre className="overflow-x-auto rounded-lg bg-gray-900 p-4 text-sm text-gray-100">+ <code>{listAdminsCommand}</code>+ </pre>+ <div className="absolute right-2 top-2">+ <CopyButton text={listAdminsCommand} lang="pt" />+ </div>+ </div>++ <p>+ A saída nomeia cada conta de administrador com seu endereço de+ email, nome de exibição, data de criação e estado de atividade,+ e marca aquela que a instância reconhece como seu administrador.+ Nenhuma senha, hash de senha ou token é impresso. Em uma+ instância onde ninguém criou uma conta ainda, ela informa que a+ instância não tem administrador.+ </p></article></div></main>diff --git a/website/app/[lang]/password/content/ru.tsx b/website/app/[lang]/password/content/ru.tsxindex b2d953d4..78f46bc5 100644--- a/website/app/[lang]/password/content/ru.tsx+++ b/website/app/[lang]/password/content/ru.tsx@@ -39,7 +39,8 @@ export const metadata: Metadata = {};export default function PasswordResetPage() {- const resetPasswordCommand = `docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="admin"`;+ const resetPasswordCommand = `docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]"`;+ const listAdminsCommand = `docker exec -it databasus ./main --list-admins`;return (<>@@ -137,11 +138,39 @@ export default function PasswordResetPage() {он надежный и содержит буквы, цифры и специальные символы.</li><li>- <strong>--email</strong>: email пользователя, чей пароль вы- хотите сбросить (например, <code>admin</code>,{" "}- <code>[email protected]</code>).+ <strong>--email</strong>: email учетной записи, чей пароль вы+ хотите сбросить (например, <code>[email protected]</code>).+ Инстанс, созданный до того, как первая учетная запись стала им+ управлять, до сих пор носит адрес-заглушку <code>admin</code>,+ пока владелец его не заменит — там передавайте{" "}+ <code>admin</code>.</li></ul>++ <h2 id="list-admins">Список администраторов</h2>++ <p>+ Если вы не помните, какой адрес управляет инстансом, выведите+ список администраторов на сервере, где запущен Databasus:+ </p>++ <div className="relative my-6">+ <pre className="overflow-x-auto rounded-lg bg-gray-900 p-4 text-sm text-gray-100">+ <code>{listAdminsCommand}</code>+ </pre>+ <div className="absolute right-2 top-2">+ <CopyButton text={listAdminsCommand} lang="ru" />+ </div>+ </div>++ <p>+ В выводе перечислены все учетные записи администраторов с их+ email, именем, датой создания и состоянием активности, а та,+ которую инстанс считает своим администратором, отмечена+ отдельно. Пароли, их хеши и токены не выводятся. На инстансе,+ где еще никто не завел учетную запись, команда сообщит, что+ администратора нет.+ </p></article></div></main>diff --git a/website/app/[lang]/password/content/zh.tsx b/website/app/[lang]/password/content/zh.tsxindex 1b3bf098..896cfd40 100644--- a/website/app/[lang]/password/content/zh.tsx+++ b/website/app/[lang]/password/content/zh.tsx@@ -39,7 +39,8 @@ export const metadata: Metadata = {};export default function PasswordResetPage() {- const resetPasswordCommand = `docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="admin"`;+ const resetPasswordCommand = `docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="[email protected]"`;+ const listAdminsCommand = `docker exec -it databasus ./main --list-admins`;return (<>@@ -112,9 +113,7 @@ export default function PasswordResetPage() {<h2 id="reset-password-command">重置密码命令</h2>- <p>- 要重置用户密码,在运行 Databasus 的服务器上执行以下命令:- </p>+ <p>要重置用户密码,在运行 Databasus 的服务器上执行以下命令:</p><div className="relative my-6"><pre className="overflow-x-auto rounded-lg bg-gray-900 p-4 text-sm text-gray-100">@@ -135,10 +134,33 @@ export default function PasswordResetPage() {安全,包含字母、数字和特殊字符。</li><li>- <strong>--email</strong>:要重置密码的用户邮箱(例如{" "}- <code>admin</code>、<code>[email protected]</code>)。+ <strong>--email</strong>:要重置密码的账户邮箱(例如{" "}+ <code>[email protected]</code>+ )。在第一个账户成为管理员之前创建的实例,+ 在其所有者替换之前仍使用占位地址 <code>admin</code>+ ,此时请传入 <code>admin</code>。</li></ul>++ <h2 id="list-admins">列出管理员账户</h2>++ <p>+ 如果你不记得哪个地址是该实例的管理员,可以在运行 Databasus+ 的服务器上列出管理员账户:+ </p>++ <div className="relative my-6">+ <pre className="overflow-x-auto rounded-lg bg-gray-900 p-4 text-sm text-gray-100">+ <code>{listAdminsCommand}</code>+ </pre>+ <div className="absolute right-2 top-2">+ <CopyButton text={listAdminsCommand} lang="zh" />+ </div>+ </div>++ <p>+ 输出会列出每个管理员账户的邮箱、显示名称、创建日期和活动状态,并标记实例所认可的管理员。不会输出任何密码、密码哈希或令牌。如果实例上还没有人创建账户,命令会提示该实例没有管理员。+ </p></article></div></main>