Mise en place de l'admin

Prérequis

Un projet Runique fonctionnel avec une base de données configurée
Un modèle users avec les champs is_staff et is_superuser (générés par model!)
Le binaire runique installé (cargo install runique ou cargo build du workspace)

Étape 1 — Créer `src/admin.rs`

Ce fichier déclare les ressources administrables via la macro admin! :

// src/admin.rs
use crate::entities::{users, articles};
use crate::formulaire::{RegisterForm, ArticleForm};

admin! {
    users: users::Model => RegisterForm {
        title: "Utilisateurs",
        permissions: ["admin"]
    },
    articles: articles::Model => ArticleForm {
        title: "Articles",
        permissions: ["admin"]
    }
}

Étape 2 — Générer `src/admins/` avec le daemon

runique start

Le daemon lit src/admin.rs, génère src/admins/ et lance cargo run. Le dossier src/admins/ est créé automatiquement — ne pas le modifier manuellement.

src/admins/
  ├── README.md
  ├── mod.rs
  └── admin_panel.rs

Si src/admins/ existe déjà depuis une génération précédente, runique start le régénère.

Étape 3 — Déclarer le module dans `src/main.rs`

mod admin;
mod admins;  // module généré par runique start

Étape 4 — Câbler `.with_admin()` dans le builder

use runique::app::builder::RuniqueAppBuilder as builder;

builder::new(config)
    .routes(url::routes())
    .with_database(db)
    .with_admin(|a| {
        a.site_title("Administration")
         .auth(RuniqueAdminAuth::new())
         .routes(admins::routes("/admin"))
         .with_state(admins::admin_state())
    })
    .build()
    .await?
    .run()
    .await?;

Méthode	Rôle
`.prefix("/admin")`	Préfixe des routes admin (défaut : `/admin`)
`.site_title("…")`	Titre affiché dans l'interface
`.auth(RuniqueAdminAuth::new())`	Authentification admin (par défaut)
`.routes(admins::routes("/admin"))`	Monte les routes CRUD sous `/admin`
`.with_state(…)`	État partagé généré par le daemon
`.no_robots_txt()`	Désactive le `/robots.txt` automatique

robots.txt automatique — Quand l'admin est actif, Runique génère automatiquement une route /robots.txt contenant Disallow: /admin/ pour exclure l'interface des moteurs de recherche. Le préfixe configuré via .prefix() est respecté. Utilisez .no_robots_txt() si vous souhaitez gérer ce fichier vous-même.

Étape 5 — Créer un superuser

runique create-superuser

Suit un assistant interactif pour créer le premier compte admin (is_superuser = true).

Accès à l'interface

Une fois le serveur démarré, l'interface est disponible à :

http://localhost:{PORT}/admin/

La page /admin/login redirige vers le dashboard si les identifiants sont valides.

Revenir au sommaire

Sommaire Admin