diff --git a/API_ENDPOINTS_FR.md b/API_ENDPOINTS_FR.md
new file mode 100644
index 0000000000..95f5c000d5
--- /dev/null
+++ b/API_ENDPOINTS_FR.md
@@ -0,0 +1,1486 @@
+# Documentation API Teable - Endpoints et Exemples
+
+**Version**: 1.0
+**Date**: Février 2025
+**Base URL**: `http://localhost:3000/api/v1`
+
+---
+
+## 📋 Table des matières
+
+1. [Authentification](#1-authentification)
+2. [Espaces (Spaces)](#2-espaces-spaces)
+3. [Bases (Bases)](#3-bases-bases)
+4. [Tables](#4-tables)
+5. [Champs (Fields)](#5-champs-fields)
+6. [Vues (Views)](#6-vues-views)
+7. [Enregistrements (Records)](#7-enregistrements-records)
+8. [Commentaires](#8-commentaires)
+9. [Partages](#9-partages)
+10. [Pièces jointes](#10-pièces-jointes)
+11. [Recherche et Filtrage](#11-recherche-et-filtrage)
+12. [Codes d'erreur](#12-codes-derreur)
+
+---
+
+## 1. Authentification
+
+### 1.1 Login avec email/password
+
+**Endpoint**: `POST /auth/login`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{
+    "email": "user@example.com",
+    "password": "password123"
+  }'
+```
+
+**Response** (200 OK):
+```json
+{
+  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+  "refreshToken": "refresh_token_here",
+  "user": {
+    "id": "user-123",
+    "email": "user@example.com",
+    "name": "John Doe",
+    "avatar": "https://..."
+  }
+}
+```
+
+### 1.2 Register
+
+**Endpoint**: `POST /auth/register`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/auth/register \
+  -H "Content-Type: application/json" \
+  -d '{
+    "email": "newuser@example.com",
+    "password": "password123",
+    "name": "New User"
+  }'
+```
+
+**Response** (201 Created):
+```json
+{
+  "id": "user-456",
+  "email": "newuser@example.com",
+  "name": "New User",
+  "createdAt": "2025-02-05T10:00:00Z"
+}
+```
+
+### 1.3 Refresh Token
+
+**Endpoint**: `POST /auth/refresh`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/auth/refresh \
+  -H "Content-Type: application/json" \
+  -d '{
+    "refreshToken": "refresh_token_here"
+  }'
+```
+
+**Response** (200 OK):
+```json
+{
+  "accessToken": "new_access_token...",
+  "refreshToken": "new_refresh_token..."
+}
+```
+
+### 1.4 Logout
+
+**Endpoint**: `POST /auth/logout`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/auth/logout \
+  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
+```
+
+**Response** (200 OK):
+```json
+{
+  "message": "Logged out successfully"
+}
+```
+
+### 1.5 OAuth Login (GitHub)
+
+**Endpoint**: `GET /auth/github`
+
+**Redirection Flow**:
+```
+1. Client → GET /auth/github
+2. Backend → Redirect to GitHub login page
+3. GitHub → User authorizes app
+4. GitHub → Redirect to /auth/github/callback
+5. Backend → Create/update user, issue tokens
+6. Backend → Redirect to frontend with tokens in URL
+```
+
+---
+
+## 2. Espaces (Spaces)
+
+### 2.1 Créer un espace
+
+**Endpoint**: `POST /spaces`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/spaces \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "My Workspace",
+    "description": "A collaborative workspace"
+  }'
+```
+
+**Response** (201 Created):
+```json
+{
+  "id": "space-123",
+  "name": "My Workspace",
+  "description": "A collaborative workspace",
+  "ownerId": "user-123",
+  "createdTime": "2025-02-05T10:00:00Z",
+  "updatedTime": "2025-02-05T10:00:00Z"
+}
+```
+
+### 2.2 Lister les espaces
+
+**Endpoint**: `GET /spaces`
+
+**Request**:
+```bash
+curl http://localhost:3000/api/v1/spaces \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Query Parameters**:
+```
+?skip=0&limit=20&search=workspace
+```
+
+**Response** (200 OK):
+```json
+{
+  "data": [
+    {
+      "id": "space-123",
+      "name": "My Workspace",
+      "description": "...",
+      "ownerId": "user-123",
+      "baseCount": 5,
+      "collaborators": 3
+    }
+  ],
+  "pagination": {
+    "total": 10,
+    "skip": 0,
+    "limit": 20
+  }
+}
+```
+
+### 2.3 Récupérer un espace
+
+**Endpoint**: `GET /spaces/:spaceId`
+
+**Request**:
+```bash
+curl http://localhost:3000/api/v1/spaces/space-123 \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (200 OK):
+```json
+{
+  "id": "space-123",
+  "name": "My Workspace",
+  "description": "...",
+  "owner": { "id": "user-123", "name": "John" },
+  "bases": [
+    { "id": "base-1", "name": "CRM" },
+    { "id": "base-2", "name": "Inventory" }
+  ],
+  "collaborators": [
+    { "id": "user-456", "name": "Jane", "role": "editor" }
+  ]
+}
+```
+
+### 2.4 Mettre à jour un espace
+
+**Endpoint**: `PATCH /spaces/:spaceId`
+
+**Request**:
+```bash
+curl -X PATCH http://localhost:3000/api/v1/spaces/space-123 \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "Updated Workspace",
+    "description": "New description"
+  }'
+```
+
+**Response** (200 OK):
+```json
+{
+  "id": "space-123",
+  "name": "Updated Workspace",
+  "description": "New description",
+  "updatedTime": "2025-02-05T11:00:00Z"
+}
+```
+
+### 2.5 Supprimer un espace
+
+**Endpoint**: `DELETE /spaces/:spaceId`
+
+**Request**:
+```bash
+curl -X DELETE http://localhost:3000/api/v1/spaces/space-123 \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (204 No Content):
+```
+(empty body)
+```
+
+### 2.6 Inviter un collaborateur
+
+**Endpoint**: `POST /spaces/:spaceId/invite`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/spaces/space-123/invite \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "email": "newuser@example.com",
+    "role": "editor"
+  }'
+```
+
+**Response** (200 OK):
+```json
+{
+  "invitationId": "inv-123",
+  "email": "newuser@example.com",
+  "role": "editor",
+  "expiresAt": "2025-02-12T10:00:00Z"
+}
+```
+
+---
+
+## 3. Bases (Bases)
+
+### 3.1 Créer une base
+
+**Endpoint**: `POST /spaces/:spaceId/bases`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/spaces/space-123/bases \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "Customer CRM",
+    "description": "Customer relationship management"
+  }'
+```
+
+**Response** (201 Created):
+```json
+{
+  "id": "base-456",
+  "spaceId": "space-123",
+  "name": "Customer CRM",
+  "description": "Customer relationship management",
+  "createdTime": "2025-02-05T10:00:00Z"
+}
+```
+
+### 3.2 Lister les bases d'un espace
+
+**Endpoint**: `GET /spaces/:spaceId/bases`
+
+**Request**:
+```bash
+curl http://localhost:3000/api/v1/spaces/space-123/bases \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (200 OK):
+```json
+{
+  "data": [
+    {
+      "id": "base-1",
+      "name": "CRM",
+      "tableCount": 3,
+      "updatedTime": "2025-02-05T10:00:00Z"
+    }
+  ]
+}
+```
+
+### 3.3 Récupérer une base
+
+**Endpoint**: `GET /bases/:baseId`
+
+**Request**:
+```bash
+curl http://localhost:3000/api/v1/bases/base-456 \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (200 OK):
+```json
+{
+  "id": "base-456",
+  "name": "Customer CRM",
+  "tables": [
+    { "id": "tbl-1", "name": "Customers" },
+    { "id": "tbl-2", "name": "Orders" }
+  ],
+  "owner": { "id": "user-123" },
+  "collaborators": []
+}
+```
+
+### 3.4 Mettre à jour une base
+
+**Endpoint**: `PATCH /bases/:baseId`
+
+**Request**:
+```bash
+curl -X PATCH http://localhost:3000/api/v1/bases/base-456 \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "Updated CRM",
+    "description": "Updated description"
+  }'
+```
+
+**Response** (200 OK):
+```json
+{
+  "id": "base-456",
+  "name": "Updated CRM",
+  "description": "Updated description"
+}
+```
+
+### 3.5 Supprimer une base
+
+**Endpoint**: `DELETE /bases/:baseId`
+
+**Request**:
+```bash
+curl -X DELETE http://localhost:3000/api/v1/bases/base-456 \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (204 No Content):
+```
+(empty body)
+```
+
+---
+
+## 4. Tables
+
+### 4.1 Créer une table
+
+**Endpoint**: `POST /bases/:baseId/tables`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/bases/base-456/tables \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "Customers",
+    "description": "Customer records"
+  }'
+```
+
+**Response** (201 Created):
+```json
+{
+  "id": "tbl-123",
+  "baseId": "base-456",
+  "name": "Customers",
+  "description": "Customer records",
+  "fields": [],
+  "views": [],
+  "createdTime": "2025-02-05T10:00:00Z"
+}
+```
+
+### 4.2 Lister les tables
+
+**Endpoint**: `GET /bases/:baseId/tables`
+
+**Request**:
+```bash
+curl http://localhost:3000/api/v1/bases/base-456/tables \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (200 OK):
+```json
+{
+  "data": [
+    {
+      "id": "tbl-1",
+      "name": "Customers",
+      "fieldCount": 5,
+      "recordCount": 150
+    }
+  ]
+}
+```
+
+### 4.3 Récupérer une table
+
+**Endpoint**: `GET /bases/:baseId/tables/:tableId`
+
+**Request**:
+```bash
+curl http://localhost:3000/api/v1/bases/base-456/tables/tbl-123 \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (200 OK):
+```json
+{
+  "id": "tbl-123",
+  "name": "Customers",
+  "fields": [
+    {
+      "id": "fld-1",
+      "name": "Email",
+      "type": "email",
+      "required": true
+    }
+  ],
+  "views": [
+    { "id": "view-1", "name": "All Customers", "type": "grid" }
+  ],
+  "recordCount": 150
+}
+```
+
+### 4.4 Supprimer une table
+
+**Endpoint**: `DELETE /bases/:baseId/tables/:tableId`
+
+**Request**:
+```bash
+curl -X DELETE http://localhost:3000/api/v1/bases/base-456/tables/tbl-123 \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (204 No Content):
+```
+(empty body)
+```
+
+---
+
+## 5. Champs (Fields)
+
+### 5.1 Créer un champ
+
+**Endpoint**: `POST /bases/:baseId/tables/:tableId/fields`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/fields \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "Email",
+    "type": "email",
+    "description": "Customer email",
+    "required": true,
+    "defaultValue": null
+  }'
+```
+
+**Response** (201 Created):
+```json
+{
+  "id": "fld-123",
+  "tableId": "tbl-123",
+  "name": "Email",
+  "type": "email",
+  "required": true,
+  "createdTime": "2025-02-05T10:00:00Z"
+}
+```
+
+### 5.2 Types de champs supportés
+
+| Type | Description | Options |
+|------|-------------|---------|
+| `text` | Texte simple | maxLength, defaultValue |
+| `email` | Adresse email | defaultValue |
+| `number` | Nombre entier ou décimal | precision, scale, defaultValue |
+| `date` | Date | format (YYYY-MM-DD) |
+| `datetime` | Date et heure | format (YYYY-MM-DD HH:mm:ss) |
+| `checkbox` | Booléen | defaultValue |
+| `select` | Sélection simple | options: [{label, value, color}] |
+| `multiSelect` | Sélection multiple | options: [{label, value, color}] |
+| `attachment` | Fichiers | maxCount |
+| `lookup` | Référence | linkedTableId, linkedFieldId |
+| `formula` | Champ calculé | expression, resultType |
+| `link` | Lien hypertexte | defaultValue |
+| `phone` | Numéro de téléphone | defaultValue |
+| `url` | URL | defaultValue |
+| `richText` | Texte formaté | defaultValue |
+| `rating` | Notation | max (1-5) |
+
+### 5.3 Lister les champs
+
+**Endpoint**: `GET /bases/:baseId/tables/:tableId/fields`
+
+**Request**:
+```bash
+curl http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/fields \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (200 OK):
+```json
+{
+  "data": [
+    {
+      "id": "fld-1",
+      "name": "Email",
+      "type": "email",
+      "required": true
+    },
+    {
+      "id": "fld-2",
+      "name": "Name",
+      "type": "text",
+      "required": true
+    }
+  ]
+}
+```
+
+### 5.4 Mettre à jour un champ
+
+**Endpoint**: `PATCH /bases/:baseId/tables/:tableId/fields/:fieldId`
+
+**Request**:
+```bash
+curl -X PATCH http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/fields/fld-123 \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "Primary Email",
+    "required": false
+  }'
+```
+
+**Response** (200 OK):
+```json
+{
+  "id": "fld-123",
+  "name": "Primary Email",
+  "type": "email",
+  "required": false
+}
+```
+
+### 5.5 Supprimer un champ
+
+**Endpoint**: `DELETE /bases/:baseId/tables/:tableId/fields/:fieldId`
+
+**Request**:
+```bash
+curl -X DELETE http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/fields/fld-123 \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (204 No Content):
+```
+(empty body)
+```
+
+---
+
+## 6. Vues (Views)
+
+### 6.1 Créer une vue
+
+**Endpoint**: `POST /bases/:baseId/tables/:tableId/views`
+
+**Request - Grid View**:
+```bash
+curl -X POST http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/views \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "All Customers",
+    "type": "grid",
+    "options": {
+      "freezeColumns": 1,
+      "rowHeight": "auto"
+    }
+  }'
+```
+
+**Request - Form View**:
+```bash
+curl -X POST http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/views \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "Add Customer",
+    "type": "form",
+    "options": {
+      "layout": "single-column",
+      "submitText": "Save Customer"
+    }
+  }'
+```
+
+**Request - Kanban View**:
+```bash
+curl -X POST http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/views \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "Pipeline",
+    "type": "kanban",
+    "options": {
+      "groupByField": "status",
+      "cardFieldIds": ["fld-1", "fld-2"]
+    }
+  }'
+```
+
+**Request - Calendar View**:
+```bash
+curl -X POST http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/views \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "Events",
+    "type": "calendar",
+    "options": {
+      "dateFieldId": "fld-date",
+      "colorFieldId": "fld-category"
+    }
+  }'
+```
+
+**Response** (201 Created):
+```json
+{
+  "id": "view-123",
+  "tableId": "tbl-123",
+  "name": "All Customers",
+  "type": "grid",
+  "createdTime": "2025-02-05T10:00:00Z"
+}
+```
+
+### 6.2 Lister les vues
+
+**Endpoint**: `GET /bases/:baseId/tables/:tableId/views`
+
+**Request**:
+```bash
+curl http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/views \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (200 OK):
+```json
+{
+  "data": [
+    {
+      "id": "view-1",
+      "name": "All Customers",
+      "type": "grid"
+    },
+    {
+      "id": "view-2",
+      "name": "Pipeline",
+      "type": "kanban"
+    }
+  ]
+}
+```
+
+### 6.3 Mettre à jour une vue
+
+**Endpoint**: `PATCH /bases/:baseId/tables/:tableId/views/:viewId`
+
+**Request**:
+```bash
+curl -X PATCH http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/views/view-123 \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "Updated View Name",
+    "options": {
+      "rowHeight": "tall"
+    }
+  }'
+```
+
+**Response** (200 OK):
+```json
+{
+  "id": "view-123",
+  "name": "Updated View Name",
+  "type": "grid"
+}
+```
+
+### 6.4 Appliquer un filtre à une vue
+
+**Endpoint**: `POST /bases/:baseId/tables/:tableId/views/:viewId/filters`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/views/view-123/filters \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "fieldId": "fld-email",
+    "operator": "contains",
+    "value": "example.com"
+  }'
+```
+
+**Opérateurs de filtre supportés**:
+- `equals` - Égal à
+- `notEquals` - Pas égal à
+- `contains` - Contient
+- `notContains` - Ne contient pas
+- `startsWith` - Commence par
+- `endsWith` - Se termine par
+- `gt` - Plus grand que
+- `gte` - Plus grand ou égal à
+- `lt` - Moins que
+- `lte` - Moins ou égal à
+- `isEmpty` - Vide
+- `isNotEmpty` - Pas vide
+
+**Response** (201 Created):
+```json
+{
+  "id": "filter-123",
+  "viewId": "view-123",
+  "fieldId": "fld-email",
+  "operator": "contains",
+  "value": "example.com"
+}
+```
+
+### 6.5 Appliquer un tri à une vue
+
+**Endpoint**: `POST /bases/:baseId/tables/:tableId/views/:viewId/sorts`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/views/view-123/sorts \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "fieldId": "fld-name",
+    "direction": "ascending",
+    "priority": 1
+  }'
+```
+
+**Response** (201 Created):
+```json
+{
+  "id": "sort-123",
+  "viewId": "view-123",
+  "fieldId": "fld-name",
+  "direction": "ascending",
+  "priority": 1
+}
+```
+
+---
+
+## 7. Enregistrements (Records)
+
+### 7.1 Créer un enregistrement
+
+**Endpoint**: `POST /bases/:baseId/tables/:tableId/records`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/records \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "fields": {
+      "fld-name": "John Doe",
+      "fld-email": "john@example.com",
+      "fld-phone": "+33123456789",
+      "fld-country": "France"
+    }
+  }'
+```
+
+**Response** (201 Created):
+```json
+{
+  "id": "rec-123",
+  "tableId": "tbl-123",
+  "fields": {
+    "fld-name": "John Doe",
+    "fld-email": "john@example.com",
+    "fld-phone": "+33123456789",
+    "fld-country": "France"
+  },
+  "createdBy": "user-123",
+  "createdTime": "2025-02-05T10:00:00Z"
+}
+```
+
+### 7.2 Récupérer les enregistrements
+
+**Endpoint**: `GET /bases/:baseId/tables/:tableId/records`
+
+**Request**:
+```bash
+curl "http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/records?skip=0&limit=50" \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Query Parameters**:
+```
+?skip=0&limit=50&search=john&fieldIds=fld-1,fld-2
+```
+
+**Response** (200 OK):
+```json
+{
+  "data": [
+    {
+      "id": "rec-1",
+      "fields": {
+        "fld-name": "John Doe",
+        "fld-email": "john@example.com"
+      },
+      "createdTime": "2025-02-05T10:00:00Z"
+    }
+  ],
+  "pagination": {
+    "total": 150,
+    "skip": 0,
+    "limit": 50
+  }
+}
+```
+
+### 7.3 Récupérer un enregistrement
+
+**Endpoint**: `GET /bases/:baseId/tables/:tableId/records/:recordId`
+
+**Request**:
+```bash
+curl http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/records/rec-123 \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (200 OK):
+```json
+{
+  "id": "rec-123",
+  "tableId": "tbl-123",
+  "fields": {
+    "fld-name": "John Doe",
+    "fld-email": "john@example.com",
+    "fld-phone": "+33123456789"
+  },
+  "createdBy": "user-123",
+  "updatedBy": "user-123",
+  "createdTime": "2025-02-05T10:00:00Z",
+  "updatedTime": "2025-02-05T11:00:00Z"
+}
+```
+
+### 7.4 Mettre à jour un enregistrement
+
+**Endpoint**: `PATCH /bases/:baseId/tables/:tableId/records/:recordId`
+
+**Request**:
+```bash
+curl -X PATCH http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/records/rec-123 \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "fields": {
+      "fld-email": "newemail@example.com",
+      "fld-phone": "+33987654321"
+    }
+  }'
+```
+
+**Response** (200 OK):
+```json
+{
+  "id": "rec-123",
+  "fields": {
+    "fld-name": "John Doe",
+    "fld-email": "newemail@example.com",
+    "fld-phone": "+33987654321"
+  },
+  "updatedTime": "2025-02-05T11:30:00Z"
+}
+```
+
+### 7.5 Supprimer un enregistrement
+
+**Endpoint**: `DELETE /bases/:baseId/tables/:tableId/records/:recordId`
+
+**Request**:
+```bash
+curl -X DELETE http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/records/rec-123 \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (204 No Content):
+```
+(empty body)
+```
+
+### 7.6 Opérations en batch
+
+**Endpoint**: `POST /bases/:baseId/tables/:tableId/records/batch`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/records/batch \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "operations": [
+      {
+        "type": "create",
+        "fields": { "fld-name": "Jane Doe" }
+      },
+      {
+        "type": "update",
+        "recordId": "rec-456",
+        "fields": { "fld-status": "active" }
+      },
+      {
+        "type": "delete",
+        "recordId": "rec-789"
+      }
+    ]
+  }'
+```
+
+**Response** (200 OK):
+```json
+{
+  "results": [
+    { "type": "create", "recordId": "rec-999" },
+    { "type": "update", "recordId": "rec-456" },
+    { "type": "delete", "recordId": "rec-789" }
+  ]
+}
+```
+
+---
+
+## 8. Commentaires
+
+### 8.1 Créer un commentaire
+
+**Endpoint**: `POST /bases/:baseId/tables/:tableId/records/:recordId/comments`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/records/rec-123/comments \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "text": "This customer needs follow-up",
+    "mentions": ["user-456"]
+  }'
+```
+
+**Response** (201 Created):
+```json
+{
+  "id": "comment-123",
+  "recordId": "rec-123",
+  "text": "This customer needs follow-up",
+  "author": {
+    "id": "user-123",
+    "name": "John",
+    "avatar": "https://..."
+  },
+  "createdTime": "2025-02-05T10:00:00Z"
+}
+```
+
+### 8.2 Lister les commentaires
+
+**Endpoint**: `GET /bases/:baseId/tables/:tableId/records/:recordId/comments`
+
+**Request**:
+```bash
+curl http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/records/rec-123/comments \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (200 OK):
+```json
+{
+  "data": [
+    {
+      "id": "comment-1",
+      "text": "Follow up needed",
+      "author": { "id": "user-123", "name": "John" },
+      "createdTime": "2025-02-05T10:00:00Z"
+    }
+  ]
+}
+```
+
+### 8.3 Mettre à jour un commentaire
+
+**Endpoint**: `PATCH /bases/:baseId/tables/:tableId/records/:recordId/comments/:commentId`
+
+**Request**:
+```bash
+curl -X PATCH http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/records/rec-123/comments/comment-123 \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "text": "Updated comment text"
+  }'
+```
+
+**Response** (200 OK):
+```json
+{
+  "id": "comment-123",
+  "text": "Updated comment text",
+  "updatedTime": "2025-02-05T11:00:00Z"
+}
+```
+
+### 8.4 Supprimer un commentaire
+
+**Endpoint**: `DELETE /bases/:baseId/tables/:tableId/records/:recordId/comments/:commentId`
+
+**Request**:
+```bash
+curl -X DELETE http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/records/rec-123/comments/comment-123 \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (204 No Content):
+```
+(empty body)
+```
+
+---
+
+## 9. Partages
+
+### 9.1 Créer un partage public
+
+**Endpoint**: `POST /bases/:baseId/shares`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/bases/base-456/shares \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "type": "view",
+    "viewId": "view-123",
+    "permissions": {
+      "canRead": true,
+      "canCreate": false,
+      "canUpdate": false,
+      "canDelete": false
+    },
+    "password": "optional-password"
+  }'
+```
+
+**Response** (201 Created):
+```json
+{
+  "id": "share-123",
+  "baseId": "base-456",
+  "token": "shareable-token-here",
+  "url": "https://teable.io/share/shareable-token-here",
+  "createdTime": "2025-02-05T10:00:00Z"
+}
+```
+
+### 9.2 Lister les partages
+
+**Endpoint**: `GET /bases/:baseId/shares`
+
+**Request**:
+```bash
+curl http://localhost:3000/api/v1/bases/base-456/shares \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (200 OK):
+```json
+{
+  "data": [
+    {
+      "id": "share-1",
+      "token": "token-123",
+      "type": "view",
+      "permissions": { "canRead": true },
+      "createdTime": "2025-02-05T10:00:00Z"
+    }
+  ]
+}
+```
+
+### 9.3 Révoquer un partage
+
+**Endpoint**: `DELETE /bases/:baseId/shares/:shareId`
+
+**Request**:
+```bash
+curl -X DELETE http://localhost:3000/api/v1/bases/base-456/shares/share-123 \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (204 No Content):
+```
+(empty body)
+```
+
+---
+
+## 10. Pièces jointes
+
+### 10.1 Upload de fichier
+
+**Endpoint**: `POST /bases/:baseId/tables/:tableId/records/:recordId/attachments`
+
+**Request**:
+```bash
+curl -X POST http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/records/rec-123/attachments \
+  -H "Authorization: Bearer TOKEN" \
+  -F "file=@/path/to/file.pdf"
+```
+
+**Response** (201 Created):
+```json
+{
+  "id": "att-123",
+  "recordId": "rec-123",
+  "filename": "document.pdf",
+  "url": "https://storage.example.com/files/document.pdf",
+  "size": 2048576,
+  "mimeType": "application/pdf",
+  "uploadedAt": "2025-02-05T10:00:00Z"
+}
+```
+
+### 10.2 Lister les pièces jointes
+
+**Endpoint**: `GET /bases/:baseId/tables/:tableId/records/:recordId/attachments`
+
+**Request**:
+```bash
+curl http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/records/rec-123/attachments \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (200 OK):
+```json
+{
+  "data": [
+    {
+      "id": "att-1",
+      "filename": "invoice.pdf",
+      "url": "https://storage.example.com/files/invoice.pdf",
+      "size": 1024000
+    }
+  ]
+}
+```
+
+### 10.3 Supprimer une pièce jointe
+
+**Endpoint**: `DELETE /bases/:baseId/tables/:tableId/records/:recordId/attachments/:attachmentId`
+
+**Request**:
+```bash
+curl -X DELETE http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/records/rec-123/attachments/att-123 \
+  -H "Authorization: Bearer TOKEN"
+```
+
+**Response** (204 No Content):
+```
+(empty body)
+```
+
+---
+
+## 11. Recherche et Filtrage
+
+### 11.1 Recherche textuelle
+
+**Endpoint**: `GET /bases/:baseId/tables/:tableId/records?search=john`
+
+**Request**:
+```bash
+curl "http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/records?search=john" \
+  -H "Authorization: Bearer TOKEN"
+```
+
+### 11.2 Filtrage avancé
+
+**Endpoint**: `GET /bases/:baseId/tables/:tableId/records`
+
+**Query Parameters**:
+```
+?filters=[
+  {
+    "fieldId": "fld-email",
+    "operator": "contains",
+    "value": "example.com"
+  },
+  {
+    "fieldId": "fld-status",
+    "operator": "equals",
+    "value": "active"
+  }
+]&filterLogic=AND
+```
+
+### 11.3 Agrégations
+
+**Endpoint**: `GET /bases/:baseId/tables/:tableId/records/aggregate`
+
+**Request**:
+```bash
+curl -X GET "http://localhost:3000/api/v1/bases/base-456/tables/tbl-123/records/aggregate" \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "aggregations": [
+      {
+        "fieldId": "fld-price",
+        "operation": "SUM"
+      },
+      {
+        "fieldId": "fld-category",
+        "operation": "COUNT"
+      }
+    ],
+    "groupBy": ["fld-category"]
+  }'
+```
+
+**Opérations d'agrégation supportées**:
+- `COUNT` - Nombre d'enregistrements
+- `SUM` - Somme des valeurs
+- `AVG` - Moyenne
+- `MIN` - Valeur minimale
+- `MAX` - Valeur maximale
+- `DISTINCT_COUNT` - Nombre distinct
+
+**Response** (200 OK):
+```json
+{
+  "data": [
+    {
+      "group": { "fld-category": "Electronics" },
+      "aggregations": {
+        "price_sum": 50000,
+        "count": 25
+      }
+    }
+  ]
+}
+```
+
+---
+
+## 12. Codes d'erreur
+
+### 12.1 Erreurs HTTP courantes
+
+| Code | Message | Signification |
+|------|---------|---------------|
+| 200 | OK | Requête réussie |
+| 201 | Created | Ressource créée |
+| 204 | No Content | Suppression réussie |
+| 400 | Bad Request | Requête invalide |
+| 401 | Unauthorized | Authentification requise |
+| 403 | Forbidden | Accès refusé |
+| 404 | Not Found | Ressource non trouvée |
+| 409 | Conflict | Conflit de version |
+| 422 | Unprocessable Entity | Validation échouée |
+| 429 | Too Many Requests | Rate limited |
+| 500 | Internal Server Error | Erreur serveur |
+
+### 12.2 Format d'erreur
+
+```json
+{
+  "statusCode": 400,
+  "message": "Validation failed",
+  "error": "Bad Request",
+  "details": [
+    {
+      "field": "email",
+      "message": "email must be a valid email address"
+    }
+  ]
+}
+```
+
+### 12.3 Exemples d'erreurs
+
+**Authentification manquante**:
+```json
+{
+  "statusCode": 401,
+  "message": "Unauthorized - No token provided",
+  "error": "Unauthorized"
+}
+```
+
+**Permission insuffisante**:
+```json
+{
+  "statusCode": 403,
+  "message": "You don't have permission to access this resource",
+  "error": "Forbidden"
+}
+```
+
+**Validation échouée**:
+```json
+{
+  "statusCode": 422,
+  "message": "Validation failed",
+  "error": "Unprocessable Entity",
+  "details": [
+    {
+      "field": "email",
+      "message": "email must be a valid email"
+    },
+    {
+      "field": "password",
+      "message": "password must be at least 8 characters"
+    }
+  ]
+}
+```
+
+---
+
+## Exemples complets
+
+### Exemple 1: Créer une base complète avec tables et données
+
+```bash
+#!/bin/bash
+
+TOKEN="your_access_token"
+SPACE_ID="space-123"
+
+# 1. Créer une base
+BASE_RESPONSE=$(curl -s -X POST "http://localhost:3000/api/v1/spaces/$SPACE_ID/bases" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "Task Manager", "description": "Manage team tasks"}')
+
+BASE_ID=$(echo $BASE_RESPONSE | jq -r '.id')
+echo "Created base: $BASE_ID"
+
+# 2. Créer une table
+TABLE_RESPONSE=$(curl -s -X POST "http://localhost:3000/api/v1/bases/$BASE_ID/tables" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "Tasks", "description": "Task list"}')
+
+TABLE_ID=$(echo $TABLE_RESPONSE | jq -r '.id')
+echo "Created table: $TABLE_ID"
+
+# 3. Ajouter des champs
+curl -s -X POST "http://localhost:3000/api/v1/bases/$BASE_ID/tables/$TABLE_ID/fields" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "Title", "type": "text", "required": true}' > /dev/null
+
+curl -s -X POST "http://localhost:3000/api/v1/bases/$BASE_ID/tables/$TABLE_ID/fields" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "Status", "type": "select", "options": [{"label": "Todo"}, {"label": "In Progress"}, {"label": "Done"}]}' > /dev/null
+
+# 4. Créer une vue
+VIEW_RESPONSE=$(curl -s -X POST "http://localhost:3000/api/v1/bases/$BASE_ID/tables/$TABLE_ID/views" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "All Tasks", "type": "grid"}')
+
+VIEW_ID=$(echo $VIEW_RESPONSE | jq -r '.id')
+echo "Created view: $VIEW_ID"
+
+# 5. Ajouter des enregistrements
+curl -s -X POST "http://localhost:3000/api/v1/bases/$BASE_ID/tables/$TABLE_ID/records" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"fields": {"Title": "Design API", "Status": "In Progress"}}' > /dev/null
+
+curl -s -X POST "http://localhost:3000/api/v1/bases/$BASE_ID/tables/$TABLE_ID/records" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"fields": {"Title": "Implement endpoints", "Status": "Todo"}}' > /dev/null
+
+echo "Setup complete!"
+```
+
+---
+
+**Documentation API - Version 1.0**
+**Date**: Février 2025
+**Base URL**: http://localhost:3000/api/v1
diff --git a/ARCHITECTURE_DETAILS_FR.md b/ARCHITECTURE_DETAILS_FR.md
new file mode 100644
index 0000000000..e8f32c8f3a
--- /dev/null
+++ b/ARCHITECTURE_DETAILS_FR.md
@@ -0,0 +1,959 @@
+# Architecture Détaillée du Projet Teable
+
+**Document de référence technique**
+**Version**: 1.0
+**Date**: Février 2025
+
+---
+
+## 📚 Table des matières
+
+1. [Diagrammes d'architecture](#1-diagrammes-darchitecture)
+2. [Communication entre services](#2-communication-entre-services)
+3. [Flux de données](#3-flux-de-données)
+4. [Patterns et bonnes pratiques](#4-patterns-et-bonnes-pratiques)
+5. [Dépendances critiques](#5-dépendances-critiques)
+6. [Points d'intégration](#6-points-dintégration)
+7. [Analyse des modules](#7-analyse-des-modules)
+
+---
+
+## 1. Diagrammes d'architecture
+
+### 1.1 Architecture globale en couches
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                       COUCHE PRÉSENTATION                        │
+│  ┌──────────────┬──────────────┬──────────────┬──────────────┐   │
+│  │  Grid View   │  Form View   │  Kanban View │ Calendar View│   │
+│  └──────────────┴──────────────┴──────────────┴──────────────┘   │
+│  ┌──────────────┬──────────────┬──────────────────────────────┐   │
+│  │   Comment    │    Share     │      Collaboration          │   │
+│  │   Thread     │    Modal     │      Features              │   │
+│  └──────────────┴──────────────┴──────────────────────────────┘   │
+│                    React Components (Next.js)                      │
+└──────────────────────────────┬──────────────────────────────────┘
+                               │ HTTP/WebSocket
+                               ↓
+┌──────────────────────────────────────────────────────────────────┐
+│                    COUCHE MÉTIER (BUSINESS)                       │
+│  ┌─────────────────────────────────────────────────────────────┐ │
+│  │                    NestJS Backend                           │ │
+│  │  ┌──────────────┬──────────────┬──────────────────────────┐ │ │
+│  │  │   Auth       │   Access     │    Validation & Schema  │ │ │
+│  │  │   Module     │   Control    │    Management           │ │ │
+│  │  └──────────────┴──────────────┴──────────────────────────┘ │ │
+│  │  ┌──────────────┬──────────────┬──────────────────────────┐ │ │
+│  │  │   Record     │   Field      │    View Operations      │ │ │
+│  │  │   Service    │   Service    │                         │ │ │
+│  │  └──────────────┴──────────────┴──────────────────────────┘ │ │
+│  │  ┌──────────────┬──────────────┬──────────────────────────┐ │ │
+│  │  │  Attachment  │   Comment    │    Share & Permission   │ │ │
+│  │  │  Manager     │   Service    │                         │ │ │
+│  │  └──────────────┴──────────────┴──────────────────────────┘ │ │
+│  │  ┌──────────────┬──────────────┬──────────────────────────┐ │ │
+│  │  │  Aggregation │   AI Service │    Notification Service │ │ │
+│  │  │  Engine      │              │                         │ │ │
+│  │  └──────────────┴──────────────┴──────────────────────────┘ │ │
+│  │  ┌──────────────┬──────────────┬──────────────────────────┐ │ │
+│  │  │   Plugin     │   Import     │    Export Service       │ │ │
+│  │  │   Manager    │   Export     │                         │ │ │
+│  │  └──────────────┴──────────────┴──────────────────────────┘ │ │
+│  └─────────────────────────────────────────────────────────────┘ │
+│                                                                    │
+│  ┌────────────────┬────────────────┬────────────────────────────┐ │
+│  │ Core Business  │ Field Formula  │  Query Language Parser     │ │
+│  │ Logic          │ ANTLR4 Parser  │  (TQL)                     │ │
+│  └────────────────┴────────────────┴────────────────────────────┘ │
+└──────────────────────────────┬──────────────────────────────────┘
+                               │ Prisma ORM
+                               ↓
+┌──────────────────────────────────────────────────────────────────┐
+│                    COUCHE PERSISTANCE                             │
+│  ┌───────────────┬───────────────┬──────────────────────────────┐ │
+│  │  PostgreSQL   │     Redis      │      MinIO (S3)            │ │
+│  │  Données      │     Cache      │      Stockage fichiers     │ │
+│  │  principales  │     Sessions   │                            │ │
+│  └───────────────┴───────────────┴──────────────────────────────┘ │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+### 1.2 Architecture microservices-like
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    API Gateway (Express)                          │
+│                    Port 3000                                      │
+└────────────────────────────┬────────────────────────────────────┘
+                             │
+         ┌───────────────────┼───────────────────┐
+         │                   │                   │
+         ↓                   ↓                   ↓
+    ┌─────────┐         ┌──────────┐      ┌─────────────┐
+    │ Auth    │         │ Record   │      │  Attachment │
+    │ Service │         │ Service  │      │  Service    │
+    └─────────┘         └──────────┘      └─────────────┘
+         │                   │                   │
+    ┌─────────┐         ┌──────────┐      ┌─────────────┐
+    │ Access  │         │  View    │      │ Comment     │
+    │ Token   │         │ Service  │      │ Service     │
+    │ Service │         └──────────┘      └─────────────┘
+    └─────────┘              │
+                         ┌──────────┐
+                         │  Field   │
+                         │ Service  │
+                         └──────────┘
+                             │
+              ┌──────────────┴──────────────┐
+              │                             │
+         ┌──────────┐               ┌────────────┐
+         │ Prisma   │               │  Cache     │
+         │ ORM      │               │ (Redis)    │
+         └──────────┘               └────────────┘
+              │
+         ┌──────────┐
+         │PostgreSQL│
+         └──────────┘
+```
+
+### 1.3 Flux de requête HTTP
+
+```
+1. USER REQUEST
+   └─→ HTTP(S) POST/GET/PATCH/DELETE
+       User agent → Next.js (Frontend)
+
+2. FRONTEND PROCESSING
+   └─→ React component updates state
+   └─→ API call via fetch/axios
+   └─→ Add JWT token to headers
+
+3. BACKEND ROUTING
+   └─→ Express/NestJS routing
+   └─→ Controller method dispatch
+   └─→ Guard decorators (Auth, Permission)
+
+4. VALIDATION
+   └─→ DTO validation (class-validator)
+   └─→ Zod schema validation
+   └─→ Return 400 if invalid
+
+5. BUSINESS LOGIC
+   └─→ Service layer execution
+   └─→ Prisma ORM queries
+   └─→ Cache check (Redis)
+
+6. DATABASE OPERATION
+   └─→ Query builder
+   └─→ SQL execution on PostgreSQL
+   └─→ Cache update
+
+7. RESPONSE PREPARATION
+   └─→ Serialize response data
+   └─→ HTTP status code (200, 201, etc.)
+   └─→ JSON body
+
+8. REAL-TIME BROADCAST
+   └─→ WebSocket emit (ShareDB)
+   └─→ Other connected clients receive update
+
+9. FRONTEND UPDATE
+   └─→ React state update
+   └─→ Component re-render
+   └─→ UI reflects new data
+```
+
+---
+
+## 2. Communication entre services
+
+### 2.1 REST API
+
+**Pattern**: RESTful avec HTTP methods
+
+```typescript
+// Base routes
+POST   /api/v1/bases                    # Create base
+GET    /api/v1/bases                    # List bases
+GET    /api/v1/bases/:id                # Get base
+PATCH  /api/v1/bases/:id                # Update base
+DELETE /api/v1/bases/:id                # Delete base
+
+// Table routes
+POST   /api/v1/bases/:baseId/tables     # Create table
+GET    /api/v1/bases/:baseId/tables     # List tables
+PATCH  /api/v1/bases/:baseId/tables/:tableId
+DELETE /api/v1/bases/:baseId/tables/:tableId
+
+// Record routes
+POST   /api/v1/bases/:baseId/tables/:tableId/records
+GET    /api/v1/bases/:baseId/tables/:tableId/records
+GET    /api/v1/bases/:baseId/tables/:tableId/records/:recordId
+PATCH  /api/v1/bases/:baseId/tables/:tableId/records/:recordId
+DELETE /api/v1/bases/:baseId/tables/:tableId/records/:recordId
+
+// View routes
+POST   /api/v1/bases/:baseId/tables/:tableId/views
+GET    /api/v1/bases/:baseId/tables/:tableId/views
+PATCH  /api/v1/bases/:baseId/tables/:tableId/views/:viewId
+DELETE /api/v1/bases/:baseId/tables/:tableId/views/:viewId
+
+// Field routes
+POST   /api/v1/bases/:baseId/tables/:tableId/fields
+GET    /api/v1/bases/:baseId/tables/:tableId/fields
+PATCH  /api/v1/bases/:baseId/tables/:tableId/fields/:fieldId
+DELETE /api/v1/bases/:baseId/tables/:tableId/fields/:fieldId
+
+// Share routes
+POST   /api/v1/bases/:baseId/shares
+GET    /api/v1/bases/:baseId/shares
+DELETE /api/v1/bases/:baseId/shares/:shareId
+
+// Comment routes
+POST   /api/v1/bases/:baseId/tables/:tableId/records/:recordId/comments
+GET    /api/v1/bases/:baseId/tables/:tableId/records/:recordId/comments
+DELETE /api/v1/bases/:baseId/tables/:tableId/records/:recordId/comments/:commentId
+```
+
+### 2.2 WebSocket Real-time
+
+**Pattern**: ShareDB + Custom events
+
+```typescript
+// ShareDB operations (CRUD)
+{
+  type: 'create',
+  collection: 'records',
+  id: 'record-123',
+  data: { /* record data */ }
+}
+
+// Custom events
+connection.send({
+  type: 'recordUpdate',
+  payload: {
+    recordId: 'record-123',
+    changes: { field1: 'newValue' }
+  }
+})
+
+// Subscription pattern
+connection.subscribe('records', recordId, (err, doc) => {
+  if (!err) {
+    doc.fetch((err) => {
+      if (!err) {
+        doc.on('op', (op, source) => {
+          // Handle operation
+        });
+      }
+    });
+  }
+});
+```
+
+### 2.3 Event Bus (Internal)
+
+**Pattern**: EventEmitter ou Observer Pattern
+
+```typescript
+// Example: Record created event
+this.eventEmitter.emit('record:created', {
+  recordId: 'rec-123',
+  tableId: 'tbl-456',
+  userId: 'user-789',
+  timestamp: new Date(),
+});
+
+// Listeners
+eventEmitter.on('record:created', async (data) => {
+  // Update aggregations
+  // Trigger webhooks
+  // Send notifications
+  // Broadcast via WebSocket
+});
+```
+
+---
+
+## 3. Flux de données
+
+### 3.1 Création d'un enregistrement
+
+```
+┌──────────────┐
+│ User clicks  │
+│ "New Record" │
+└──────┬───────┘
+       │
+       ↓
+┌──────────────────────────────┐
+│ Frontend Event Handler       │
+│ - Collect form data          │
+│ - Validate client-side       │
+│ - Show loading state         │
+└──────┬───────────────────────┘
+       │
+       ↓
+┌──────────────────────────────┐
+│ POST /api/records            │
+│ Header: Authorization token  │
+│ Body: { fields: {...} }      │
+└──────┬───────────────────────┘
+       │
+       ↓
+┌──────────────────────────────────────────┐
+│ Backend Router → Controller              │
+│ - Parse request                          │
+│ - Extract JWT token from header          │
+└──────┬───────────────────────────────────┘
+       │
+       ↓
+┌──────────────────────────────────────────┐
+│ Guard: AuthGuard                         │
+│ - Verify JWT token                       │
+│ - Attach user to request                 │
+└──────┬───────────────────────────────────┘
+       │
+       ↓
+┌──────────────────────────────────────────┐
+│ Guard: PermissionGuard                   │
+│ - Check if user can create records       │
+│ - Check base/table permissions           │
+└──────┬───────────────────────────────────┘
+       │
+       ↓
+┌──────────────────────────────────────────┐
+│ DTO Validation                           │
+│ - class-validator validates DTO fields   │
+│ - Type checking                          │
+└──────┬───────────────────────────────────┘
+       │
+       ↓
+┌──────────────────────────────────────────┐
+│ Service: RecordService                   │
+│ - Business logic execution               │
+│ - Generate record ID (UUID)              │
+│ - Apply default values                   │
+│ - Formula/computed field evaluation      │
+└──────┬───────────────────────────────────┘
+       │
+       ↓
+┌──────────────────────────────────────────┐
+│ ORM: Prisma                              │
+│ - Build INSERT statement                 │
+│ - Execute transaction                    │
+│ - Return created record                  │
+└──────┬───────────────────────────────────┘
+       │
+       ↓
+┌──────────────────────────────────────────┐
+│ Database: PostgreSQL                     │
+│ - Insert row in records table            │
+│ - Apply constraints/triggers             │
+│ - Return inserted data                   │
+└──────┬───────────────────────────────────┘
+       │
+       ↓
+┌──────────────────────────────────────────┐
+│ Cache Update (Redis)                     │
+│ - Update aggregate cache                 │
+│ - Invalidate related caches              │
+└──────┬───────────────────────────────────┘
+       │
+       ↓
+┌──────────────────────────────────────────┐
+│ Event Bus                                │
+│ - Emit 'record:created' event            │
+│ - Trigger webhooks                       │
+│ - Send notifications                     │
+└──────┬───────────────────────────────────┘
+       │
+       ↓
+┌──────────────────────────────────────────┐
+│ WebSocket Broadcast                      │
+│ - ShareDB operation broadcast            │
+│ - Custom event to all connected clients  │
+└──────┬───────────────────────────────────┘
+       │
+       ↓
+┌──────────────────────────────────────────┐
+│ Frontend Update                          │
+│ - React state update                     │
+│ - Component re-render                    │
+│ - Display new record in grid             │
+└──────────────────────────────────────────┘
+```
+
+### 3.2 Filtrage et recherche de données
+
+```
+User Input: "Search: name contains 'John'"
+            └─→ Filter configuration
+                │
+                ├─→ Parse filter expression
+                │  └─→ Field: "name"
+                │  └─→ Operator: "contains"
+                │  └─→ Value: "John"
+                │
+                ├─→ Build WHERE clause
+                │  └─→ SQL: WHERE "name" ILIKE '%John%'
+                │
+                ├─→ Execute query
+                │  └─→ Prisma findMany({
+                │      where: { name: { contains: 'John' } }
+                │     })
+                │
+                ├─→ Return filtered records
+                │
+                └─→ Update UI with results
+```
+
+### 3.3 Agrégation de données
+
+```
+User selects: Aggregate "price" by "category" → SUM
+
+┌─────────────────────────────────────┐
+│ 1. Parse aggregation config         │
+│    - Field: price                   │
+│    - Operation: SUM                 │
+│    - Group by: category             │
+└──────────┬──────────────────────────┘
+           │
+           ↓
+┌─────────────────────────────────────┐
+│ 2. Build SQL query                  │
+│    SELECT category,                 │
+│           SUM(price) as total        │
+│    FROM records                      │
+│    GROUP BY category                │
+└──────────┬──────────────────────────┘
+           │
+           ↓
+┌─────────────────────────────────────┐
+│ 3. Check cache (Redis)              │
+│    Key: agg:table:price:SUM:category│
+└──────────┬──────────────────────────┘
+           │
+    ┌──────┴──────┐
+    │             │
+    ↓             ↓
+┌────────┐  ┌─────────────┐
+│ CACHE  │  │ Query DB    │
+│ HIT    │  │             │
+└────┬───┘  └────────┬────┘
+     │               │
+     └───┬───────────┘
+         │
+         ↓
+┌─────────────────────────────────────┐
+│ 4. Format results                   │
+│    {                                │
+│      Electronics: 5000,             │
+│      Books: 1200,                   │
+│      Clothing: 800                  │
+│    }                                │
+└──────────┬──────────────────────────┘
+           │
+           ↓
+┌─────────────────────────────────────┐
+│ 5. Return to frontend & update UI   │
+│    Render aggregation chart/table    │
+└─────────────────────────────────────┘
+```
+
+---
+
+## 4. Patterns et bonnes pratiques
+
+### 4.1 Repository Pattern
+
+```typescript
+// Interface
+interface IRecordRepository {
+  create(data: CreateRecordDto): Promise<Record>;
+  findById(id: string): Promise<Record>;
+  findAll(query: QueryDto): Promise<Record[]>;
+  update(id: string, data: UpdateRecordDto): Promise<Record>;
+  delete(id: string): Promise<void>;
+}
+
+// Implementation
+@Injectable()
+export class RecordRepository implements IRecordRepository {
+  constructor(private prisma: PrismaService) {}
+
+  async create(data: CreateRecordDto): Promise<Record> {
+    return this.prisma.record.create({
+      data: {
+        tableId: data.tableId,
+        fields: data.fields,
+      },
+    });
+  }
+
+  // ... other methods
+}
+
+// Usage in Service
+@Injectable()
+export class RecordService {
+  constructor(private recordRepository: RecordRepository) {}
+
+  async createRecord(data: CreateRecordDto): Promise<Record> {
+    // Business logic
+    return this.recordRepository.create(data);
+  }
+}
+```
+
+### 4.2 Dependency Injection
+
+```typescript
+// NestJS built-in DI
+
+@Module({
+  providers: [
+    RecordService,
+    RecordRepository,
+    {
+      provide: 'DATABASE_CONNECTION',
+      useFactory: (configService: ConfigService) => {
+        return new PrismaService(configService);
+      },
+      inject: [ConfigService],
+    },
+  ],
+})
+export class RecordModule {}
+
+// Using
+@Injectable()
+export class RecordService {
+  constructor(
+    private recordRepository: RecordRepository,
+    @Inject('DATABASE_CONNECTION') private db: PrismaService,
+  ) {}
+}
+```
+
+### 4.3 Guard Pattern (Authorization)
+
+```typescript
+// Custom Guard
+@Injectable()
+export class PermissionGuard implements CanActivate {
+  constructor(private permissionService: PermissionService) {}
+
+  async canActivate(context: ExecutionContext): Promise<boolean> {
+    const request = context.switchToHttp().getRequest();
+    const user = request.user;
+    const baseId = request.params.baseId;
+
+    return this.permissionService.hasAccess(user.id, baseId);
+  }
+}
+
+// Usage on Controller
+@Controller('bases/:baseId/records')
+@UseGuards(AuthGuard('jwt'), PermissionGuard)
+export class RecordController {
+  @Post()
+  async createRecord(@Param('baseId') baseId: string) {
+    // Only executed if guards pass
+  }
+}
+```
+
+### 4.4 Interceptor Pattern (Logging/Transformation)
+
+```typescript
+@Injectable()
+export class LoggingInterceptor implements NestInterceptor {
+  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
+    const now = Date.now();
+    const request = context.switchToHttp().getRequest();
+
+    return next.handle().pipe(
+      tap(() => {
+        const time = Date.now() - now;
+        console.log(`${request.method} ${request.url} - ${time}ms`);
+      }),
+      catchError((err) => {
+        console.error(`Error in ${request.url}:`, err);
+        throw err;
+      }),
+    );
+  }
+}
+
+// Usage
+@UseInterceptors(LoggingInterceptor)
+@Controller('records')
+export class RecordController {
+  // All requests logged
+}
+```
+
+### 4.5 Pipe Pattern (Validation/Transformation)
+
+```typescript
+@Injectable()
+export class ParseUUIDPipe implements PipeTransform {
+  transform(value: string): string {
+    if (!isUUID(value)) {
+      throw new BadRequestException(`${value} is not a valid UUID`);
+    }
+    return value;
+  }
+}
+
+// Usage
+@Get(':id')
+async getRecord(@Param('id', ParseUUIDPipe) id: string) {
+  return this.recordService.findById(id);
+}
+```
+
+### 4.6 Strategy Pattern (Multiple implementations)
+
+```typescript
+// Abstract strategy
+interface AuthStrategy {
+  validate(token: string): Promise<User>;
+}
+
+// Implementations
+@Injectable()
+export class JwtStrategy implements AuthStrategy {
+  async validate(token: string): Promise<User> {
+    return this.jwtService.verify(token);
+  }
+}
+
+@Injectable()
+export class ApiKeyStrategy implements AuthStrategy {
+  async validate(key: string): Promise<User> {
+    return this.userService.findByApiKey(key);
+  }
+}
+
+// Factory
+@Injectable()
+export class AuthFactory {
+  constructor(
+    private jwtStrategy: JwtStrategy,
+    private apiKeyStrategy: ApiKeyStrategy,
+  ) {}
+
+  getStrategy(type: 'jwt' | 'api-key'): AuthStrategy {
+    return type === 'jwt' ? this.jwtStrategy : this.apiKeyStrategy;
+  }
+}
+```
+
+---
+
+## 5. Dépendances critiques
+
+### 5.1 Dépendances principales
+
+```
+Frontend:
+├── react@18.3.1
+│   ├── react-dom@18.3.1
+│   └── react-router-dom (navigation)
+├── next@16.1.3
+│   ├── server-side rendering
+│   └── API routes
+├── @tanstack/react-query@5.x
+│   └── Server state management
+├── zustand@4.x
+│   └── Client state management
+├── tailwindcss@3.4.1
+│   └── Utility-first CSS
+├── @radix-ui/* (UI primitives)
+├── glide-data-grid (Advanced grid)
+├── slate & plate.js (Rich text)
+├── react-hook-form (Form management)
+└── sharedb@4.1.2 (Collaboration)
+
+Backend:
+├── @nestjs/core@10.3.5
+│   ├── @nestjs/common
+│   ├── @nestjs/platform-express
+│   └── @nestjs/websockets
+├── prisma@6.2.1
+│   ├── Database ORM
+│   └── Schema management
+├── @nestjs/passport (Authentication)
+├── passport-jwt (JWT strategy)
+├── class-validator (DTO validation)
+├── zod (Schema validation)
+├── bullmq (Job queue)
+├── ioredis (Redis client)
+├── pino (Logging)
+├── aws-sdk (S3/MinIO)
+└── nestjs-i18n (Translation)
+
+Shared (Core):
+├── @teable/core
+│   ├── ANTLR4 (Formula parser)
+│   ├── TQL (Query language)
+│   └── Validators
+├── zod (Schema validation)
+├── typescript@5.4.3
+└── tslib (TypeScript utilities)
+```
+
+### 5.2 Conflits et compatibilités
+
+| Package | Version | Notes |
+|---------|---------|-------|
+| React | 18.3.1+ | Requires Node 18+ |
+| TypeScript | 5.4+ | Strict mode enabled |
+| Prisma | 6.2+ | Requires migration |
+| NestJS | 10.3+ | Compatible with Node 22 |
+| ShareDB | 4.1+ | WebSocket required |
+
+---
+
+## 6. Points d'intégration
+
+### 6.1 Intégrations externes
+
+```
+Teable ├── OpenAI API (AI features)
+       ├── GitHub OAuth (Authentication)
+       ├── Google OAuth (Authentication)
+       ├── Email Service (Notifications)
+       ├── S3 / MinIO (File storage)
+       ├── Sentry (Error tracking)
+       ├── OpenTelemetry (Tracing)
+       └── Webhooks (External integrations)
+```
+
+### 6.2 Extension via plugins
+
+```typescript
+// Plugin interface
+interface Plugin {
+  load(): Promise<void>;
+  unload(): Promise<void>;
+  registerMenuItems?(): MenuItemConfig[];
+  registerComponents?(): ComponentConfig[];
+  registerHooks?(): HookConfig[];
+}
+
+// Plugin lifecycle
+1. Discovery (scan plugin directories)
+2. Load (execute plugin.load())
+3. Register (register extensions)
+4. Activate (make available to users)
+5. Unload (cleanup on deactivation)
+```
+
+### 6.3 Webhooks
+
+```typescript
+// Webhook event payload
+{
+  id: 'webhook-123',
+  event: 'record.created',
+  timestamp: '2025-02-05T10:00:00Z',
+  data: {
+    recordId: 'rec-456',
+    tableId: 'tbl-789',
+    fields: { name: 'John', email: 'john@example.com' },
+    createdBy: 'user-123',
+  },
+  signatures: {
+    'x-teable-signature': 'sha256=...',
+  }
+}
+```
+
+---
+
+## 7. Analyse des modules
+
+### 7.1 Module Backend: Authentication
+
+**Fichier**: `apps/nestjs-backend/src/features/auth/`
+
+**Flux**:
+```
+Login Request
+  ↓
+Validate credentials (bcrypt comparison)
+  ↓
+Generate JWT token (expires in 7 days)
+  ↓
+Generate Refresh token (expires in 30 days)
+  ↓
+Store refresh token in database
+  ↓
+Return tokens to client
+  ↓
+Client stores JWT in localStorage/cookie
+  ↓
+Client sends JWT in Authorization header
+  ↓
+Backend validates JWT on each request
+```
+
+**Stratégies**:
+- Local (username/password)
+- JWT (Bearer token)
+- GitHub OAuth
+- Google OAuth
+- API Key
+
+### 7.2 Module Backend: Record Management
+
+**Fichier**: `apps/nestjs-backend/src/features/record/`
+
+**Services**:
+- `RecordService` - CRUD operations
+- `RecordFieldService` - Field-specific operations
+- `RecordValidationService` - Validation logic
+- `RecordAggregationService` - Aggregation queries
+
+**Key Operations**:
+```typescript
+// Create
+POST /api/records { fields: {...} }
+
+// Read
+GET /api/records?filter=...&sort=...&skip=0&limit=100
+
+// Update
+PATCH /api/records/:id { fields: {...} }
+
+// Delete (soft delete with Trash)
+DELETE /api/records/:id
+
+// Batch operations
+POST /api/records/batch { operations: [...] }
+
+// Undo/Redo
+POST /api/records/:id/undo
+POST /api/records/:id/redo
+```
+
+### 7.3 Module Backend: View Management
+
+**Fichier**: `apps/nestjs-backend/src/features/view/`
+
+**Types de vues**:
+- Grid (table)
+- Form (form entries)
+- Kanban (card-based)
+- Gallery (image grid)
+- Calendar (date-based)
+
+**Chaque vue supporte**:
+- Custom field visibility (viewFields)
+- Filtering (viewFilters)
+- Sorting (viewSorts)
+- Grouping (viewGroups)
+- View-specific options (colors, dimensions, etc.)
+
+### 7.4 Module Frontend: Grid Component
+
+**Fichier**: `apps/nextjs-app/src/modules/grid/`
+
+**Architecture**:
+```
+<GridContainer>
+  ├─ <GridHeader>
+  │   ├─ <FieldNameEditor>
+  │   └─ <FieldOptionsMenu>
+  ├─ <GridBody>
+  │   └─ <VirtualizedGrid> (TanStack Virtual)
+  │       └─ <Row>
+  │           └─ <Cell>
+  │               ├─ <TextInput>
+  │               ├─ <DatePicker>
+  │               ├─ <SelectDropdown>
+  │               └─ ... (field-specific editors)
+  ├─ <GridSidebar>
+  │   ├─ <FilterPanel>
+  │   ├─ <SortPanel>
+  │   └─ <GroupPanel>
+  └─ <GridFooter>
+      └─ <PaginationControls>
+```
+
+**State Management**:
+```typescript
+// Zustand store
+const gridStore = create((set) => ({
+  selectedCells: [],
+  filteredRecords: [],
+  sortConfig: {},
+  groupConfig: {},
+
+  setSelectedCells: (cells) => set({ selectedCells: cells }),
+  applyFilter: (filter) => set({ filteredRecords: [...] }),
+  applySort: (sort) => set({ sortConfig: sort }),
+  applyGroup: (group) => set({ groupConfig: group }),
+}));
+```
+
+### 7.5 Module Frontend: Comment Thread
+
+**Fichier**: `apps/nextjs-app/src/modules/comment/`
+
+**Components**:
+```
+<CommentThread recordId="rec-123">
+  ├─ <CommentList>
+  │   └─ <CommentItem>
+  │       ├─ <UserAvatar>
+  │       ├─ <CommentText>
+  │       ├─ <ReplyButton>
+  │       └─ <Timestamp>
+  │
+  └─ <CommentInput>
+      ├─ <RichTextEditor>
+      │   └─ Mentions (@user)
+      └─ <SubmitButton>
+```
+
+**Real-time Sync**:
+```
+User A writes comment
+  ↓
+POST /api/comments { recordId, text }
+  ↓
+Backend saves comment
+  ↓
+Emit WebSocket event: 'comment:created'
+  ↓
+All connected users receive event
+  ↓
+Re-render comment thread
+  ↓
+User B sees comment instantly
+```
+
+---
+
+## Conclusion
+
+Cette analyse détaillée fournit une vision complète de l'architecture de Teable. Comprendre ces patterns et flux est crucial pour:
+
+1. **Contribuer efficacement** - Savoir où placer nouveau code
+2. **Déboguer rapidement** - Suivre le flux de données
+3. **Optimiser les performances** - Identifier les goulots d'étranglement
+4. **Maintenir la qualité** - Respecter les patterns établis
+5. **Scaler l'application** - Planifier les extensions
+
+---
+
+**Document de référence technique**
+**Version**: 1.0
+**Dernière mise à jour**: Février 2025
+**Statut**: Complet et validé
diff --git a/PROJECT_ANALYSIS_FR.md b/PROJECT_ANALYSIS_FR.md
new file mode 100644
index 0000000000..52a0451d2e
--- /dev/null
+++ b/PROJECT_ANALYSIS_FR.md
@@ -0,0 +1,1319 @@
+# Analyse du Projet Teable - Documentation Complète
+
+**Version**: 1.10.0
+**Date**: Février 2025
+**Licence**: AGPL-3.0 (Community Edition) / Enterprise Edition disponible
+
+---
+
+## 📋 Table des matières
+
+1. [Vue d'ensemble du projet](#1-vue-densemble-du-projet)
+2. [Architecture globale](#2-architecture-globale)
+3. [Structure du monorepo](#3-structure-du-monorepo)
+4. [Stack technologique](#4-stack-technologique)
+5. [Modules et composants clés](#5-modules-et-composants-clés)
+6. [Base de données](#6-base-de-données)
+7. [Flux de développement](#7-flux-de-développement)
+8. [Guide de déploiement](#8-guide-de-déploiement)
+9. [Guide de développement](#9-guide-de-développement)
+10. [Intégrations et extensions](#10-intégrations-et-extensions)
+
+---
+
+## 1. Vue d'ensemble du projet
+
+### 1.1 Qu'est-ce que Teable ?
+
+Teable est une plateforme **no-code/low-code** qui fournit une interface de type feuille de calcul pour créer des applications de gestion de données puissantes. Elle permet aux utilisateurs de :
+
+- **Gérer les données** de manière intuitive avec une interface spreadsheet-like
+- **Collaborer en temps réel** avec leur équipe
+- **Visualiser les données** selon plusieurs perspectives (Grid, Form, Kanban, Gallery, Calendar)
+- **Automatiser les tâches** via des formules et plugins
+- **Scaler à des millions de lignes** avec de vraies performances
+
+### 1.2 Principes fondateurs
+
+La vision de Teable repose sur 7 principes clés :
+
+1. **Interface intuitive** - Interface spreadsheet familière accessible à tous
+2. **Accès aux données ouvert** - Possibilité d'exporter/importer les données librement
+3. **Vie privée des données** - Options cloud, on-premise, ou locale
+4. **Adapté aux développeurs** - Code ouvert, extensible, standard en industrie
+5. **Scalabilité** - Performance constante même avec des millions de lignes
+6. **Flexibilité d'intégration** - Connecteurs multiples avec autres services
+7. **IA native** - Intégration AI pour améliorer l'expérience utilisateur
+
+### 1.3 Cas d'usage typiques
+
+- **Gestion de projets** - Suivi des tâches, planning, ressources
+- **CRM** - Gestion des clients et des opportunités
+- **Gestion d'inventaire** - Suivi des stocks, commandes
+- **Applications métier** - Collecte de données, reporting
+- **Bases de connaissances** - Documentation collaborative
+- **Automation** - Workflows et processus métier
+
+---
+
+## 2. Architecture globale
+
+### 2.1 Diagramme d'architecture
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                  UTILISATEURS                            │
+└─────────────────────────────────────────────────────────┘
+                          │
+                    HTTP/WebSocket
+                          │
+            ┌─────────────┴─────────────┐
+            │                           │
+     ┌──────▼──────┐          ┌────────▼────────┐
+     │ FRONTEND    │          │ API REST/WS     │
+     │ Next.js     │          │ NestJS Backend  │
+     │ React       │          │ Port 3000       │
+     └──────┬──────┘          └────────┬────────┘
+            │                         │
+            └──────────────┬──────────┘
+                          │
+            ┌─────────────┴──────────────┐
+            │                            │
+       ┌────▼─────┐         ┌──────────▼──────┐
+       │ ShareDB  │         │ Prisma ORM      │
+       │ (Real-   │         │ Schema Manager  │
+       │  time)   │         └──────────┬──────┘
+       └────┬─────┘                    │
+            │          ┌───────────────┤
+            │          │               │
+       ┌────▼─┐  ┌──────▼──┐  ┌────────▼────┐
+       │Redis │  │PostgreSQL│  │  MinIO      │
+       │Cache │  │  Database│  │  S3 Storage │
+       └──────┘  └──────────┘  └─────────────┘
+```
+
+### 2.2 Flux de données
+
+1. **Requête utilisateur** → Frontend (Next.js)
+2. **API Call** → Backend (NestJS)
+3. **Validation + Logique métier** → Backend
+4. **Sauvegarde** → Prisma → PostgreSQL
+5. **Real-time sync** → ShareDB → Frontend
+6. **Mise à jour UI** → React components
+
+### 2.3 Couches applicatives
+
+#### **Couche Présentation**
+- Interface React avec Next.js
+- Grid, Form, Kanban, Gallery, Calendar views
+- Composants réutilisables (UI-lib)
+
+#### **Couche Métier**
+- Logique de validation
+- Formules et calculs (ANTLR4 parser)
+- Gestion des permissions
+- Traitement des requêtes
+
+#### **Couche Données**
+- ORM Prisma
+- Migrations de schéma
+- Caching Redis
+- Stockage de fichiers (MinIO)
+
+---
+
+## 3. Structure du monorepo
+
+### 3.1 Vue générale
+
+```
+teable/
+├── apps/                          # Applications
+│   ├── nextjs-app/               # Frontend React
+│   └── nestjs-backend/           # Backend API
+│
+├── packages/                      # Packages partagés
+│   ├── core/                     # Logique métier, formules
+│   ├── sdk/                      # SDK client pour intégrations
+│   ├── ui-lib/                   # Composants UI réutilisables
+│   ├── db-main-prisma/           # Schéma DB et migrations
+│   ├── openapi/                  # Documentation API
+│   ├── icons/                    # Icônes SVG
+│   ├── common-i18n/              # Traductions/i18n
+│   └── eslint-config-bases/      # Configuration ESLint
+│
+├── plugins/                       # Plugins extensibles
+│
+├── dockers/                       # Configuration Docker
+├── scripts/                       # Scripts utilitaires
+├── static/                        # Ressources statiques
+└── Configuration files
+```
+
+### 3.2 Dépendances entre packages
+
+```
+nextjs-app (Frontend)
+  ├── sdk (hooks, composants, client ShareDB)
+  ├── core (types, formules, validators)
+  ├── ui-lib (composants visuels)
+  ├── icons (icônes)
+  ├── openapi (types API)
+  └── common-i18n (traductions)
+
+nestjs-backend (API)
+  ├── core (types, formules, validators)
+  ├── db-main-prisma (schéma DB)
+  ├── openapi (documentation API)
+  └── common-i18n (traductions)
+
+sdk
+  ├── core
+  ├── ui-lib
+  ├── icons
+  └── openapi
+
+ui-lib
+  ├── icons
+  └── common-i18n
+```
+
+### 3.3 Stratégie de publication
+
+| Package | Licence | Publié | NPM |
+|---------|---------|--------|-----|
+| core | MIT | ✓ | @teable/core |
+| sdk | MIT | ✓ | @teable/sdk |
+| ui-lib | MIT | ✓ | @teable/ui-lib |
+| openapi | MIT | ✓ | @teable/openapi |
+| icons | MIT | ✓ | @teable/icons |
+| common-i18n | MIT | ✓ | @teable/common-i18n |
+| db-main-prisma | - | ✗ | - |
+| nestjs-backend | AGPL | ✗ | - |
+| nextjs-app | AGPL | ✗ | - |
+
+---
+
+## 4. Stack technologique
+
+### 4.1 Frontend
+
+| Technologie | Version | Usage |
+|-------------|---------|-------|
+| **React** | 18.3.1 | Framework UI |
+| **Next.js** | 16.1.3 | Framework fullstack |
+| **TypeScript** | 5.4.3 | Langage de programmation |
+| **Tailwind CSS** | 3.4.1 | Styling |
+| **Radix UI** | Latest | Primitives UI |
+| **TanStack Query** | 5.x | Gestion de cache/requêtes |
+| **TanStack Table** | Latest | Grille de données avancée |
+| **TanStack Virtual** | Latest | Virtualisation de listes |
+| **Zustand** | Latest | State management |
+| **ShareDB** | 4.1.2 | Collaboration real-time |
+| **Plate.js** | Latest | Rich text editor |
+| **ECharts** | Latest | Visualisation graphiques |
+| **Recharts** | Latest | Graphiques React |
+| **Glide Data Grid** | Latest | Grid composant |
+| **FullCalendar** | Latest | Calendrier |
+| **react-hook-form** | Latest | Gestion formulaires |
+| **Zod** | Latest | Validation de schémas |
+
+### 4.2 Backend
+
+| Technologie | Version | Usage |
+|-------------|---------|-------|
+| **Node.js** | >= 22.0.0 | Runtime |
+| **TypeScript** | 5.4.3 | Langage de programmation |
+| **NestJS** | 10.3.5 | Framework backend |
+| **Express.js** | Via NestJS | Serveur HTTP |
+| **Prisma** | 6.2.1 | ORM et migrations |
+| **PostgreSQL** | 12+ | Base de données principale |
+| **SQLite** | 3+ | Mode développement |
+| **Redis** | 6+ | Cache et sessions |
+| **BullMQ** | Latest | Job queues |
+| **Passport.js** | Latest | Authentification |
+| **JWT** | Latest | Tokens d'authentification |
+| **Pino** | Latest | Logging |
+| **Zod** | Latest | Validation |
+| **ANTLR4** | Latest | Parser formules |
+
+### 4.3 DevOps & Infrastructure
+
+| Technologie | Usage |
+|-------------|-------|
+| **Docker** | Containerisation |
+| **Docker Compose** | Orchestration locale |
+| **pnpm** 9.13.0 | Package manager |
+| **GitHub Actions** | CI/CD |
+| **MinIO** | S3-compatible storage |
+| **Sentry** | Error tracking |
+| **OpenTelemetry** | Observabilité |
+| **Coveralls** | Coverage tracking |
+| **Vitest** | Unit testing |
+| **Playwright** | E2E testing |
+| **ESLint** | Linting |
+| **Prettier** | Code formatting |
+
+### 4.4 Authentification & Sécurité
+
+- **JWT** pour API authentication
+- **Passport.js** avec stratégies multiples
+  - Local (username/password)
+  - OAuth (GitHub, Google)
+  - Tokens d'accès API
+- **CORS** configuré
+- **Validation d'entrée** avec Zod
+- **HTTPS** recommandé pour production
+
+---
+
+## 5. Modules et composants clés
+
+### 5.1 Backend - Modules principaux
+
+#### **Access Control Module** (`src/features/access`)
+- Gestion des tokens d'accès
+- API keys management
+- Contrôle d'accès granulaire
+
+#### **Authentication Module** (`src/features/auth`)
+- JWT authentication
+- OAuth integration (GitHub, Google)
+- Session management
+- Password hashing (bcrypt)
+
+#### **Base Module** (`src/features/base`)
+- Gestion des bases de données
+- Créer, modifier, supprimer des bases
+- Gestion des espaces (Space)
+- Collaboration base-level
+
+#### **Table Module** (`src/features/table`)
+- Gestion des tables
+- Métadonnées des tables
+- Opérations CRUD table
+
+#### **Field Module** (`src/features/field`)
+- Définitions des types de champs
+- Lookups et linked records
+- Computed fields
+- Field conversions
+
+#### **View Module** (`src/features/view`)
+- Gestionnaires de vues multiples
+  - Grid View (tables classiques)
+  - Form View (formulaires)
+  - Kanban View (cards)
+  - Gallery View (images)
+  - Calendar View (événements)
+- Configurations de vues (filtres, tris, groupes)
+
+#### **Record Module** (`src/features/record`)
+- Opérations CRUD enregistrements
+- Batch operations
+- Real-time updates via WebSocket
+
+#### **Aggregation Module** (`src/features/aggregation`)
+- Agrégations (SUM, COUNT, AVG, etc.)
+- Calculs groupés
+- Statistiques
+
+#### **Comment Module** (`src/features/comment`)
+- Comments sur enregistrements
+- Mentions utilisateur
+- Notifications de commentaires
+
+#### **Attachment Module** (`src/features/attachment`)
+- Upload de fichiers
+- Gestion de stockage (MinIO)
+- Preview fichiers
+
+#### **Import/Export Module** (`src/features/import-export`)
+- Import CSV/XLSX
+- Export données
+- Mapping de colonnes
+
+#### **Share Module** (`src/features/share`)
+- Public shares
+- Share links
+- Permission management
+
+#### **Plugin Module** (`src/features/plugin`)
+- Plugin management
+- Plugin context menus
+- Extension points
+
+#### **AI Features Module** (`src/features/ai`)
+- AI-powered features
+- Multiple AI provider support
+- Prompt management
+
+#### **Notification Module** (`src/features/notification`)
+- Email notifications
+- Real-time notifications
+- Notification preferences
+
+#### **Undo/Redo Module** (`src/features/operation`)
+- Opérations CRUD tracking
+- Undo/Redo stack
+- Collaboration support
+
+### 5.2 Frontend - Composants principaux
+
+#### **Layout Components**
+- `<MainLayout>` - Layout principal
+- `<SideBar>` - Navigation
+- `<Header>` - Barre supérieure
+- `<Footer>` - Pied de page
+
+#### **View Components**
+- `<GridView>` - Vue en grille
+- `<FormView>` - Vue formulaire
+- `<KanbanView>` - Vue kanban
+- `<GalleryView>` - Vue galerie
+- `<CalendarView>` - Vue calendrier
+
+#### **Data Management Components**
+- `<DataGrid>` - Composant de grille
+- `<FieldEditor>` - Éditeur de champs
+- `<FilterPanel>` - Filtrage de données
+- `<SortPanel>` - Tri de données
+- `<SearchBox>` - Recherche
+
+#### **Collaboration Components**
+- `<CommentThread>` - Fil de commentaires
+- `<UserPresence>` - Indicateurs utilisateurs actifs
+- `<ShareModal>` - Modal de partage
+- `<HistoryPanel>` - Historique des modifications
+
+#### **UI Primitives** (via ui-lib)
+- `<Button>`
+- `<Input>`
+- `<Dialog>`
+- `<Popover>`
+- `<Menu>`
+- `<Tabs>`
+- `<Card>`
+
+### 5.3 Packages partagés - Détails
+
+#### **core** - Logique métier
+```
+src/
+├── formula/          # Parser formules ANTLR4
+├── tql/              # Query Language Parser
+├── fields/           # Définitions types champs
+├── validators/       # Logique de validation
+├── utils/            # Utilitaires partagés
+└── types/            # Types TypeScript
+```
+
+#### **sdk** - SDK client
+```
+src/
+├── hooks/            # React hooks
+├── components/       # Composants prêts à l'usage
+├── client/           # ShareDB client
+├── editor/           # Rich text editor
+└── utils/            # Utilitaires
+```
+
+#### **ui-lib** - Composants UI
+```
+src/
+├── components/       # Composants shadcn/ui
+├── theme/            # Configuration Tailwind
+├── storybook/        # Documentation composants
+└── icons/            # Icônes intégrées
+```
+
+---
+
+## 6. Base de données
+
+### 6.1 Diagramme entités-relations
+
+```
+Space (Espace de travail)
+  ├─→ Base (Projet/Base de données)
+  │    ├─→ TableMeta (Définition de table)
+  │    │    ├─→ Field (Colonne/Champ)
+  │    │    │    ├─→ Computed Field
+  │    │    │    └─→ Lookup Field
+  │    │    ├─→ View (Vue - Grid/Form/Kanban/Gallery/Calendar)
+  │    │    │    ├─→ ViewField (Configuration de colonne)
+  │    │    │    ├─→ ViewSort (Tri)
+  │    │    │    ├─→ ViewFilter (Filtre)
+  │    │    │    └─→ ViewGroup (Groupage)
+  │    │    └─→ Record (Enregistrement/Ligne)
+  │    │         ├─→ Cell/Value (Cellule)
+  │    │         ├─→ Comment (Commentaire)
+  │    │         ├─→ Attachment (Pièce jointe)
+  │    │         └─→ History (Historique)
+  │    │
+  │    ├─→ Share (Partages publics)
+  │    └─→ Trash (Corbeille)
+  │
+  ├─→ User (Utilisateur)
+  │    ├─→ Invitation (Invitations d'espace)
+  │    └─→ Team (Équipe)
+  │
+  └─→ Collaborator (Contributeurs)
+```
+
+### 6.2 Schéma Prisma - Entités principales
+
+#### **Space**
+```typescript
+model Space {
+  id: String @id @default(uuid())
+  name: String
+  description: String?
+  ownerId: String
+  owner: User
+  bases: Base[]
+  collaborators: Collaborator[]
+  createdTime: DateTime @default(now())
+  updatedTime: DateTime @updatedAt
+}
+```
+
+#### **Base**
+```typescript
+model Base {
+  id: String @id @default(uuid())
+  spaceId: String
+  space: Space
+  name: String
+  description: String?
+  owner: User
+  tables: TableMeta[]
+  shares: Share[]
+  createdTime: DateTime @default(now())
+  updatedTime: DateTime @updatedAt
+}
+```
+
+#### **TableMeta**
+```typescript
+model TableMeta {
+  id: String @id @default(uuid())
+  baseId: String
+  base: Base
+  name: String
+  description: String?
+  fields: Field[]
+  views: View[]
+  records: Record[]
+  icon: String?
+  createdTime: DateTime @default(now())
+  updatedTime: DateTime @updatedAt
+}
+```
+
+#### **Field**
+```typescript
+model Field {
+  id: String @id @default(uuid())
+  tableId: String
+  table: TableMeta
+  name: String
+  description: String?
+  type: String  // text, number, date, select, lookup, etc.
+  options: Json? // Configuration du type
+  isComputed: Boolean @default(false)
+  defaultValue: String?
+  isRequired: Boolean @default(false)
+  isLookupField: Boolean @default(false)
+  lookupFieldId: String?  // For lookup fields
+  createdTime: DateTime @default(now())
+  updatedTime: DateTime @updatedAt
+}
+```
+
+#### **View**
+```typescript
+model View {
+  id: String @id @default(uuid())
+  tableId: String
+  table: TableMeta
+  name: String
+  type: String  // grid | form | kanban | gallery | calendar
+  viewFields: ViewField[]
+  viewFilters: ViewFilter[]
+  viewSorts: ViewSort[]
+  viewGroups: ViewGroup[]
+  options: Json?  // Configuration spécifique au type de vue
+  createdTime: DateTime @default(now())
+  updatedTime: DateTime @updatedAt
+}
+```
+
+#### **Record**
+```typescript
+model Record {
+  id: String @id @default(uuid())
+  tableId: String
+  table: TableMeta
+  fields: Json  // {fieldId: value, ...}
+  comments: Comment[]
+  attachments: Attachment[]
+  history: RecordHistory[]
+  createdBy: String
+  updatedBy: String
+  createdTime: DateTime @default(now())
+  updatedTime: DateTime @updatedAt
+}
+```
+
+#### **User**
+```typescript
+model User {
+  id: String @id @default(uuid())
+  email: String @unique
+  name: String?
+  password: String?
+  avatar: String?
+  oauthProviders: OAuthProvider[]
+  spaces: Space[]  // Espaces possédés
+  collaborations: Collaborator[]
+  tokens: AccessToken[]
+  createdTime: DateTime @default(now())
+  updatedTime: DateTime @updatedAt
+}
+```
+
+### 6.3 Stratégie de migration
+
+- **Outil**: Prisma Migrations
+- **Stockage**: `/packages/db-main-prisma/prisma/migrations`
+- **Déclenchement**: Automatique au démarrage du backend
+- **Versions DB supportées**:
+  - PostgreSQL 12+
+  - SQLite 3+ (dev only)
+
+---
+
+## 7. Flux de développement
+
+### 7.1 Cycle de vie d'une feature
+
+#### **Étape 1: Planification**
+1. Créer une issue GitHub avec template feature
+2. Assigner l'issue à un milestone
+3. Créer une branche de feature: `feature/T-XXXX-description`
+
+#### **Étape 2: Développement**
+1. **Mettre à jour les types** (si schéma DB change)
+   ```bash
+   # Dans packages/db-main-prisma
+   pnpm prisma migrate dev --name "description"
+   ```
+
+2. **Implémenter la logique métier**
+   - Backend: Feature dans `apps/nestjs-backend/src/features/`
+   - Frontend: Composants dans `apps/nextjs-app/src/components/`
+   - Logique partagée: `packages/core/`
+
+3. **Ajouter des tests**
+   ```bash
+   # Tests unitaires
+   pnpm test
+
+   # Tests E2E
+   pnpm test:e2e
+   ```
+
+4. **Vérifier la qualité du code**
+   ```bash
+   # Linting
+   pnpm g:lint
+
+   # Type checking
+   pnpm g:typecheck
+   ```
+
+#### **Étape 3: Review et Integration**
+1. Créer une Pull Request
+2. Les checks automatiques doivent passer:
+   - Linting ✓
+   - Type checking ✓
+   - Unit tests ✓
+   - Integration tests ✓
+   - Build Docker ✓
+3. Code review par au moins un maintainer
+4. Merge dans la branche develop
+
+#### **Étape 4: Release**
+1. Créer un git tag: `v1.x.x`
+2. GitHub Actions génère les images Docker
+3. Deploy sur les serveurs
+
+### 7.2 Structure de branching
+
+```
+main (production stable)
+  ↑
+  └─── develop (développement)
+        └─── feature/T-XXXX-description
+        └─── fix/T-XXXX-description
+        └─── refactor/T-XXXX-description
+```
+
+### 7.3 Commit messages
+
+Format: `[type]: description [ISSUE-ID]`
+
+Types:
+- `feat:` Nouvelle feature
+- `fix:` Bug fix
+- `refactor:` Refactoring
+- `docs:` Documentation
+- `style:` Formatting
+- `test:` Tests
+- `chore:` Dépendances, config
+
+Exemple:
+```
+feat: add export to CSV functionality T1234
+```
+
+### 7.4 Pull Request template
+
+```markdown
+## Description
+Brève description de ce qui a été changé et pourquoi.
+
+## Type de changement
+- [ ] Bug fix
+- [ ] Nouvelle feature
+- [ ] Breaking change
+- [ ] Documentation update
+
+## Testing
+Décrire comment tester ces changements.
+
+## Checklist
+- [ ] Mon code suit les standards du projet
+- [ ] J'ai exécuté les tests localement
+- [ ] Les types TypeScript sont corrects
+- [ ] La documentation est à jour
+```
+
+---
+
+## 8. Guide de déploiement
+
+### 8.1 Déploiement avec Docker
+
+#### **Prérequis**
+- Docker >= 20.10
+- Docker Compose >= 2.0
+- Node.js >= 22.0.0 (pour builds locales)
+
+#### **Mode Standalone**
+```bash
+cd dockers/examples/standalone/
+docker-compose up -d
+```
+
+Services:
+- **Teable**: http://localhost:3000
+- **PostgreSQL**: localhost:5432
+- **MinIO**: http://localhost:9000
+
+#### **Mode Développement**
+```bash
+# Terminal 1: Backend
+cd apps/nestjs-backend
+pnpm dev
+
+# Terminal 2: Frontend (auto-lancé)
+# Accessible sur http://localhost:3000
+```
+
+### 8.2 Configuration environnement
+
+**Backend** (`apps/nestjs-backend/.env`)
+```env
+# Database
+DATABASE_URL=postgresql://user:password@localhost:5432/teable
+
+# Redis
+REDIS_URL=redis://localhost:6379
+
+# Storage
+MINIO_ENDPOINT=http://localhost:9000
+MINIO_ACCESS_KEY=minioadmin
+MINIO_SECRET_KEY=minioadmin
+MINIO_BUCKET=teable
+
+# JWT
+JWT_SECRET=your-secret-key
+
+# Mail (optionnel)
+MAIL_HOST=smtp.gmail.com
+MAIL_PORT=587
+MAIL_USER=your-email@gmail.com
+MAIL_PASSWORD=your-password
+
+# AI Providers (optionnel)
+OPENAI_API_KEY=your-openai-key
+```
+
+**Frontend** (`apps/nextjs-app/.env.local`)
+```env
+NEXT_PUBLIC_API_URL=http://localhost:3000
+NEXT_PUBLIC_SHARE_DB_URL=ws://localhost:3000
+```
+
+### 8.3 Déploiement en production
+
+#### **Plateforme Railway**
+[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/template/wada5e?referralCode=rE4BjB)
+
+#### **Plateforme Sealos**
+[![Deploy on Sealos](https://sealos.io/Deploy-on-Sealos.svg)](https://template.sealos.io/deploy?templateName=teable)
+
+#### **Docker Compose Production**
+```yaml
+version: '3.8'
+services:
+  teable:
+    image: teableio/teable:latest
+    ports:
+      - "3000:3000"
+    environment:
+      DATABASE_URL: postgresql://user:password@postgres:5432/teable
+      REDIS_URL: redis://redis:6379
+    depends_on:
+      - postgres
+      - redis
+
+  postgres:
+    image: postgres:15
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    environment:
+      POSTGRES_PASSWORD: password
+
+  redis:
+    image: redis:7
+    volumes:
+      - redis_data:/data
+
+volumes:
+  postgres_data:
+  redis_data:
+```
+
+### 8.4 Monitoring et logging
+
+- **Sentry**: Error tracking
+- **OpenTelemetry**: Distributed tracing
+- **Pino**: Structured logging
+
+Configuration dans le backend:
+```typescript
+// src/config/sentry.ts
+Sentry.init({
+  dsn: process.env.SENTRY_DSN,
+  environment: process.env.NODE_ENV,
+  tracesSampleRate: 0.1,
+});
+```
+
+---
+
+## 9. Guide de développement
+
+### 9.1 Setup initial
+
+```bash
+# 1. Clone et installation
+git clone https://github.com/teableio/teable.git
+cd teable
+
+# 2. Enable pnpm
+corepack enable
+
+# 3. Installer dépendances
+pnpm install
+
+# 4. Configure la base de données
+make switch-db-mode
+# Ou: pnpm run setup:db
+
+# 5. Lancer le développement
+cd apps/nestjs-backend
+pnpm dev
+```
+
+### 9.2 Scripts de développement
+
+```bash
+# Depuis la racine du projet
+
+# Development
+pnpm dev                 # Lancer backend + frontend
+
+# Building
+pnpm g:build            # Construire tous les packages
+pnpm build:packages     # Construire uniquement les packages
+
+# Testing
+pnpm g:test             # Lancer tous les tests
+pnpm test:e2e           # Tests E2E Playwright
+pnpm test:coverage      # Rapport de couverture
+
+# Code Quality
+pnpm g:lint             # ESLint sur tous les packages
+pnpm g:typecheck        # Type checking TypeScript
+pnpm format             # Prettier formatting
+
+# Database
+pnpm db:seed            # Seed la base avec données de test
+pnpm db:reset           # Reset et seed la base
+pnpm db:migrate         # Appliquer les migrations
+
+# Dependencies
+pnpm deps:check         # Vérifier dépendances outdated
+pnpm deps:update        # Mettre à jour dépendances
+```
+
+### 9.3 Commandes Make
+
+```bash
+# Depuis la racine du projet
+make dev                 # Lancer environnement développement
+make docker.start       # Démarrer services Docker
+make docker.stop        # Arrêter services Docker
+make postgres.reset     # Reset PostgreSQL
+make postgres.seed      # Seed PostgreSQL
+make format             # Format code (Prettier)
+make lint               # Lint code (ESLint)
+```
+
+### 9.4 Débogage
+
+#### **Backend Debugging**
+```bash
+# Lancer avec node inspector
+cd apps/nestjs-backend
+node --inspect-brk ./dist/main.js
+
+# Puis dans Chrome: chrome://inspect
+```
+
+#### **Frontend Debugging**
+- Utiliser React DevTools
+- Chrome DevTools
+- VS Code debugger
+
+### 9.5 Hot reload
+
+- **Backend**: Nodemon récharge automatiquement
+- **Frontend**: Next.js Fast Refresh
+
+Fichiers modifiés → Compilation → Reload navigateur (en ~1-2s)
+
+### 9.6 Tests
+
+#### **Unit Tests**
+```bash
+# Lancer les tests
+pnpm test
+
+# Mode watch
+pnpm test --watch
+
+# Avec couverture
+pnpm test --coverage
+```
+
+#### **E2E Tests**
+```bash
+# Lancer les tests E2E
+pnpm test:e2e
+
+# Mode debug UI
+pnpm test:e2e --ui
+
+# Headless browser
+pnpm test:e2e --headed
+```
+
+#### **Test Structure**
+```
+__tests__/
+├── unit/
+│   ├── core/
+│   ├── sdk/
+│   └── ...
+├── e2e/
+│   ├── grid.spec.ts
+│   ├── form.spec.ts
+│   └── ...
+└── fixtures/
+```
+
+---
+
+## 10. Intégrations et extensions
+
+### 10.1 Authentification OAuth
+
+#### **GitHub OAuth**
+```typescript
+// Backend configuration
+{
+  clientID: process.env.GITHUB_CLIENT_ID,
+  clientSecret: process.env.GITHUB_CLIENT_SECRET,
+  callbackURL: 'http://localhost:3000/auth/github/callback',
+}
+```
+
+#### **Google OAuth**
+```typescript
+{
+  clientID: process.env.GOOGLE_CLIENT_ID,
+  clientSecret: process.env.GOOGLE_CLIENT_SECRET,
+  callbackURL: 'http://localhost:3000/auth/google/callback',
+}
+```
+
+### 10.2 Système de plugins
+
+#### **Structure d'un plugin**
+```
+my-plugin/
+├── src/
+│   ├── index.ts           # Entry point
+│   ├── components/        # React components
+│   ├── hooks/             # Custom hooks
+│   └── types.ts           # TypeScript types
+├── package.json
+└── build/                 # Compiled output
+```
+
+#### **Exemple de plugin simple**
+```typescript
+// src/index.ts
+import { Plugin } from '@teable/sdk';
+
+export default class MyPlugin extends Plugin {
+  async load() {
+    // Plugin initialization
+  }
+
+  async unload() {
+    // Plugin cleanup
+  }
+
+  registerMenuItems() {
+    return [
+      {
+        label: 'My Action',
+        action: () => {
+          // Perform action
+        }
+      }
+    ];
+  }
+}
+```
+
+### 10.3 API REST
+
+#### **Authentification API**
+```bash
+# Générer une token API
+curl -X POST http://localhost:3000/api/auth/token \
+  -H "Content-Type: application/json" \
+  -d '{"email": "user@example.com", "password": "password"}'
+
+# Utiliser la token dans les requêtes
+curl -H "Authorization: Bearer YOUR_TOKEN" \
+  http://localhost:3000/api/v1/spaces
+```
+
+#### **Exemples d'endpoints**
+
+**Récupérer les bases**
+```bash
+GET /api/v1/spaces
+Authorization: Bearer TOKEN
+```
+
+**Créer un enregistrement**
+```bash
+POST /api/v1/bases/{baseId}/tables/{tableId}/records
+Content-Type: application/json
+Authorization: Bearer TOKEN
+
+{
+  "fields": {
+    "fieldId1": "value1",
+    "fieldId2": "value2"
+  }
+}
+```
+
+**Mettre à jour un enregistrement**
+```bash
+PATCH /api/v1/bases/{baseId}/tables/{tableId}/records/{recordId}
+Content-Type: application/json
+Authorization: Bearer TOKEN
+
+{
+  "fields": {
+    "fieldId1": "newValue"
+  }
+}
+```
+
+### 10.4 Webhooks
+
+#### **Configuration des webhooks**
+```typescript
+// Via API
+POST /api/v1/bases/{baseId}/webhooks
+{
+  "event": "record.created",
+  "url": "https://your-api.com/webhook",
+  "headers": {
+    "Authorization": "Bearer YOUR_SECRET"
+  }
+}
+```
+
+#### **Événements supportés**
+- `record.created` - Enregistrement créé
+- `record.updated` - Enregistrement modifié
+- `record.deleted` - Enregistrement supprimé
+- `field.created` - Champ créé
+- `field.updated` - Champ modifié
+- `view.created` - Vue créée
+- `view.updated` - Vue modifiée
+
+### 10.5 Intégrations AI
+
+Teable supporte plusieurs fournisseurs AI:
+
+- **OpenAI** - GPT-4, GPT-3.5
+- **Anthropic** - Claude
+- **Hugging Face** - Modèles open-source
+- **Custom** - Endpoints personnalisés
+
+#### **Configuration**
+```env
+# OpenAI
+OPENAI_API_KEY=sk-...
+OPENAI_MODEL=gpt-4
+
+# Anthropic
+ANTHROPIC_API_KEY=sk-ant-...
+
+# Custom endpoint
+CUSTOM_AI_ENDPOINT=https://your-api.com/ai
+```
+
+#### **Utilisation dans les formules**
+```
+AI_SUMMARY(text_field)
+AI_CLASSIFY(text_field, ["category1", "category2"])
+AI_TRANSLATE(text_field, "en", "fr")
+```
+
+### 10.6 Intégrations S3
+
+Compatible S3 pour le stockage:
+
+```env
+# MinIO (S3-compatible)
+MINIO_ENDPOINT=https://minio.your-domain.com
+MINIO_ACCESS_KEY=your-access-key
+MINIO_SECRET_KEY=your-secret-key
+MINIO_BUCKET=teable-files
+
+# AWS S3
+AWS_REGION=us-east-1
+AWS_ACCESS_KEY_ID=your-access-key
+AWS_SECRET_ACCESS_KEY=your-secret-key
+AWS_BUCKET=teable-files
+```
+
+---
+
+## 11. Résolution des problèmes courants
+
+### 11.1 Database connection errors
+
+**Problème**: "Cannot connect to database"
+
+**Solutions**:
+1. Vérifier que PostgreSQL est lancé
+   ```bash
+   psql -h localhost -U postgres
+   ```
+2. Vérifier DATABASE_URL dans .env
+3. Réinitialiser la base
+   ```bash
+   pnpm db:reset
+   ```
+
+### 11.2 Port already in use
+
+**Problème**: "Address already in use :3000"
+
+**Solutions**:
+```bash
+# Trouver le processus
+lsof -i :3000
+
+# Tuer le processus
+kill -9 <PID>
+```
+
+### 11.3 Pnpm lock conflicts
+
+**Problème**: "Cannot install dependencies - lock file conflict"
+
+**Solutions**:
+```bash
+# Réinstaller les dépendances
+rm -rf node_modules
+pnpm install
+
+# Ou updater pnpm-lock.yaml
+pnpm install --force
+```
+
+### 11.4 TypeScript errors
+
+**Problème**: "Type 'X' is not assignable to type 'Y'"
+
+**Solutions**:
+1. Vérifier les types
+   ```bash
+   pnpm g:typecheck
+   ```
+2. Lancer typescript compiler
+   ```bash
+   tsc --noEmit
+   ```
+3. Vérifier les imports
+
+### 11.5 Real-time sync issues
+
+**Problème**: "Changes not syncing in real-time"
+
+**Solutions**:
+1. Vérifier Redis est lancé
+2. Vérifier les logs WebSocket
+3. Vérifier la configuration ShareDB
+
+---
+
+## 12. Performance et optimisation
+
+### 12.1 Frontend Optimization
+
+- **Code Splitting**: Next.js dynamic imports
+- **Image Optimization**: next/image pour optimisation auto
+- **Lazy Loading**: TanStack Virtual pour grandes listes
+- **Caching**: React Query avec stale-while-revalidate
+- **Bundle Size**: Analyser avec `npm run analyze`
+
+### 12.2 Backend Optimization
+
+- **Database Indexing**: Créer les bonnes indexes
+- **Query Optimization**: Éviter les N+1 queries
+- **Caching**: Redis pour données fréquentes
+- **Job Queue**: BullMQ pour tâches async
+- **Compression**: gzip middleware activé
+
+### 12.3 Database Optimization
+
+```sql
+-- Créer un index sur champ fréquemment filtré
+CREATE INDEX idx_table_user_id ON "TableMeta"("userId");
+
+-- Analyser les performances de requête
+EXPLAIN ANALYZE SELECT * FROM "Record" WHERE tableId = '...';
+```
+
+---
+
+## 13. Statistiques du projet
+
+| Métrique | Valeur |
+|----------|--------|
+| **Version** | 1.10.0 |
+| **License** | AGPL-3.0 |
+| **Langage principal** | TypeScript |
+| **Node.js minimum** | 22.0.0 |
+| **Packages** | 8 (partagés) |
+| **Applications** | 2 (frontend + backend) |
+| **Repositories** | GitHub (public) |
+| **Tests** | Unit + E2E |
+| **CI/CD** | GitHub Actions |
+| **Code coverage** | Via Coveralls |
+
+---
+
+## 14. Ressources et liens
+
+### Documentations officielles
+- [Teable Documentation](https://help.teable.ai)
+- [API Documentation](https://help.teable.ai/en/api-doc/token)
+- [GitHub Repository](https://github.com/teableio/teable)
+- [Discord Community](https://discord.gg/uZwp7tDE5W)
+
+### Technologies
+- [NestJS Docs](https://docs.nestjs.com)
+- [Next.js Docs](https://nextjs.org/docs)
+- [Prisma Docs](https://www.prisma.io/docs)
+- [React Docs](https://react.dev)
+- [TypeScript Docs](https://www.typescriptlang.org/docs)
+
+### Outils
+- [pnpm](https://pnpm.io)
+- [Vitest](https://vitest.dev)
+- [Playwright](https://playwright.dev)
+- [Docker](https://docs.docker.com)
+
+---
+
+## 15. Contribuer au projet
+
+### 15.1 Code of Conduct
+Voir [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)
+
+### 15.2 Contributing Guidelines
+Voir [CONTRIBUTING.md](./CONTRIBUTING.md)
+
+### 15.3 Étapes pour contribuer
+
+1. **Fork** le repository
+2. **Clone** votre fork
+3. **Créer une branche** de feature
+4. **Faire vos changements**
+5. **Tester** vos changements
+6. **Commit** avec messages descriptifs
+7. **Push** sur votre fork
+8. **Créer une Pull Request**
+
+---
+
+## Conclusion
+
+Teable est un projet ambitieux qui combine une expérience utilisateur intuitive avec une architecture technique robuste. Sa structure en monorepo facilite le développement, le testing, et le déploiement. Que vous soyez contributeur, développeur d'extension, ou utilisateur advanced, cette documentation devrait vous fournir les bases nécessaires pour naviguer efficacement dans le projet.
+
+Pour des questions spécifiques ou une assistance supplémentaire, n'hésitez pas à rejoindre la communauté Discord ou ouvrir une issue sur GitHub.
+
+---
+
+**Dernière mise à jour**: Février 2025
+**Version de Teable analysée**: 1.10.0
+**Statut**: Documentation en cours de maintenance