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:
69
backend/migrations/env.py
Normal file
69
backend/migrations/env.py
Normal 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()
|
||||
25
backend/migrations/script.py.mako
Normal file
25
backend/migrations/script.py.mako
Normal 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"}
|
||||
42
backend/migrations/versions/0001_initial_schema.py
Normal file
42
backend/migrations/versions/0001_initial_schema.py
Normal 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")
|
||||
33
backend/migrations/versions/0002_share_expiry.py
Normal file
33
backend/migrations/versions/0002_share_expiry.py
Normal 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")
|
||||
Reference in New Issue
Block a user