OpenMind v1 : cartes mentales libres, local-first et dockerisees

Premiere version fonctionnelle, demarrable avec `docker compose up -d --build`
sur http://localhost:8080.

Architecture
- Frontend React 18 / TypeScript strict / Vite / Tailwind, canvas @xyflow/react,
  etat Zustand, persistance IndexedDB via Dexie, auto-layout dagre.
- Backend FastAPI / SQLAlchemy 2 / Pydantic v2 / SQLite, qui sert aussi les
  fichiers statiques du frontend compile.
- Image Docker multi-stage, un seul service, bind mount ./data pour SQLite.

Local-first
Les cartes restent dans le navigateur. Le serveur ne recoit une carte que sur
demande explicite de partage.

Partage
Deux secrets distincts : share_token public en lecture seule dans l'URL, et
management_token conserve uniquement cote client, transmis en en-tete pour les
modifications et stocke hashe en base.

Fonctionnalites
Tableau de bord, editeur complet (undo/redo, copier/coller, raccourcis,
branches repliables, recherche), 9 themes, 4 dispositions automatiques,
panneau de proprietes, import/export .mmap, export PNG/SVG/PDF, impression,
page publique en lecture seule, PWA.

Qualite
25 tests pytest et 43 tests vitest au vert, ruff et ESLint sans erreur,
TypeScript strict sans erreur.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-09-08 22:19:18 +02:00
commit 0b2e5e326d
113 changed files with 14576 additions and 0 deletions

View File

@@ -0,0 +1,62 @@
"""Validation Pydantic du document carte envoye au serveur.
Le backend ne cherche pas a comprendre finement une carte : il valide sa
structure, ses limites de taille, puis la stocke telle quelle. `extra="allow"`
garantit qu'une version future du format frontend reste acceptee.
"""
from __future__ import annotations
from typing import Any
from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
from app.config import get_settings
MAX_SUPPORTED_MAP_VERSION = 100
class MapNodeIn(BaseModel):
model_config = ConfigDict(extra="allow")
id: str = Field(min_length=1, max_length=128)
text: str = Field(default="", max_length=5000)
class MapEdgeIn(BaseModel):
model_config = ConfigDict(extra="allow")
id: str = Field(min_length=1, max_length=256)
source: str = Field(min_length=1, max_length=128)
target: str = Field(min_length=1, max_length=128)
class MapDocumentIn(BaseModel):
"""Document carte complet, tel que produit par le frontend."""
model_config = ConfigDict(extra="allow")
version: int = Field(ge=1, le=MAX_SUPPORTED_MAP_VERSION)
id: str = Field(min_length=1, max_length=128)
name: str = Field(default="", max_length=255)
nodes: list[MapNodeIn] = Field(default_factory=list)
edges: list[MapEdgeIn] = Field(default_factory=list)
viewport: dict[str, Any] = Field(default_factory=dict)
settings: dict[str, Any] = Field(default_factory=dict)
@field_validator("nodes")
@classmethod
def _check_node_count(cls, value: list[MapNodeIn]) -> list[MapNodeIn]:
max_nodes = get_settings().max_nodes
if len(value) > max_nodes:
raise ValueError(
f"La carte depasse la limite de {max_nodes} noeuds ({len(value)} noeuds fournis)."
)
return value
@model_validator(mode="after")
def _check_edge_count(self) -> MapDocumentIn:
max_edges = get_settings().max_nodes * 4
if len(self.edges) > max_edges:
raise ValueError(f"La carte depasse la limite de {max_edges} liens.")
return self