Databaseskabeloner

En skabelon opretter en hel database med ét klik: dens tabeller og deres relationer, eksempelrækker, visninger, et dashboard, automatiseringer og felter, som AI selv udfylder. Skabelongalleriet viser dem, som basedb tilbyder.

Start fra en skabelon

Ny database og derefter Start fra en skabelon, eller bed AI om en: galleriet åbnes.

Hver skabelon kan læses i sin helhed, før den bruges — dens tabeller og deres felter, dens visninger, dens automatiseringer og instruktionen for hvert af dens AI-felter. Opret database beder om en etiket og, hvis der er AI-felter, dit samtykke til, at de værdier, de citerer, sendes til instansens AI-udbyder. Uden dette samtykke er de almindelige felter, udfyldt med deres eksempelværdier.

Indlæs eksempeldata, som er markeret som standard, fylder tabellerne med eksempelrækker, så du kan se databasen i brug. Fjernes markeringen, forbliver tabellerne tomme, klar til dine egne data — visninger, dashboards og automatiseringer oprettes alligevel.

Et tomt projekt tilbyder også demodatabasen: et lille bureau med dets kunder, projekter, opgaver, fakturaer og anmeldelser, som viser alle sider af basedb.

På dit sprog

De officielle skabeloner læses og oprettes på skærmens sprog: tabeller, felter, valg, eksempelrækker, visninger, dashboards, automatiseringer og AI-instruktioner. Eksempelrækkerne skifter verden med sproget: det franske »Boulangerie Martin« i Lyon bliver til »Martins Bageri« i Aarhus på dansk.

En skabelon, der importeres i din instans, eller gemmes fra en database, er skrevet af nogen: den læses, som den er skrevet.

Bed AI om en skabelon

Øverst i galleriet beskriver du dit behov i én sætning — »opfølgning på mine kunders reklamationer med en analyse af tonen«. AI foreslår en komplet database: tabeller, troværdige eksempelrækker, visninger, dashboard og AI-felter, når brugen egner sig til det. Du læser den som en skabelon, du kan finjustere den (»tilføj en tabel med leverandører«) og derefter oprette den. AI modtager kun din sætning — ingen data fra nogen database — og intet oprettes, før du klikker.

Skriv en skabelon i JSON

En skabelon er et JSON-dokument. Her er skelettet:

{
  "format": 1,
  "key": "suivi-tickets",
  "label": "Suivi de tickets",
  "summary": "Une phrase pour la galerie.",
  "category": "Produit et technique",
  "icon": "bug",
  "color": "#ef4444",
  "tables": [
    {
      "key": "tickets",
      "label": "Tickets",
      "fields": [
        { "label": "Titre", "kind": "short_text" },
        { "label": "Statut", "kind": "select", "options": ["Nouveau", "En cours", "Résolu"] },
        { "label": "Ouvert le", "kind": "date" },
        { "label": "Description", "kind": "long_text" },
        { "label": "Catégorie", "kind": "select", "options": ["Bug", "Demande"],
          "ai": { "prompt": "Classe ce ticket : {{Titre}} — {{Description}}" } },
        { "label": "Âge (jours)", "kind": "formula", "formula": "JOURS(AUJOURDHUI(); [Ouvert le])" }
      ]
    },
    { "key": "produits", "label": "Produits", "fields": [{ "label": "Nom", "kind": "short_text" }] }
  ],
  "links": [{ "from": "tickets", "label": "Produit", "to": "produits" }],
  "rows": {
    "produits": [{ "$key": "app", "Nom": "Application mobile" }],
    "tickets": [{ "Titre": "Crash au démarrage", "Statut": "En cours", "Ouvert le": "-3d", "Produit": "@app" }]
  },
  "views": [
    { "table": "tickets", "label": "Tableau", "kind": "kanban", "spec": { "group_by": "Statut" } }
  ],
  "dashboards": [
    { "label": "Vue d’ensemble", "blocks": [
      { "kind": "number", "title": "Ouverts", "table": "tickets", "filter": "[Statut] ne \"Résolu\"" },
      { "kind": "chart", "title": "Par catégorie", "table": "tickets", "group_by": "Catégorie", "style": "pie" }
    ] }
  ],
  "automations": []
}

De vigtigste regler:

• Alt citeres med etiket: et felt i en visning, et filter ([Statut] ne "Résolu"), en formel ([Prix] * [Quantité]), en AI-instruktion eller en besked ({{Titre}}). Et valg angives med sin etiket.
• Det første felt i en tabel er dens visningsfelt: en tekst, et tal, en dato, en e-mail eller en adresse.
• En relation erklæres i links, aldrig som et felt; en række henviser til den med "@clé", $key for en række i måltabellen.
• En dato kan være relativ til den dag, skabelonen anvendes: "today", "+3d", "-2w", "+1m"; en dato med klokkeslæt tilføjer klokkeslættet, "+1d 14:30". En person skrives "$moi".
• Et AI-felt har "ai": { "prompt": "…" } og kan få en eksempelværdi, som kun skrives, når AI ikke bruges.
• En skabelon indeholder aldrig delinger, tilladelser, webhooks, filer eller andre personer end "$moi": den kommer nogle gange udefra og må ikke åbne for noget.

Den komplette reference — alle felttyper, alle nøgler for visninger, grænserne — findes i kapitel 20 i arkitekturdokumentationen i repositoriet.

Udgiv en skabelon til alle instanser

Skabelonerne i det officielle galleri er filerne i mappen packages/templates/catalog i repositoriet, én fil pr. skabelon, navngivet efter dens key. Det offentlige websted laver galleriet ud fra dem og udgiver hele kataloget på adressen /basedb/modeles/catalogue.json. Hver instans læser det, når nogen åbner galleriet, og beholder det i en time: at ændre en fil og udgive webstedet igen er nok til at ændre galleriet på alle instanser.

Hver skabelon kontrolleres, når webstedet bygges, af den samme validator som serveren: en ugyldig skabelon får bygningen til at mislykkes i stedet for at nå ud til brugerne.

En officiel skabelon skrives én gang, på fransk. Dens tekster på et andet sprog er en ordbog, packages/templates/i18n/<langue>/<clé>.json — den franske tekst, så dens oversættelse —, som webstedet udgiver ved siden af kataloget (/basedb/modeles/i18n/<langue>.json). Instansen sætter hver tekst ind og følger hver etiket, der hvor den citeres — formler, filtre, visninger, instruktioner —, og læser derefter resultatet igen: en ordbog, der ville ødelægge skabelonen, serveres ikke, den franske skabelon serveres i stedet. En tekst, der mangler i ordbogen, forbliver på fransk.

Instansen læser adressen BASEDB_TEMPLATES_URL — som standard det offentlige websteds. Peg den mod dit eget katalog, eller sæt den til off for ikke at læse noget: instansen serverer så de skabeloner, der er indbygget i dens version.

Skabelonerne på din instans

En administrator kan importere en JSON-skabelon på sin instans fra galleriet (»Importér en JSON«): den kommer med i galleriet for alle instansens brugere og erstatter en skabelon med samme nøgle. Et forslag fra AI kan tilføjes der med ét klik.

Enhver database kan også blive til en skabelon: Gem som skabelon i databasens menu under Flere handlinger. Dens tabeller, felter, AI-instruktioner, relationer, delte visninger, dashboards og automatiseringer — og, hvis du vil, op til 50 rækker pr. tabel — downloades som JSON, klar til at komme med i det officielle katalog eller i instansens. En automatisering, der finder en række, gennemgår rækker, tager grene eller citerer et tidligere trin, udelades indtil videre, og skærmen siger det.