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:
15
backend/app/schemas/__init__.py
Normal file
15
backend/app/schemas/__init__.py
Normal file
@@ -0,0 +1,15 @@
|
||||
from app.schemas.map import MapDocumentIn
|
||||
from app.schemas.share import (
|
||||
ShareCreatedOut,
|
||||
ShareCreateIn,
|
||||
SharePublicOut,
|
||||
ShareUpdatedOut,
|
||||
)
|
||||
|
||||
__all__ = [
|
||||
"MapDocumentIn",
|
||||
"ShareCreateIn",
|
||||
"ShareCreatedOut",
|
||||
"SharePublicOut",
|
||||
"ShareUpdatedOut",
|
||||
]
|
||||
62
backend/app/schemas/map.py
Normal file
62
backend/app/schemas/map.py
Normal 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
|
||||
51
backend/app/schemas/share.py
Normal file
51
backend/app/schemas/share.py
Normal file
@@ -0,0 +1,51 @@
|
||||
"""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
|
||||
|
||||
|
||||
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
|
||||
|
||||
|
||||
class ShareUpdatedOut(BaseModel):
|
||||
share_token: str
|
||||
share_path: str
|
||||
title: str
|
||||
updated_at: datetime
|
||||
|
||||
|
||||
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
|
||||
Reference in New Issue
Block a user