Spaces:
Runtime error
Runtime error
File size: 4,674 Bytes
9cf9a2a d21ea1e 9cf9a2a 4808bed 9cf9a2a d21ea1e 9cf9a2a | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 | """
User model for authentication and authorization.
Provides user management with role-based access control (RBAC).
Author: JuriX Team
Date: 2026-01-12
"""
from datetime import datetime
from sqlalchemy import Boolean, Column, DateTime, Integer, String
from sqlalchemy.orm import relationship
from app.core.database import Base
class User(Base):
"""
User model for authentication and authorization.
Attributes:
id: Unique user identifier
email: User email (unique, used for login)
username: Display username
hashed_password: Bcrypt hashed password
full_name: User's full name
role: User role (user, admin, superadmin)
is_active: Account active status
is_verified: Email verification status
created_at: Account creation timestamp
updated_at: Last update timestamp
last_login_at: Last login timestamp
Relationships:
conversations: User's chat conversations
"""
__tablename__ = "users"
# Primary key
id = Column(Integer, primary_key=True, index=True)
# Authentication
email = Column(String(255), unique=True, index=True, nullable=False)
username = Column(String(100), unique=True, index=True, nullable=False)
# NULLABLE : un compte cree par Google n'a pas de mot de passe. La
# contrainte CHECK `ck_users_au_moins_une_identite` garantit qu'un compte
# porte toujours au moins une identite — mot de passe ou Google.
hashed_password = Column(String(255), nullable=True)
# Claim `sub` du jeton d'identite Google, seul identifiant stable d'un
# compte Google (l'adresse e-mail peut changer chez eux). Unique et
# nullable : les comptes par mot de passe le laissent a NULL, et PostgreSQL
# tolere plusieurs NULL sur un index unique.
google_sub = Column(String(255), nullable=True, unique=True, index=True)
# Profile
full_name = Column(String(255), nullable=True)
# Le profil choisi a l'entree du site (app/core/personas.py), garde pour
# suivre l'utilisateur d'un appareil a l'autre. NULL : aucun choix
# enregistre ; un refus de repondre n'est jamais stocke. La contrainte
# `ck_users_persona_connu` (migration 015) n'admet que les quatre profils.
persona = Column(String(50), nullable=True)
# Authorization
role = Column(
String(50),
nullable=False,
default="user",
index=True,
comment="Role: user, admin, superadmin",
)
# Status flags
is_active = Column(Boolean, default=True, nullable=False)
is_verified = Column(Boolean, default=False, nullable=False)
# Timestamps
created_at = Column(DateTime, default=datetime.utcnow, nullable=False)
updated_at = Column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow, nullable=False)
last_login_at = Column(DateTime, nullable=True)
# Relationships
#
# `lazy="raise"` et NON `selectin`. `get_current_user` charge cet objet a
# CHAQUE requete authentifiee : avec un chargement empresse, chacune
# tirait en plus toutes les conversations du compte — la liste que
# l'historique de chat fait precisement grossir, pour une relation que
# personne ne lit.
#
# La cascade ORM est retiree en meme temps, et c'est indissociable : elle
# exige de charger la collection pour supprimer un compte, ce que `raise`
# interdit. La suppression des conversations d'un compte est desormais
# EXPLICITE dans `admin.delete_user`.
conversations = relationship("Conversation", back_populates="user", lazy="raise")
def __repr__(self) -> str:
return f"<User(id={self.id}, email='{self.email}', role='{self.role}')>"
def has_role(self, required_role: str) -> bool:
"""
Check if user has required role or higher.
Role hierarchy: superadmin > admin > user
Args:
required_role: Required role to check
Returns:
True if user has required role or higher
Example:
>>> user.role = "admin"
>>> user.has_role("user") # True
>>> user.has_role("superadmin") # False
"""
role_hierarchy = {"superadmin": 3, "admin": 2, "user": 1}
user_level = role_hierarchy.get(self.role, 0)
required_level = role_hierarchy.get(required_role, 0)
return user_level >= required_level
def is_admin(self) -> bool:
"""Check if user has admin or superadmin role."""
return self.role in ("admin", "superadmin")
def is_superadmin(self) -> bool:
"""Check if user has superadmin role."""
return self.role == "superadmin"
|