Files
Kazier/CHANGELOG.md
T
venture 4316da578f
Release / release-apk (push) Successful in 8m58s
Release / release-docker (push) Successful in 3m47s
CI / docker (push) Successful in 7s
CI / lint-backend (push) Successful in 1m44s
CI / lint-mobile (push) Failing after 18m59s
CI / test-backend (push) Successful in 2m12s
CI / test-mobile (push) Successful in 8m50s
CI / build-backend (push) Successful in 45s
V3 S7 : preview cloud + export chiffré + release 1.2.0
Backend : resource_previews (000024), GET /files/:id/preview (JPEG
512, images pur Go, PDF page 1 via pdftoppm + poppler au Dockerfile,
cache régénéré sur changement, 404 NO_PREVIEW sinon), POST /export
{password 8+} -> zip AES-256 streamé (fichiers vifs possédés +
manifest.json avec faits, metadata-only sans octets). Deps :
alexmullins/zip, x/image directs. Tests service + handlers + migrations.

Mobile : vignettes distantes (une requête/session puis cache WebP
versionné, garde tried, icône sinon), FileThumbnail cloud-only,
export (mot de passe jamais persisté, cache + partage FileProvider),
bouton Partager ACTION_SEND. Impression papier reportée V4. FR/EN.

Contrat docs/api-v1.md, V3.md (S7 livré, V3 close), AGENTS.md,
VERSION 1.2.0 + CHANGELOG.
2026-09-26 15:08:31 +02:00

9.8 KiB

Changelog

Toutes les modifications notables de Kazier sont documentées ici. Le format suit Keep a Changelog et le versioning est SemVer.

[Unreleased]

[1.2.0] - 2026-09-26

V3 « Le classeur qui comprend » : filet anti-perte, extraction générique, recherche plein-texte + facettes, graphe documentaire, confiance & partage sobre, preview cloud, export chiffré. Contrat consolidé (docs/api-v1.md), vision et plan (V3.md).

