Nutritionist Livewire Components

​

Overview

​

NutricionistaProfile

​

Purpose

​

Traits

• WithFileUploads - Enables file upload functionality for profile photos

​

Properties

​

Validation Rules

'name' => 'required|string|max:255'
'phone' => 'nullable|string|max:10'
'profile_photo' => 'nullable|image|max:2048'
'consultation_price' => 'required|numeric|min:0|max:999999.99'
'current_password' => 'required_with:password|string' // if hasPassword
'password' => 'nullable|string|min:8|confirmed'

​

Methods

​

mount(): void

1. Verifies user has nutricionista role (aborts with 403 if not)
2. Loads user name and email
3. Checks if user has custom password (not default)
4. Loads personal data if exists
5. Loads consultation price from settings

if ($user->personalData) {
    $this->hasPersonalData = true;
    $this->phone = $user->personalData->phone ?? '';
    $this->profile_photo_path = $user->personalData->profile_photo ?? '';
}

​

saveProfile(): void

1. Validates profile fields
2. Updates user name
3. Handles profile photo upload:
   • Deletes old photo if exists
   • Stores new photo in profile-photos directory
4. Updates or creates PersonalData record
5. Updates or creates NutricionistaSettings with consultation price
6. Redirects with success message

• success: “Tu perfil ha sido actualizado correctamente.”
• error: “Error al actualizar el perfil: “

​

updatePassword(): void

1. Validates current password (if user has custom password)
2. Validates new password (min 8 chars, confirmed)
3. Verifies current password matches
4. Hashes and saves new password
5. Sends PasswordChangedNotification to user
6. Resets password fields
7. Redirects with success message

• password_success: “Tu contraseña ha sido actualizada correctamente.”
• password_error: “La contraseña actual es incorrecta.” or “Error al actualizar la contraseña: “

​

Usage Example

<livewire:nutricionista.nutricionista-profile />

​

PatientDataForm

​

Purpose

​

Properties

​

Validation Rules

'gender' => 'required|in:male,female,other'
'birth_date' => 'required|date|before:today|after:{120 years ago}'
'cedula' => 'nullable|numeric|digits_between:6,20|unique:personal_data,cedula'
'phone' => 'nullable|numeric|digits:10'
'address' => 'nullable|string|max:255'

​

Methods

​

mount(User $patient, ?int $appointmentId = null): void

1. Verifies authenticated user is a nutritionist (aborts with 403 if not)
2. Verifies patient has paciente role (aborts with 404 if not)
3. Checks if patient already has personal data
4. If data exists, loads it and sets form to read-only
5. Stores optional appointment ID for post-save redirect

if ($patient->personalData) {
    $this->hasPersonalData = true;
    $this->isReadOnly = true;
    // Load existing data...
}

​

save(): void

1. Prevents save if patient already has data
2. Validates all input fields
3. Creates PersonalData record
4. Sends PersonalDataCreatedNotification to patient
5. Redirects based on appointment ID:
   • If appointment ID exists: redirects to create attention record
   • Otherwise: redirects to patient list

• error: “Este paciente ya tiene datos personales asignados.” or “Error al guardar los datos: “

​

Usage Example

<livewire:nutricionista.patient-data-form :patient="$patient" :appointmentId="$appointmentId" />

​

PatientsTable

​

Purpose

​

Traits

• WithPagination - Enables pagination support

​

Properties

​

Query String Parameters

protected $queryString = [
    'search' => ['except' => ''],
    'estado' => ['except' => ''],
    'proximas_citas' => ['except' => ''],
    'sort' => ['except' => 'name'],
    'page' => ['except' => 1],
];

​

Methods

​

updatingSearch(): void

​

updatedEstado(): void

​

updatedProximasCitas(): void

​

clearFilters(): void

​

render()

1. Filters to users with paciente role
2. Eager loads relationships:
   • userState
   • personalData
   • appointmentsAsPaciente (only next pending appointment)
3. Counts total appointments per patient
4. Filters by search term (case-insensitive ILIKE)
5. Filters by user state
6. Filters by upcoming appointments if requested
7. Sorts by name or most recent appointment
8. Paginates with 12 patients per page

• name: Alphabetical by patient name
• recent: By most recent appointment date

• patients - Paginated patient collection
• userStates - All available user states for filtering

​

Advanced Query Example

if ($this->proximas_citas === '1') {
    $query->whereHas('appointmentsAsPaciente', function($q) use ($nutricionista) {
        $q->where('nutricionista_id', $nutricionista->id)
          ->whereHas('appointmentState', fn($sq) => $sq->where('name', 'pendiente'))
          ->where('start_time', '>=', now());
    });
}

​

Usage Example

<livewire:nutricionista.patients-table />

​

Security Considerations

• All components verify the authenticated user has the nutricionista role
• PatientDataForm additionally verifies the target user has the paciente role
• Patient data cannot be edited once created (read-only after initial save)
• File uploads are restricted to images with 2MB max size
• Cedula (national ID) uniqueness is enforced
• Password changes require current password verification
• All inputs are validated server-side

​

Related Models

• App\Models\User - User accounts
• App\Models\PersonalData - Personal information
• App\Models\NutricionistaSettings - Nutritionist-specific settings
• App\Models\UserState - User account states
• App\Models\Appointment - Appointments

​

Notifications

• PasswordChangedNotification - Sent when password is updated
• PersonalDataCreatedNotification - Sent to patient when their data is created