Overview
The User model extends Laravel’s Authenticatable class and implements email verification. It represents all users in the system including administrators, nutritionists, and patients.
Namespace: App\Models\User
Extends: Illuminate\Foundation\Auth\Authenticatable
Implements: Illuminate\Contracts\Auth\MustVerifyEmail
Traits:
HasFactory - Factory support for testingNotifiable - Laravel notification supportTwoFactorAuthenticatable - Two-factor authentication from Laravel Fortify
Fillable Attributes
Email address for authentication and communication
Timestamp when the email was verified
Hashed password (automatically hashed via cast)
Foreign key to the Role model (administrador, nutricionista, paciente)
Foreign key to the UserState model (1 = activo, 2 = inactivo)
Whether the user has consented to data processing
Timestamp when data consent was granted
Hidden Attributes
The following attributes are automatically hidden from JSON serialization:
passwordtwo_factor_secrettwo_factor_recovery_codesremember_token
Relationships
BelongsTo
Returns the user’s role (Role model)$user->role()->where('name', 'nutricionista')->first();
Returns the user’s current state (UserState model)$user->userState; // Accesses the user_state_id relationship
HasOne
Returns the user’s personal data (PersonalData model)Note: This relationship is always eager-loaded via $with = ['personalData']$user->personalData; // Always available without extra query
Returns nutritionist-specific settings (NutricionistaSettings model)Only applicable for users with the nutricionista role
HasMany
Returns appointments where the user is the patient$user->appointmentsAsPaciente()->where('appointment_state_id', 1)->get();
appointmentsAsNutricionista()
Returns appointments where the user is the nutritionist$nutritionist->appointmentsAsNutricionista()->upcoming()->get();
Returns clinical attentions where the user is the patient
attentionsAsNutricionista()
Returns clinical attentions where the user is the nutritionist
Returns the nutritionist’s availability schedules (NutricionistaSchedule model)Only applicable for users with the nutricionista role
Helper Methods
Role Helpers
public function isAdmin(): bool
true if the user has the ‘administrador’ role.
if ($user->isAdmin()) {
// Grant admin access
}
public function isNutricionista(): bool
true if the user has the ‘nutricionista’ role.
if ($user->isNutricionista()) {
// Show nutritionist dashboard
}
public function isPaciente(): bool
true if the user has the ‘paciente’ role.
State Helpers
public function isActive(): bool
true if the user’s state is active (user_state_id === 1).
public function isInactive(): bool
true if the user’s state is inactive (user_state_id === 2).
Clinical Eligibility
public function estaHabilitadoClinicamente(): bool
- Their state is active (
user_state_id === 1)
- Their email is verified
This method centralizes eligibility logic to avoid repetition in views and controllers.
if ($user->estaHabilitadoClinicamente()) {
// Allow appointment booking
} else {
$reason = $user->motivoInhabilitacion();
// Show error message with reason
}
public function motivoInhabilitacion(): ?string
null if they are eligible.
Possible return values:
"Usuario inactivo" - User state is inactive"Email no verificado" - Email has not been verifiednull - User is clinically eligible
Profile Helpers
public function initials(): string
$user->name = "Juan Carlos Pérez";
echo $user->initials(); // "JC"
public function profilePhotoUrl(): ?string
null if not set.
$photoUrl = $user->profilePhotoUrl();
if ($photoUrl) {
echo "<img src='{$photoUrl}' alt='Profile' />";
}
Notification Methods
public function sendEmailVerificationNotification(): void
App\Notifications\VerifyEmailNotification.
public function sendPasswordResetNotification(string $token): void
App\Notifications\ResetPasswordNotification.
Usage Examples
Creating a New Patient
use App\Models\User;
use Illuminate\Support\Facades\Hash;
$user = User::create([
'name' => 'María González',
'email' => '[email protected]',
'password' => Hash::make('password123'),
'role_id' => 3, // paciente
'user_state_id' => 1, // activo
'data_consent' => true,
'data_consent_at' => now(),
]);
$user->sendEmailVerificationNotification();
Checking User Eligibility
$user = User::find(1);
if (!$user->estaHabilitadoClinicamente()) {
return redirect()->back()->with('error', $user->motivoInhabilitacion());
}
// Proceed with appointment booking
Loading User with Relationships
// PersonalData is always loaded automatically
$user = User::find(1);
$age = $user->personalData->age;
// Load additional relationships
$user = User::with([
'appointmentsAsPaciente.nutricionista',
'attentionsAsPaciente.attentionData'
])->find(1);
Role-Based Authorization
if ($user->isNutricionista()) {
$settings = $user->nutricionistaSettings;
$schedules = $user->schedules;
// Configure nutritionist dashboard
}
if ($user->isPaciente()) {
$appointments = $user->appointmentsAsPaciente;
// Show patient appointment history
}