snoopy
49870dcd56
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>
78 lines
2.0 KiB
Python
78 lines
2.0 KiB
Python
"""Schemas d'entree/sortie de l'API de partage."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from datetime import datetime
|
|
|
|
from pydantic import BaseModel, ConfigDict, Field
|
|
|
|
from app.schemas.map import MapDocumentIn
|
|
|
|
|
|
class ShareCreateIn(BaseModel):
|
|
"""Corps de POST /api/shares et de PUT /api/shares/{token}."""
|
|
|
|
model_config = ConfigDict(extra="forbid")
|
|
|
|
title: str = Field(default="", max_length=255)
|
|
map: MapDocumentIn
|
|
# Absent = valeur par defaut de l'instance ; null explicite = permanent.
|
|
expires_in_days: int | None = Field(default=None, ge=1, le=3650)
|
|
# Distingue "champ absent" de "null explicite", que Pydantic ne separe pas.
|
|
permanent: bool = False
|
|
|
|
|
|
class ShareExpiryIn(BaseModel):
|
|
"""Corps de PATCH /api/shares/{token} : uniquement l'expiration."""
|
|
|
|
model_config = ConfigDict(extra="forbid")
|
|
|
|
expires_in_days: int | None = Field(default=None, ge=1, le=3650)
|
|
permanent: bool = False
|
|
|
|
|
|
class ShareCreatedOut(BaseModel):
|
|
"""Reponse renvoyee une seule fois, a la creation du partage.
|
|
|
|
`management_token` n'est jamais renvoye ailleurs et n'apparait jamais
|
|
dans une URL publique : il est conserve par le proprietaire.
|
|
"""
|
|
|
|
share_token: str
|
|
management_token: str
|
|
share_path: str
|
|
title: str
|
|
created_at: datetime
|
|
updated_at: datetime
|
|
expires_at: datetime | None = None
|
|
|
|
|
|
class ShareUpdatedOut(BaseModel):
|
|
share_token: str
|
|
share_path: str
|
|
title: str
|
|
updated_at: datetime
|
|
expires_at: datetime | None = None
|
|
|
|
|
|
class ShareOwnerOut(BaseModel):
|
|
"""Vue reservee au detenteur du jeton de gestion. Aucune donnee de carte."""
|
|
|
|
share_token: str
|
|
title: str
|
|
created_at: datetime
|
|
updated_at: datetime
|
|
expires_at: datetime | None = None
|
|
|
|
|
|
class SharePublicOut(BaseModel):
|
|
"""Vue publique : aucune information de gestion."""
|
|
|
|
share_token: str
|
|
title: str
|
|
map_version: int
|
|
map: dict
|
|
created_at: datetime
|
|
updated_at: datetime
|
|
expires_at: datetime | None = None
|