> ## Documentation Index
> Fetch the complete documentation index at: https://api-documentation.kare-app.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Arborescence dans S3

Où sont rangés les fichiers (photos, documents, exports) dans le stockage.

## Rangement des fichiers utilisateurs

Un seul rangement, valable pour toutes les catégories : `organisation/{id}/{catégorie}/{identifiant}/{nom du fichier}` (ou `bibliothèque/{catégorie}/...` pour le contenu partagé). Catégories : images, documents, pièces jointes.

* Le nom de fichier d'origine est conservé (juste sécurisé, pas transformé) pour les documents et pièces jointes.
* Seules les images perdent leur nom d'origine, remplacé par un identifiant — elles ne sont jamais retéléchargées sous leur nom de départ.

## Trois espaces de stockage séparés

| Espace  | Contenu                                                                     | Règle                                                                                                                                                         |
| ------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Uploads | Photos d'anomalies, pièces jointes, scans envoyés par les utilisateurs      | Jamais supprimé automatiquement ; peut être verrouillé contre toute modification ou suppression pendant une durée réglementaire (valeur probante du registre) |
| Exports | PDF de rapports, exports CSV générés à la demande                           | Jetable — supprimé automatiquement après un certain temps                                                                                                     |
| Assets  | Modèles de PDF, logos, polices — contenu partagé pour générer des documents | Persistant, jamais purgé                                                                                                                                      |

### Décision — Exports

<Tip>
  Les exports suivent le même rangement générique que les uploads (`organisation/{id}/{type d'export}/...`), plutôt qu'un chemin câblé en dur par type d'export. Un seul principe de rangement dans toute l'application, pas un système à part pour les fichiers générés.
</Tip>

### Décision — Assets partagés (branding)

<Tip>
  Le bucket assets reste privé par défaut. Seul un sous-dossier dédié aux visuels de marque utilisés dans les emails (logo, icônes) est rendu public — jamais l'ensemble du bucket. Le reste (modèles de PDF, polices) n'a aucune raison d'être accessible sans authentification : ces fichiers sont utilisés par le serveur pour générer des documents, jamais chargés directement par un navigateur ou un client externe.
</Tip>

## Principe transverse

<Tip>
  L'appartenance d'un fichier à une organisation n'est jamais reconstruite depuis son chemin de stockage — elle est toujours lue depuis la base de données. Ça évite qu'une évolution future du rangement casse silencieusement la suppression ou le décompte de quota.
</Tip>

[Quota de stockage](/product/quota-de-stockage)