feat(api): identité user-first — login/password, ownership user, fin du token device

- 000006 : users.username/username_normalized/password_hash/is_admin, index
  unique partiel sur username_normalized, DROP idx_users_email (unicité V1 =
  username, jamais email) ; 000007 destructif : resources.owner_id→user_id
  (FK→users, reset base dev), l'unicité racine devient par user
- pkg/passwd : argon2id (t=1,m=64MiB,p=4,k=32), comparaison constant-time,
  VerifyTimedEqual (délai égalisé dummy-hash) ; pkg/auth : subject=user_id +
  claim device_id, TTL 7 j sans refresh
- repository : Users (count/get/resolve-exact/create/update-password/
  mark-deleted), Devices.MarkUser (user_id INFORMATIF uniquement)
- handlers : POST /devices sans token, POST /auth/login (401 indistinguable
  user inconnu/mauvais mdp, device requis), PATCH /users/me/password
  (current_password, tokens non révoqués — limite V1), GET /users/resolve
  (exact lowercase, jamais email/is_admin) ; middleware RequireAuth
  (user authorisant, device porté) ; tout le scoping ressources passe user
- bootstrap admin : users vide + ADMIN_* absents → refus de démarrer ;
  .env.example ; docs/api-v1.md §2/§3/§7/§8
- tests : migrations 000006/000007 (up/down), pkg/auth Identity, handlers
  login/password/resolve, helpers refactorés registerAndLogin, repo tests
  scopés user — suite backend verte
