Phase 2.1 : preparation au deploiement public

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>
This commit is contained in:
2026-09-10 09:22:17 +02:00
parent e3c530348e
commit 49870dcd56
51 changed files with 3341 additions and 110 deletions

69
backend/migrations/env.py Normal file
View File

@@ -0,0 +1,69 @@
"""Environnement Alembic d'OpenMind.
L'URL de la base vient toujours de la configuration applicative
(`DATABASE_URL`) : il n'y a pas de seconde source de verite dans alembic.ini.
"""
from __future__ import annotations
from logging.config import fileConfig
from alembic import context
from sqlalchemy import engine_from_config, pool
from app.config import get_settings
from app.db.base import Base
from app.models import share as _share_model # noqa: F401 (enregistre la table)
config = context.config
# `fileConfig` reconfigure tout le systeme de logs et desactive les loggers
# existants. C'est le comportement voulu quand Alembic est lance en ligne de
# commande, mais destructeur quand les migrations tournent dans le processus de
# l'application : les logs d'acces d'uvicorn disparaitraient. L'appelant
# embarque pose donc `configure_logger = False`.
if config.config_file_name is not None and config.attributes.get("configure_logger", True):
fileConfig(config.config_file_name, disable_existing_loggers=False)
# L'appelant peut imposer une URL (tests, outillage). Sinon, on prend celle de
# la configuration applicative : il n'y a jamais d'URL ecrite dans alembic.ini.
if not config.get_main_option("sqlalchemy.url", None):
config.set_main_option("sqlalchemy.url", get_settings().database_url)
target_metadata = Base.metadata
def run_migrations_offline() -> None:
context.configure(
url=config.get_main_option("sqlalchemy.url"),
target_metadata=target_metadata,
literal_binds=True,
dialect_opts={"paramstyle": "named"},
render_as_batch=True,
)
with context.begin_transaction():
context.run_migrations()
def run_migrations_online() -> None:
connectable = engine_from_config(
config.get_section(config.config_ini_section, {}),
prefix="sqlalchemy.",
poolclass=pool.NullPool,
)
with connectable.connect() as connection:
context.configure(
connection=connection,
target_metadata=target_metadata,
# SQLite ne sait pas modifier une colonne en place : le mode "batch"
# recree proprement la table quand c'est necessaire.
render_as_batch=True,
)
with context.begin_transaction():
context.run_migrations()
if context.is_offline_mode():
run_migrations_offline()
else:
run_migrations_online()

View File

@@ -0,0 +1,25 @@
"""${message}
Revision ID: ${up_revision}
Revises: ${down_revision | comma,n}
Create Date: ${create_date}
"""
from __future__ import annotations
from alembic import op
import sqlalchemy as sa
${imports if imports else ""}
revision = ${repr(up_revision)}
down_revision = ${repr(down_revision)}
branch_labels = ${repr(branch_labels)}
depends_on = ${repr(depends_on)}
def upgrade() -> None:
${upgrades if upgrades else "pass"}
def downgrade() -> None:
${downgrades if downgrades else "pass"}

View File

@@ -0,0 +1,42 @@
"""Schema initial : table shared_maps telle qu'elle existait avant Alembic.
Cette revision decrit l'etat produit par `Base.metadata.create_all` dans les
versions precedentes d'OpenMind. Sur une base existante, elle n'est jamais
executee : la table est deja la, et le demarrage se contente d'estampiller
cette revision (voir `app/db/migrations.py`). Elle sert donc uniquement aux
installations neuves.
Revision ID: 0001_initial_schema
Revises:
"""
from __future__ import annotations
import sqlalchemy as sa
from alembic import op
revision = "0001_initial_schema"
down_revision = None
branch_labels = None
depends_on = None
def upgrade() -> None:
op.create_table(
"shared_maps",
sa.Column("id", sa.Integer(), autoincrement=True, nullable=False),
sa.Column("share_token", sa.String(length=64), nullable=False),
sa.Column("management_token_hash", sa.String(length=64), nullable=False),
sa.Column("title", sa.String(length=255), nullable=False),
sa.Column("map_version", sa.Integer(), nullable=False),
sa.Column("map_data", sa.Text(), nullable=False),
sa.Column("created_at", sa.DateTime(timezone=True), nullable=True),
sa.Column("updated_at", sa.DateTime(timezone=True), nullable=True),
sa.PrimaryKeyConstraint("id"),
)
op.create_index("ix_shared_maps_share_token", "shared_maps", ["share_token"], unique=True)
def downgrade() -> None:
op.drop_index("ix_shared_maps_share_token", table_name="shared_maps")
op.drop_table("shared_maps")

View File

@@ -0,0 +1,33 @@
"""Ajoute l'expiration facultative des partages.
Migration volontairement additive : une seule colonne nullable et son index.
Aucune ligne n'est reecrite, aucune table n'est recreee, aucune donnee n'est
perdue. Les partages existants recoivent `expires_at = NULL`, c'est-a-dire
"pas d'expiration", et restent donc valides exactement comme avant.
Revision ID: 0002_share_expiry
Revises: 0001_initial_schema
"""
from __future__ import annotations
import sqlalchemy as sa
from alembic import op
revision = "0002_share_expiry"
down_revision = "0001_initial_schema"
branch_labels = None
depends_on = None
def upgrade() -> None:
op.add_column(
"shared_maps",
sa.Column("expires_at", sa.DateTime(timezone=True), nullable=True),
)
op.create_index("ix_shared_maps_expires_at", "shared_maps", ["expires_at"])
def downgrade() -> None:
op.drop_index("ix_shared_maps_expires_at", table_name="shared_maps")
op.drop_column("shared_maps", "expires_at")