Ajouté

  • Corbeille V3 (S1 backend) : DELETE /files/:id = trash par défaut (?mode=purge = définitif), POST /files/:id/restore, GET /trash (paginé), trash/restore récursifs (subtree + chaîne d'ancêtres), purge auto serveur après 30j (TrashRetention, passe au boot + horaire).
  • Versions V3 (S1 backend) : table resource_versions (N=3, élagage auto), historique figé à chaque overwrite (Upload ciblé), GET /files/:id/versions + POST /files/:id/versions/:n/restore (l'actuel est à son tour versionné), upload ciblé vers trashé → NOT_FOUND.
  • Outbox : ops trash_resource / restore_resource / purge_resource (owner-only, delete_resource legacy mappé vers trash, même idempotence) ; purge d'octets best-effort côté serveur.
  • Migrations 000017 (index corbeille) + 000018 (versions), contrat docs/api-v1.md §3/§6.1 étendu, test de contrat router_test.go.
  • Extract générique V3 (S2 backend) : package extract (règles FR stdlib — dates/échéances/périodes/montants/émetteurs/références masquées/doc_type suggéré, confiances, corpus testé), table resource_facts (migration 000019, origin auto/user), hook worker OCR (OnText + backfill boot borné, best-effort, anti-panic), GET /files/:id/facts (viewer+, [] si vide, 404 si trashé/étranger).
  • Corrections V3 (S3) : PATCH /files/:id/facts + op correct_facts (full-replace du jeu user, editor+, validation Go → 400 jamais 500), Room v20 (resource_facts + FactsDao, migration 19→20), fiche « Ce qu'on a compris » sur le viewer (chips, confiance grisée + suggéré, édition par type, reset auto), FactsRepository (sync remplace-en-bloc, correction optimiste + outbox atomique), GET /files/:id/facts consommé côté client.
  • Recherche V3 (S4) : colonne search_tsv (migration 000020, french, index GIN) + SearchDocumentsVisible (nom LIKE + TS + faits, rang nom > TS > fait sûr > fait douteux, facettes émetteur/type/montant/période), GET /files/search étendu (400 si facette malformée), Room v21 (FTS4 files_fts + triggers partagés fresh-install/migration, entité déclarée pour KSP), searchDocuments offline (même rang, accents préservés) + UI filtres (émetteur, types chips, montants, période ISO, compteur, effacer).
  • Relations V3 (S5) : table resource_links + scan_session_id (migration 000021), réconciliation déterministe (same_scan via outbox, doublons via SHA-256 posé à l'upload + backfill boot, same_issuer/référence via faits effectifs, verdicts préservés, élagage auto), GET /files/:id/relations + verdict (owner-only), GET /duplicates (groupes + gain récupérable), Room v22 (links + collections), « Voir aussi » dans la fiche (verdicts en ligne), écran Doublons (garder le plus récent), collections locales (sauver/rejouer/supprimer depuis la recherche), scanSessionId dans les creates de scan.
  • Confiance V3 (S6) : token_version (migration 000022, claim tv, 401 si révoqué, bump au changement de mot de passe — fin de la limite V1), quota (colonne héritée de 000001, 000023 idempotente, 413 QUOTA_EXCEEDED sur créations, GET /users/me/usage), appareils (GET /devices, DELETE /devices/:id, EnforceDeviceExists en prod, écran Appareils + quota), renames concurrents transparents (baseUpdatedAt + conflicts[] non-fataux, gracieuseté 2 s, pipeline mobile persistance + dialogue), liens à expiration 7j par défaut, import « classeur » unifié (scan/note/dossier), onboarding cercle Famille.
  • Corbeille V3 (S1 mobile, Room v19) : colonne trashed_at (files + folders, migration 18→19), tombstone exists = 0 (requêtes exists = 1 inchangées), FileDeleter/FolderDeleter/SafFileDeleter → ops trash_resource (plus de delete_resource émis), garde walk anti-résurrection + reconcile, TrashRepository (restore/purge/convergence GET /trash/expiration locale 31j), écran Corbeille (Réglages → restore/purge avec confirmation), expiration tombstones dans RetentionWorker, dialogue de suppression rewordé (corbeille 30j, plus « irréversible »).
  • Preview cloud V3 (S7) : table resource_previews (migration 000024), GET /files/:id/preview (JPEG 512, images pur Go, PDF page 1 via pdftoppm + poppler au Dockerfile, cache régénéré sur changement, 404 NO_PREVIEW sinon), vignettes distantes côté mobile (une requête/session puis cache WebP versionné, garde tried, icône sinon).
  • Export chiffré V3 (S7 C3) : POST /export { password 8+ } → zip AES-256 streamé (fichiers vifs possédés + manifest.json avec faits, tout chiffré, metadata-only sans octets), mobile (mot de passe jamais persisté, téléchargement cache, partage système via FileProvider), bouton Partager (ACTION_SEND local) sur le viewer — impression papier reportée (V4, pas de dep print).

[1.1.0] - 2026-09-25

Ajouté

  • Upload V2 des octets : worker BytesUploadWorker (fichier par fichier, overwrite ciblée idempotente, cap 3 échecs, backoff), marqueurs bytes_uploaded/bytes_upload_attempts (Room v17, migration 16→17), multipart SAF mutualisé (SafMultipart.kt).
  • Flag serveur has_content (migration 000014, lazy healing : TRUE à l'upload / au OpenContent réussi, FALSE si octets disparus), exposé en FileDto.hasContent + miroir Room has_content_server (v18).
  • Download V2 hors-ligne : DownloadWorker (fichier par fichier, écriture SAF dossier propre sinon racine, rattachement même resource_id, walk convergent par URI), marqueurs has_content_server/wanted_offline (Room v18, migration 17→18), bouton « Rendre disponible hors-ligne » dans le viewer distant.
  • Purge sûre V2-3 « libérer de l'espace » : gate isReleasable (copie serveur connue), détachement cloud-only sans op outbox, bouton viewer + action multi-sélection.
  • Placements multi-device : tables storage_locations + resource_placements (migration 000015), op outbox report_bytes (viewer+, nouvel operation_id par état, dead-letter sans bloquer la file), GET /files/:id/placements (owner-only), reporting auto (upload/download/release/delete locale), section copies dans le sheet de partage.
  • Rétention auto : règle all | last_months:N (RetentionStore), passe quotidienne RetentionWorker (purge sûre, sans réseau), réglages stockage (stats récupérables + libération manuelle).
  • Groupes V2-6 (backend) : tables groups + group_members (migration 000016, un niveau), CRUD + membres (owner-only), partage vers groupe via outbox (granteeGroupId, snapshot + enforcement étendus), GROUP_NOT_FOUND, lecture grants avec granteeKind.
  • Groupes V2-6 (mobile) : section groupes du sheet (création, membres, suppression, partage au groupe), badge groupe sur les grants, endpoints CRUD + membres.

Corrigé

  • 401 sans session (mode local / jamais connecté) : ignoré sans purge ni événement — un appel égaré n'éjecte plus vers le login.

[1.0.0] - 2026-09-25

Ajouté

  • Streaming lecture des fichiers distants : GET /files/:id/content (binaire brut, Range, viewer+), viewer mobile à la demande sans persistance (image/texte/PDF multi-pages, autres types non supportés).
  • Gestion du partage côté owner : GET /files/:id/shares + GET /files/:id/links, sheet mobile (grants modifiables/révocables, liens création/copie/révocation, ouverture de lien, badge pending outbox), deep-link kazier://share/<token> + écran de résolution.
  • Re-login silencieux : identifiants chiffrés persistés, renouvellement auto sur 401 (single-flight, file conservée si même compte), écran login avec avis d'expiration + username pré-rempli.
  • Pipeline de release CI (GitLab) : lint, tests backend/mobile, build Docker, signature APK release, publication GitLab Release + Docker Hub.
  • backend/Dockerfile multi-stage : image de production avec Tesseract (fra+eng) embarqué, user non-root, labels OCI.
  • Service backend actif dans docker-compose.yml (déploiement conteneurisé).
  • Signature release Android (signing.properties non commité, assembleRelease).
  • Scripts mise build:release, mise docker:build, mise release.
  • Licence AGPLv3, badge README, CHANGELOG.md.
  • Versioning Android aligné sur le VERSION racine (versionCode dérivé).

Changé

  • Renommage : VaultDrop → Kazier. Marque, package Android (com.kazier.mobile), module Go (github.com/kazier/backend), binaire/image kazier-server, creds Postgres par défaut. Le code interne dot.db est conservé.

Corrigé

  • Docs : en-tête docs/api-v1.md (référence à l'ancien client Expo remplacée par le client Kotlin), quickstart et docker de la doc Starlight.
  • .gitignore racine (uploads, binaires, keystore, artifacts).

[0.1.0] - 2026-09-15

Première version publique.

Ajouté

  • Backend Go/Gin : auth user-first (paseto v4-local), devices, users (resolve, change password), CRUD fichiers/dossiers, upload multipart, recherche, sharing, sync outbox idempotente + snapshot permissions, OCR jobs (Tesseract), migrations Postgres testées.
  • Client Android Kotlin : local-first Room (v7, migrations, DAO), SAF scanner deux passes, outbox transactionnel + worker WorkManager, recherche locale, génération PDF, scanner de documents, thumbnails, mode sombre, i18n FR/EN.
  • Contrat API V1 consolidé (docs/api-v1.md), test de contrat de routes.
  • Site de promotion public + documentation Starlight/Astro (FR/EN, versionnée).