Format .mmap v4 : `node.side` (cote d'une branche de niveau 1) et `MindMap.relations` (relations secondaires). Migration v3 -> v4 sans perte, les cartes v1/v2/v3 restent ouvrables telles quelles. Une relation est une connexion purement visuelle : elle ne touche jamais parentId, order, les enfants, le repli ni l'auto-layout. `withEdges()` continue de deriver les liens de parentId et se contente de retirer les relations dont une extremite a disparu. Mind map bilaterale : repartition gloutonne et deterministe des branches selon la taille des sous-arbres, heritage du cote par sous-arbre, deux passes dagre recalees sur la racine. Choisir une disposition ne deplace plus la carte : seul Reorganiser applique. Ajoute aussi une galerie de huit modeles locaux, l'import Markdown (fichier ou texte, nouvelle carte ou sous-arbre) reutilisant l'analyseur d'outline existant, et l'export Markdown de la hierarchie. Corrige un bug de rendu : React Flow ne remesure pas les poignees quand elles changent de cote, ce qui faisait disparaitre les liens concernes. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
91 lines
3.2 KiB
Python
91 lines
3.2 KiB
Python
"""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 MapRelationIn(BaseModel):
|
|
"""Relation secondaire (format v4).
|
|
|
|
Purement visuelle : le backend ne l'interprete pas, il verifie seulement
|
|
qu'elle est bien formee. Une relation qui boucle sur elle-meme est refusee,
|
|
comme cote frontend : les deux validations disent la meme chose.
|
|
"""
|
|
|
|
model_config = ConfigDict(extra="allow")
|
|
|
|
id: str = Field(min_length=1, max_length=128)
|
|
# Les noms suivent le document JSON du frontend, d'ou le camelCase.
|
|
sourceId: str = Field(min_length=1, max_length=128)
|
|
targetId: str = Field(min_length=1, max_length=128)
|
|
label: str | None = Field(default=None, max_length=120)
|
|
|
|
@model_validator(mode="after")
|
|
def _check_endpoints(self) -> MapRelationIn:
|
|
if self.sourceId == self.targetId:
|
|
raise ValueError("Une relation doit relier deux noeuds differents.")
|
|
return self
|
|
|
|
|
|
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)
|
|
relations: list[MapRelationIn] = 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.")
|
|
|
|
max_relations = get_settings().max_nodes * 2
|
|
if len(self.relations) > max_relations:
|
|
raise ValueError(f"La carte depasse la limite de {max_relations} relations.")
|
|
return self
|