Yopadd · Nov 6, 2026 · Nov 6, 2026 · Nov 6, 2026 · Nov 6, 2026
diff --git a/.env.example b/.env.example
@@ -0,0 +1,16 @@
+# POSTGRES
+POSTGRES_PASSWORD=admin
+POSTGRES_USER=admin
+POSTGRES_DB=administration
+
+# NOCODB
+NC_AUTH_JWT_SECRET=secret
+NC_DB=pg://db:5432?u=admin&p=admin&d=administration
+NC_ATTACHMENT_FIELD_SIZE=20971520  # default = 20 MB
+NC_SECURE_ATTACHMENTS=false
+NC_ALLOW_LOCAL_HOOKS=true
+
+# YOYO-MIGRATION
+YOYO_DB=postgresql+psycopg://localhost:5432?user=admin&password=admin&database=adapt_explore
+YOYO_SRC=migrations
+YOYO_VERBOSITY=2
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1 @@
+.env
diff --git a/README.md b/README.md
@@ -1,34 +1,61 @@
-# Template DataForGood
+# Adpat Explore
 
-This file will become your README and also the index of your
-documentation.
+![schema d'architecture de l'application](https://github.com/dataforgoodfr/adapt-explore/blob/main/docs/project_schema.png?raw=true)
 
-# Contributing
+## ETL
 
-## Installation
+Dans le dossier `./backend`, un projet en python
 
-- [Installation de Python](#installation-de-python)
+## Application
 
-Ce projet utilise [uv](https://docs.astral.sh/uv/) pour la gestion des dépendances Python. Il est préréquis pour l'installation de ce projet.
+Dans le dossier `./frontend`, un projet en NextJS
 
-Une fois installé, il suffit de lancer la commande suivante pour installer la version de Python adéquate, créer un environnement virtuel et installer les dépendances du projet.
+## Application administration
 
-```bash
-uv sync
+Nous utilisont [NocoDB](https://docs.nocodb.com/) comme application d'administration. NocoDB est démarré via `compose.yml`
+
+Une fois démarrée l'application est disponible sur `http://localhost:3333`.
+
+Aucun paramétrages n'aient fait au démarrage de l'application donc à son premier lancement il vous faudra :
+
+- Créer un utilisateur super admin
+- Créer une intégration de la base de données `adpat_explore`
+- Ajouter cette intégration comme source de donnée
+
+## Variables d'environnement
+
+Copier le fichier `.env.example` et créer un fichier `.env`
+
+```
+cp .env.example .env
 ```
 
-A l'usage, si vous utilisez VSCode, l'environnement virtuel sera automatiquement activé lorsque vous ouvrirez le projet. Sinon, il suffit de l'activer manuellement avec la commande suivante :
+## Démarrer l'infrascruture
 
-```bash
-source .venv/bin/activate
 ```
+podman compose up -d
+# OU
+docker compose up -d
+```
+
+## Migration de schema
 
-Ou alors, utilisez la commande `uv run ...` (au lieu de `python ...`) pour lancer un script Python. Par exemple:
+Les migrations de schema sont gérer par [yoyo-migrations](https://ollycope.com/software/yoyo/latest/#).
 
-```bash
-uv run pipelines/run.py run build_database
+Dans le dossier `./database`, si c'est le premier lancement installez les dépendances
+
+```
+uv sync
 ```
 
-## Utiliser Tox pour tester votre code
+Vérifier que la base de données est démarrée (cf. Démarrer l'infrascruture) et jouer les migrations
 
-    tox -vv
+```
+uv run --env-file ../.env yoyo apply
+```
+
+Pour ajouter un nouveau fichier de migration
+
+```
+uv run --env-file ../.env yoyo new --sql -m "..."
+```
diff --git a/backend/.python-version b/backend/.python-version
@@ -0,0 +1 @@
+3.14
diff --git a/compose.yml b/compose.yml
@@ -0,0 +1,23 @@
+services:
+  db:
+    image: postgres:18-alpine
+    env_file: .env
+    ports:
+      - 5432:5432
+    volumes:
+      - ./database/postgres-init:/docker-entrypoint-initdb.d:Z
+    healthcheck:
+      interval: 10s
+      retries: 10
+      test: 'pg_isready -U "$$POSTGRES_USER" -d "$$POSTGRES_DB"'
+      timeout: 2s
+  admin:
+    image: nocodb/nocodb:2026.10.1
+    env_file: .env
+    environment:
+      NODE_ENV: production # required even in dev mode, "development" value throw an error
+    ports:
+      - 3333:3333
+    depends_on:
+      db:
+        condition: service_healthy
diff --git a/database/.gitignore b/database/.gitignore
@@ -0,0 +1 @@
+.venv
diff --git a/database/.python-version b/database/.python-version
@@ -0,0 +1 @@
+3.14
diff --git a/database/postgres-init/create-databases.sql b/database/postgres-init/create-databases.sql
@@ -0,0 +1 @@
+CREATE DATABASE adapt_explore;
diff --git a/database/pyproject.toml b/database/pyproject.toml
@@ -0,0 +1,10 @@
+[project]
+name = "database"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.14"
+dependencies = [
+    "psycopg[binary,pool]>=3.3.8",
+    "yoyo-migrations>=9.0.0",
+]
diff --git a/database/uv.lock b/database/uv.lock
diff --git a/database/yoyo.ini b/database/yoyo.ini
@@ -0,0 +1,5 @@
+[DEFAULT]
+sources = %(YOYO_SRC)s
+database = %(YOYO_DB)s
+batch_mode = off
+verbosity = %(YOYO_VERBOSITY)s
diff --git a/docs/ELT_schema.png.png b/docs/ELT_schema.png.png
diff --git a/docs/frontend_schema.png.png b/docs/frontend_schema.png.png
diff --git a/docs/nocodb_schema.png.png b/docs/nocodb_schema.png.png
diff --git a/docs/project_schame.png b/docs/project_schame.png