Rend une instance exposee sur Internet exploitable sans la transformer en infrastructure : le produit reste local-first, sans compte et sans telemetrie. Protection du service : limitation de debit en memoire par client et par famille d'endpoint (health et ready jamais limites), interrupteur SHARING_ENABLED, capacite maximale de partages, taille propre aux partages. X-Forwarded-For n'est cru que si TRUST_PROXY_HEADERS l'autorise, et on lit alors la derniere valeur, celle ajoutee par le proxy. Expiration facultative des partages (24 h a 90 jours, ou jamais) : un lien expire repond 410 et la page publique le dit, sans autre detail. Le proprietaire peut prolonger ; aucune purge automatique. Protection des liens non repertories : robots.txt, X-Robots-Tag et meta robots sur /s/ et /api/, Referrer-Policy no-referrer sur tout le site, redaction des jetons dans les journaux d'acces, share_token porte a 128 bits (les anciens restent valides). Schema gere par Alembic, applique au demarrage. Une base creee avant Alembic est estampillee puis migree : verifie sur la base reelle de developpement, 4 partages inchanges et expires_at NULL. Administration par CLI locale au conteneur (stats, liste, suppression, purge, sauvegarde a chaud via l'API SQLite, restauration prudente) : aucune interface /admin exposee. Le jeton de gestion peut enfin etre exporte dans un fichier .openmind-share puis reimporte depuis un autre navigateur, apres verification aupres du serveur. Il n'est toujours jamais ajoute a un export .mmap. Ajoute une page /privacy dont le texte est centralise, et corrige un bug trouve en observant les logs : Alembic, lance dans le processus applicatif, reappliquait la configuration de logs d'alembic.ini et desactivait les loggers existants, ce qui faisait disparaitre les journaux d'acces. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
74 lines
2.1 KiB
Python
74 lines
2.1 KiB
Python
"""Erreurs metier du domaine partage.
|
|
|
|
Elles sont converties en reponses HTTP propres par les handlers de `app.main` :
|
|
aucune trace technique n'est exposee au client.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
|
|
class ShareError(Exception):
|
|
"""Erreur metier generique."""
|
|
|
|
status_code = 400
|
|
message = "Requete invalide."
|
|
|
|
def __init__(self, message: str | None = None) -> None:
|
|
super().__init__(message or self.message)
|
|
if message:
|
|
self.message = message
|
|
# En-tetes additionnels de la reponse (Retry-After, par exemple).
|
|
self.headers: dict[str, str] = {}
|
|
|
|
|
|
class ShareNotFoundError(ShareError):
|
|
status_code = 404
|
|
message = "Ce partage n'existe pas ou a ete supprime."
|
|
|
|
|
|
class ShareForbiddenError(ShareError):
|
|
status_code = 403
|
|
message = "Jeton de gestion invalide."
|
|
|
|
|
|
class SharePayloadTooLargeError(ShareError):
|
|
status_code = 413
|
|
message = "La carte depasse la taille maximale autorisee."
|
|
|
|
|
|
class ShareExpiredError(ShareError):
|
|
"""Le partage a existe mais sa date d'expiration est passee.
|
|
|
|
Statut distinct du 404 : c'est ce qui permet a la page publique d'afficher
|
|
"Ce partage a expire" plutot qu'un message d'absence. Rien d'autre n'est
|
|
revele : ni le titre, ni le contenu, ni la date de creation.
|
|
"""
|
|
|
|
status_code = 410
|
|
message = "Ce partage a expire."
|
|
|
|
|
|
class SharingDisabledError(ShareError):
|
|
status_code = 503
|
|
message = "Le partage est desactive sur cette instance."
|
|
|
|
|
|
class ShareCapacityError(ShareError):
|
|
status_code = 503
|
|
message = "Cette instance a atteint sa capacite maximale de partages."
|
|
|
|
|
|
class PermanentShareNotAllowedError(ShareError):
|
|
status_code = 400
|
|
message = "Cette instance n'autorise pas les partages sans expiration."
|
|
|
|
|
|
class RateLimitedError(ShareError):
|
|
status_code = 429
|
|
message = "Trop de requetes. Reessayez dans un instant."
|
|
|
|
def __init__(self, retry_after: int, message: str | None = None) -> None:
|
|
super().__init__(message)
|
|
self.retry_after = retry_after
|
|
self.headers["Retry-After"] = str(retry_after)
|