Struct UserUseCases 

pub struct UserUseCases { /* private fields */ }

Implementations

impl UserUseCases

pub fn new( user_repo: Arc<dyn UserRepository>, role_repo: Arc<dyn UserRoleRepository>, ) -> Self

pub async fn find_display_name( &self, id: Uuid, ) -> Result<Option<String>, String>

Look up a user’s display name by id (first_name + last_name). Returns None if the user does not exist.

pub async fn list_all(&self) -> Result<Vec<UserResponse>, String>

List all users with their roles.

pub async fn list_page( &self, recherche: Option<String>, role: Option<String>, limit: i64, offset: i64, ) -> Result<(Vec<UserResponse>, i64), String>

Une page d’utilisateurs avec leurs rôles, et le total qui va avec.

Le total n’est pas un ornement : sans lui, l’appelant reçoit un fragment sans savoir la taille du tout, et c’est exactement ainsi qu’une liste tronquée passe pour complète.

list_all reste pour les appelants internes qui ont réellement besoin de tout le monde. Ce qui n’en avait pas besoin, c’est l’écran d’administration : il recevait 4 120 lignes pour en afficher vingt.

pub async fn list_by_organization( &self, organization_id: Uuid, ) -> Result<Vec<UserResponse>, String>

List users belonging to a given organization, with their roles.

Authorization (syndic/accountant own org, superadmin any org) is enforced upstream by the handler via AuthenticatedUser::verify_org_access.

pub async fn create( &self, email: String, password_hash: String, first_name: String, last_name: String, primary_role: UserRole, primary_org: Option<Uuid>, role_assignments: Vec<UserRoleAssignment>, ) -> Result<UserResponse, String>

Create a new user with role assignments. Returns Err("email_exists") on duplicate email.

pub async fn update( &self, id: Uuid, email: String, first_name: String, last_name: String, primary_role: UserRole, primary_org: Option<Uuid>, password_hash: Option<String>, role_assignments: Vec<UserRoleAssignment>, ) -> Result<Option<UserResponse>, String>

Update an existing user. Returns None if not found. Returns Err("email_exists") on duplicate email.

pub async fn activate(&self, id: Uuid) -> Result<Option<UserResponse>, String>

Activate a user. Returns None if not found.

pub async fn deactivate(&self, id: Uuid) -> Result<Option<UserResponse>, String>

Deactivate a user. Returns None if not found.

pub async fn delete(&self, id: Uuid) -> Result<bool, String>

Delete a user. Returns false if not found.

pub async fn validate_user_has_role( &self, user_id: Uuid, role: &str, ) -> Result<(), String>

Verify a user exists and holds the given role. Returns Err("User not found") or Err("User must have role '...' ...").

pub async fn assign_role( &self, target_user_id: Uuid, role: UserRole, organization_id: Option<Uuid>, valid_until: Option<DateTime<Utc>>, granted_by_user_id: Uuid, ) -> Result<UserRoleAssignment, AppError>

Assigne un sous-rôle à un user existant.

L’autorisation (superadmin / syndic-sur-son-org) est vérifiée AMONT par le handler — ici on applique uniquement les invariants métier.

Errors

• AppError::NotFound si target_user_id n’existe pas.
• AppError::Validation si valid_until n’est pas dans le futur, ou si un user tente de s’auto-attribuer un rôle à privilèges élevés (cohérent invariants MagicLink / Mandate §3.2 §3.4).
• AppError::RoleAlreadyAssigned si une assignment active existe déjà pour le tuple (user_id, role, organization_id).

pub async fn list_assignments_for_user( &self, user_id: Uuid, ) -> Result<Vec<UserRoleAssignment>, AppError>

Liste toutes les assignments d’un user (actives + expirées) afin que le FE puisse afficher l’historique.

L’autorisation (superadmin / syndic-sur-son-org / self) est vérifiée AMONT par le handler.

pub async fn revoke_assignment( &self, assignment_id: Uuid, ) -> Result<(), AppError>

Révoque (= supprime) une assignment.

L’autorisation est vérifiée AMONT par le handler. Renvoie AppError::NotFound si l’assignment n’existe pas.