This commit is contained in:
m
2026-09-10 21:21:36 +02:00
parent 197c7db8a9
commit c2c7dddba6
34 changed files with 1237 additions and 223 deletions
@@ -0,0 +1,9 @@
DROP INDEX IF EXISTS idx_users_username_normalized;
ALTER TABLE users DROP COLUMN IF EXISTS is_admin;
ALTER TABLE users DROP COLUMN IF EXISTS password_hash;
ALTER TABLE users DROP COLUMN IF EXISTS username_normalized;
ALTER TABLE users DROP COLUMN IF EXISTS username;
CREATE UNIQUE INDEX IF NOT EXISTS idx_users_email
ON users(email) WHERE email IS NOT NULL AND deleted_at IS NULL;
@@ -0,0 +1,19 @@
-- Identité utilisateur (tranche users + auth).
-- users.id reste TEXT 32-hex (convention du contrat V1, docs/api-v1.md §2).
-- L'unicité porte sur username_normalized (lowercase), jamais sur username
-- (forme affichée).
ALTER TABLE users ADD COLUMN IF NOT EXISTS username TEXT;
ALTER TABLE users ADD COLUMN IF NOT EXISTS username_normalized TEXT;
ALTER TABLE users ADD COLUMN IF NOT EXISTS password_hash TEXT;
ALTER TABLE users ADD COLUMN IF NOT EXISTS is_admin BOOLEAN NOT NULL DEFAULT false;
-- email redevient optionnel SANS unicité en V1 : le destinataire d'un partage
-- se résout par username, jamais par email.
DROP INDEX IF EXISTS idx_users_email;
CREATE UNIQUE INDEX IF NOT EXISTS idx_users_username_normalized
ON users(username_normalized) WHERE username_normalized IS NOT NULL;
-- devices.user_id est INFORMATIF uniquement (« dernier utilisateur connu ») :
-- il n'autorise RIEN. L'autorisation ne passe que par le claim user_id du
-- token paseto, résolu par le middleware RequireDevice.
@@ -0,0 +1,9 @@
-- Reverse de 000007. Réversible SEULEMENT sur base vide (les ressources sont
-- détruites dans les deux sens : sans device associé, il n'y a rien à
-- préserver).
DELETE FROM resources;
ALTER TABLE resources DROP CONSTRAINT resources_user_id_fkey;
ALTER TABLE resources RENAME COLUMN user_id TO owner_id;
ALTER TABLE resources ADD CONSTRAINT resources_owner_id_fkey
FOREIGN KEY (owner_id) REFERENCES devices(device_id) ON DELETE CASCADE;
@@ -0,0 +1,15 @@
-- Bascule ownership device → user (étapes 6-10 de la tranche identité).
-- Destructif ASSUMÉ : à ce stade aucune release V1, la base de dev est RESET
-- (DELETE trivial sur une table vide ; PAS de user marqueur). Le modele
-- resources reste parfaitement identique par ailleurs.
DELETE FROM resources;
ALTER TABLE resources DROP CONSTRAINT resources_owner_id_fkey;
ALTER TABLE resources RENAME COLUMN owner_id TO user_id;
ALTER TABLE resources ADD CONSTRAINT resources_user_id_fkey
FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE;
-- Les index créés en 000003 (idx_resources_owner, idx_resources_root_name
-- sur owner_id) suivent le renommage Intrinsèquement : ils portent désormais
-- sur user_id. L'unicité racine devient donc « 1 nom par USER » (multi-device
-- possible pour le même compte).
+68
View File
@@ -110,6 +110,74 @@ func TestMigrationsUpDown(t *testing.T) {
assertHexCheck(t, conn, "devices", "device_id")
assertHexCheck(t, conn, "resources", "resource_id")
assertHexCheck(t, conn, "ocr_jobs", "job_id")
assertHexCheck(t, conn, "users", "id")
// --- 000006 : identité utilisateur ----------------------------------
usersColumns := []string{"username", "username_normalized", "password_hash", "is_admin"}
for _, col := range usersColumns {
var tpe string
err = conn.QueryRow(`
SELECT data_type FROM information_schema.columns
WHERE table_schema = 'public' AND table_name = 'users' AND column_name = $1`, col).Scan(&tpe)
if err != nil {
t.Errorf("colonne users.%s manquante: %v", col, err)
}
}
// username_unique : index UNIQUE partiel sur username_normalized
var usernameUnique int
err = conn.QueryRow(`
SELECT COUNT(*) FROM pg_index i
JOIN pg_class t ON t.oid = i.indrelid
WHERE t.relname = 'users' AND i.indisunique
AND ARRAY(SELECT a.attname FROM unnest(i.indkey) WITH ORDINALITY k(attnum, ord)
JOIN pg_attribute a ON a.attrelid = t.oid AND a.attnum = k.attnum
ORDER BY k.ord)::text[] = ARRAY['username_normalized']`).Scan(&usernameUnique)
if err != nil {
t.Fatalf("unique username_normalized: %v", err)
}
if usernameUnique == 0 {
t.Error("contrainte UNIQUE(username_normalized) manquante sur users")
}
// idx_users_email a disparu (unicité V1 = username, jamais email)
var emailIdx int
err = conn.QueryRow(`
SELECT COUNT(*) FROM pg_index i
JOIN pg_class t ON t.oid = i.indrelid
WHERE t.relname = 'users' AND i.indisunique
AND ARRAY(SELECT a.attname FROM unnest(i.indkey) WITH ORDINALITY k(attnum, ord)
JOIN pg_attribute a ON a.attrelid = t.oid AND a.attnum = k.attnum
ORDER BY k.ord)::text[] = ARRAY['email']`).Scan(&emailIdx)
if err != nil {
t.Fatalf("email idx: %v", err)
}
if emailIdx != 0 {
t.Error("index UNIQUE(email) ne doit plus exister après 000006")
}
// --- 000007 : ownership ressources user ------------------------------
var plc string
err = conn.QueryRow(`
SELECT data_type FROM information_schema.columns
WHERE table_schema = 'public' AND table_name = 'resources' AND column_name = 'user_id'`).Scan(&plc)
if err != nil {
t.Errorf("colonne resources.user_id manquante après 000007: %v", err)
}
var resourceFkToUsers int
err = conn.QueryRow(`
SELECT COUNT(*) FROM pg_constraint c
JOIN pg_class t ON t.oid = c.conrelid
JOIN pg_class r ON r.oid = c.confrelid
WHERE t.relname = 'resources' AND r.relname = 'users' AND c.contype = 'f'
AND pg_get_constraintdef(c.oid) LIKE '%user_id%'`).Scan(&resourceFkToUsers)
if err != nil {
t.Fatalf("FK resources→users: %v", err)
}
if resourceFkToUsers == 0 {
t.Error("FK resources.user_id → users(id) manquante après 000007")
}
// operation_id outbox = id client (INTEGER) — cf. docs/api-v1.md §6.1
var opType string