Corentin JOGUET
a0266b886c
Some checks are pending
CI / Lint bridge (Biome) (push) Waiting to run
CI / Type-check bridge (push) Blocked by required conditions
CI / Tests unit bridge (push) Blocked by required conditions
CI / Tests integration bridge (push) Blocked by required conditions
CI / Security scan (push) Waiting to run
CI / Docker build + healthcheck (push) Blocked by required conditions
- schema.json : 17 formulas (rollups + heures_restantes) ajoutees + related_field_name explicite sur les 10 liens - seed.py : 3 nouveaux methodes (create_formula_field, rename_field, create_link_field returns dict) - seed.py : pass 5/6 renomme automatiquement les related fields apres link creation - seed.py : pass 6/6 cree les formulas (idempotent) - README.md : section formulas updated Iteration 2 du plan Fast-App couverte. Apres seed, les rollups (formation_heures_attribuees, personne_heures_restantes_total, etc.) sont automatiques.
88 lines
2.7 KiB
Markdown
88 lines
2.7 KiB
Markdown
# Baserow seed
|
|
|
|
Cree les 9 tables `formation-hub` dans Baserow via l'API. Idempotent — skip ce qui existe.
|
|
|
|
## Quickstart (4 etapes, ~5 min)
|
|
|
|
### 1. Creer le compte admin Baserow (premier boot — manuel UI)
|
|
|
|
Aller sur **http://localhost:8080**. La premiere page propose de creer un compte. Remplir :
|
|
- Workspace name : `Acadenice`
|
|
- Email : `admin@acadenice.fr` (ou autre admin)
|
|
- Password : password robuste (a sauvegarder dans pass/vault)
|
|
|
|
### 2. Pre-requis Python
|
|
|
|
```bash
|
|
cd baserow/seed
|
|
pip install -r requirements.txt
|
|
# OU si tu prefere : python -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt
|
|
```
|
|
|
|
### 3. Run le seed
|
|
|
|
```bash
|
|
BASEROW_URL=http://localhost:8080 \
|
|
BASEROW_EMAIL=admin@acadenice.fr \
|
|
BASEROW_PASSWORD='ton-password' \
|
|
python baserow/seed/seed.py
|
|
```
|
|
|
|
Output attendu :
|
|
```
|
|
[1/5] Login http://localhost:8080
|
|
[auth] Logged in as admin@acadenice.fr
|
|
|
|
[2/5] Workspace 'Acadenice'
|
|
[workspace] Reuse 'Acadenice' id=1
|
|
|
|
[3/5] Database 'formation-hub'
|
|
[db] Created 'formation-hub' id=1
|
|
|
|
[4/5] Tables + primitive fields
|
|
[table] Created 'personne' id=1
|
|
[field] Created 'personne_prenom' (text)
|
|
...
|
|
|
|
[5/5] Link fields (2nd pass)
|
|
[link] Created bloc.bloc_formation -> formation
|
|
...
|
|
|
|
=== Seed OK ===
|
|
Workspace: Acadenice
|
|
Database : formation-hub
|
|
Tables : 9
|
|
Links : 10
|
|
```
|
|
|
|
### 4. Verifier dans l'UI
|
|
|
|
Ouvrir http://localhost:8080, naviguer dans le workspace **Acadenice** → database **formation-hub** → 9 tables doivent etre presentes avec leurs champs et liens.
|
|
|
|
## Re-runnable
|
|
|
|
Le script est **idempotent**. Tu peux le relancer apres modifications du schema — il ne recree pas ce qui existe deja.
|
|
|
|
Pour reset complet : drop la database via l'UI Baserow, puis relancer.
|
|
|
|
## Schema
|
|
|
|
`schema.json` decrit les 9 tables + 10 liens FK. Format JSON declaratif, modifiable.
|
|
|
|
Les **formulas** (rollups, heures_restantes, etc.) sont creees au pass 6/6. Le schema declaratif inclut 17 formulas dans `schema.json` (section `formulas`).
|
|
|
|
Si une formula echoue (syntaxe Baserow strict), le seed s'arrete et affiche l'erreur — corrige le `schema.json` et re-run.
|
|
|
|
## Troubleshooting
|
|
|
|
| Symptome | Cause probable | Fix |
|
|
|----------|----------------|-----|
|
|
| `401 Unauthorized` | Mauvais email/password | Verifier BASEROW_EMAIL et BASEROW_PASSWORD |
|
|
| `400 Bad Request` sur field | Type non supporte version Baserow | Voir logs detail, ajuster `_field_to_payload` |
|
|
| Field deja existant | Idempotent OK | Aucune action |
|
|
| Tables creees mais vides | Normal — pas de seed data Phase 1 | Sera ajoute iteration 6 (migration data) |
|
|
|
|
## References
|
|
|
|
- Baserow API doc : https://baserow.io/api-docs
|
|
- Doc 15 MPD (mapping fields → Baserow types) : `docs/15-baserow-mpd.md`
|