8.8 KiB
Découpage parallèle — Backend Kazier
Source : FEEDBACK.md (12 + A1-A16). But : 6 lots preneurs en parallèle, zéro chevauchement de fichiers.
Règle : chaque lot ne touche QUE ses fichiers. Si besoin transverse → note dans Besoins inter-lots, ne pas éditer hors lot.
Commande vérif par lot : cd backend && go test ./... (ou package ciblé). DB tests : TEST_DATABASE_URL si PG dispo, sinon skip OK.
LOT 1 — AUTH critique (A1, #4, #12, A15-part)
Fichiers exclusifs :
backend/pkg/passwd/passwd.gobackend/pkg/auth/auth.gobackend/config/config.gobackend/handlers/auth.gobackend/handlers/middleware.go
Tâches :
- A1 :
dummyHashaléatoire par boot (plus de"kazier-constantime-dummy"en dur).AuthLogin: early-return siuserErr != nil, ne jamais toucheruser.IDquand nil. Ajouter test : login user inconnu + password dummy → 401, pas 500. - #4 :
AUTH_SECRET: refuser défautdev-secret-change-meen prod (ex.if ENV=prod && secret==défaut → Fatal), exiger longueur ≥ 32, doc.env.example. - #12 : casser l'oracle : même code/délai que device existe ou non (vérifier device AVANT ou uniformiser 401). Ajouter rate-limit basique ou hook (même no-op + TODO).
- A15-part :
Verify: rejeteruserID/deviceIDnon^[0-9a-f]{32}$. Middleware : optionEnforceDeviceExists(défaut off, documenté) ou au moins log.
Ne pas toucher : handlers/devices.go (LOT 6), repository/* (LOT 4).
Acceptance : go test ./pkg/passwd/... ./pkg/auth/... ./handlers/... OK + test regression A1.
LOT 2 — UPLOAD safe (A2, A3, A4, #5, #6, A16-part)
Fichiers exclusifs :
backend/service/resources.gobackend/handlers/files.go
Tâches :
- #5 : sanit
extension:[a-z0-9]{1,10}lowercase, sinon""oubin.destPathsansextsi vide (pas deid.). Rejeter/,.., très long. - A2 : service :
io.LimitReader(src, MaxFileSize+1)+ vérifier octets écrits, retournerErrFileTooLargemême si header ment. - A3 : écriture atomique : temp
destDir/.tmp-<id>+Fsync+Rename. Pas d'overwrite direct. - #6 : au
UpdatePhysical: listerGlob(id.*)ancien,Removeles autres ext. SurInsertfail →Remove(destPath). SurGetFilefail après insert → tenter cleanup, au moins log. - A4 :
MkdirAll 0700, fichier0600(OpenFile+Chmod). Vérifier umask. - A16-part :
file.Filename→name:TrimSpace, cap 255, rejeter vide///\n.Content-Type: whitelist ou fallbackapplication/octet-stream.intParam/page/pageSize: cap + 400 si négatif (pas fallback silencieux),q:MaxLen 200.
Acceptance : tests service upload : header menteur, ext vide/malicieuse, re-upload change ext → un seul fichier physique, perms 0600/0700.
LOT 3 — SYNC core (#3, #7, A8, A9)
Fichiers exclusifs :
backend/service/sync.gobackend/repository/operations.gobackend/repository/shares.go
Tâches :
- #7 : rendre
ApplyBatchatomique par op :SELECT ... FOR UPDATEou transactionApplied→apply→Record.Recordfail → retournerapplied:iexplicite, pas 500 nu. - #3 :
CreateLinkidempotent :ON CONFLICT (id) DO NOTHING+ vérifier owner identique, sinonNAME_CONFLICT. - A9 : stocker
payload_hash (sha256)dansoperations, au replay même(device,op)comparer hash : différent →INVALID_REQUEST(pas skip silencieux). Migration000011. - A8 : uniformiser sémantiques :
update_metadataabsent →NOT_FOUNDhalt (pas no-op applied) ;move/deletenon-owned →NOT_FOUND(pas applied silencieux) ; documenter choix.create:ExistsOwner+Inserten transaction ouON CONFLICT DO NOTHING+ check owner. classifySyncError: ne plus fuirerr.Error()brut (#8-part) : messages génériques + log interne.
Ne pas toucher : repository/resources.go (LOT 4) — si besoin, exposer interface, pas d'édit direct.
Acceptance : tests service/sync_test.go : replay même op, replay payload muté, create_link rejoué, move/delete grantee.
LOT 4 — DATA ownership + migrations (#9, #10, A10, + parent-check)
Fichiers exclusifs :
backend/repository/users.gobackend/repository/resources.gobackend/repository/devices.gobackend/service/bootstrap.gobackend/db/migrations/*backend/db/db.go(lecture seule sauf si besoin migration)
Tâches :
- #9+A10 :
Count()→WHERE deleted_at IS NULL.UpdatePassword/MarkDeleted/GetByID: ajouterAND deleted_at IS NULL+ checkRowsAffected→ErrNotFoundsi 0. - #10 :
000007: supprimerDELETE FROM resources(backfillowner_idvia user admin ou colonne nullable + migration douce).000008 down: down sans::bigint(ex. recréer colonne bigint + drop text, ou marquer irréversible avec message clair). - Parent-check atomique :
InsertFolder/InsertFile/MoveResource:INSERT ... SELECTou transactionSELECT parent FOR SHARE → INSERT, FK 500 → mapperNOT_FOUND. TouchResource/UpdateNameByID: ajouter variantes scopéesTouchOwned(ownerID,...),UpdateNameOwned(...), laisser anciennes endeprecated(LOT 3 migrera ensuite).NewID()(A5) : retourner(string,error)OUMustNewID+NewIDErr. Choisir une signature, mettre à jour appelants uniquement dans ces fichiers.
Acceptance : go test ./repository/... ./service/... ./db/... + test soft-deleted login/bootstrap.
LOT 5 — OCR + INFRA (A11, A12-part, A13, A14, #11)
Fichiers exclusifs :
backend/service/ocr.gobackend/repository/ocr_jobs.gobackend/ocr/*backend/cmd/server/main.gobackend/service/services.go,move.go,upload.go,folders.go(suppression)
Tâches :
- #11 : supprimer les 4 stubs
UserCan*toujours-true. - A11 : transitions gardées :
Complete/ Fail WHERE status='processing',TouchProcessing WHERE status='queued', checkRowsAffected.ResetStaleProcessingsur horloge DB (now() - interval), inclurestarted_at IS NULL. Ajouter index(status,created_at)(migration000012— coordonner nom avec LOT 4 pour éviter collision : LOT 5 prend000012, LOT 4 prend000011, LOT 3 payload_hash prend000013). - A13 :
Failavecerr,CompletevérifieUpdateOcrText RowsAffected, sinonFail.tesseract.go:context.WithTimeoutpar job (ex. 120s),LimitReaderstdout/stderr (ex. 2MB), cap pages PDF (ex. 50) + erreur si tronqué, pascontinuesilencieux. - A12-part :
physicalPath:Lstat,IsRegular,EvalSymlinks∈UPLOAD_DIR.OCR_LANG: whitelist^[a-z+]{2,20}$. - A14 :
main.go: un seul pool (réutiliserconnpour migrate),defer conn.Close(), worker OCR avecWaitGroup+ shutdown 5s documenté. Bootstrap : retry duplicateusername_normalizedouON CONFLICT DO NOTHING.
Acceptance : go test ./ocr/... ./service/... ./repository/... + test double-complete, stale requeue.
LOT 6 — CONTRACT + DEVICE (A6, A7, §1 route, devices, secret-doc)
Fichiers exclusifs :
backend/handlers/router.gobackend/handlers/share_links.gobackend/handlers/sync.gobackend/handlers/devices.gobackend/handlers/health.go(tests seulement si besoin)backend/cmd/server/router_test.gobackend/pkg/api/response.go(messages génériques seulement)
Tâches :
- §1 : réordonner
GET /files/foldersavantGET /files/:id+ testfolders→200,:id=folders→404(verrouille, même si Gin priorise statique). - A6 :
ShareLinkGet:errors.Is(err, ErrNotFound). - A7 :
ExpiresAt: utiliserexpdu token (retournerAuthou parser), pasNow()+TTL.TOKEN_ERROR→INTERNAL. 32-hex malformé →400 INVALID_REQUESTpartout (alignerfiles.gosurdevices.go).intParam/after: 400 si garbage/négatif (pas fallback 0),Atoi64-bit pour epoch-ms.Bearer: accepterbearercase-insensitive (option). - Devices :
POST /devices: rate-limit/TODO + doc.MarkUser: checkRowsAffected(device supprimé → 404). response.go: messages génériques côté client, détail en log serveur (#8-part lot 6).
Acceptance : router_test.go étendu + tests handlers 400/404 cohérents.
Ordre et dépendances
- Démarrage immédiat possible : LOT 1, LOT 2, LOT 5, LOT 6 (aucune dépendance mutuelle).
- LOT 3 et LOT 4 se touchent via
repository/resources.go: LOT 4 seul l'édite. LOT 3 utilise l'interface existante, migrera vers*Ownedau tour suivant. - Migrations : LOT 4 =
000011, LOT 5 =000012, LOT 3 =000013. Ne pas réutiliser un numéro. NewID()signature (LOT 4) : prévenir LOT 2/LOT 3 après merge, pas avant.
Besoins inter-lots (ne pas éditer, juste signaler)
- LOT 3 → LOT 4 : besoin
TouchOwned/UpdateNameOwned,INSERT ... SELECTparent. - LOT 5 → LOT 2 :
physicalPathsafe partagé après merge LOT 2. - Tous → LOT 6 : après uniformisation 400/404, aligner messages d'erreur.