[ADVAPP-1152]: Refactor the data models for telephone numbers, email addresses, physical addresses.

.config/psysh/psysh_history

@@ -0,0 +1,32 @@
+_HiStOrY_V2_
+AdvisingApp\134StudentDataModel\134Models\134StudentPhoneNumber::factory()->create();
+AdvisingApp\134StudentDataModel\134Models\134StudentPhoneNumber::factory()->canRecieveSms()->create();
+AdvisingApp\134StudentDataModel\134Models\134StudentPhoneNumber::factory()->canNotRecieveSms()->create();
+clear
+AdvisingApp\134Prospect\134Models\134ProspectPhoneNumber::factory()->create();
+AdvisingApp\134Prospect\134Models\134ProspectPhoneNumber::factory()->create();
+AdvisingApp\134Prospect\134Models\134ProspectPhoneNumber::factory()->create();
+AdvisingApp\134Prospect\134Models\134ProspectPhoneNumber::factory()->canRecieveSms()->create();
+AdvisingApp\134Prospect\134Models\134ProspectPhoneNumber::factory()->canRecieveSms()->create();
+clear
+AdvisingApp\134Prospect\134Models\134ProspectPhoneNumber::factory()->canNotRecieveSms()->create();
+AdvisingApp\134Prospect\134Models\134ProspectPhoneNumber::factory()->canNotRecieveSms()->create();
+exit
+AdvisingApp\134StudentDataModel\134Models\134StudentEmailAddress::factory(5)->create();
+AdvisingApp\134StudentDataModel\134Models\134StudentEmailAddress::factory(5)->create();
+clear
+AdvisingApp\134StudentDataModel\134Models\134StudenAddress::factory(5)->create();
+AdvisingApp\134StudentDataModel\134Models\134StudentAddress::factory(5)->create();
+AdvisingApp\134StudentDataModel\134Models\134StudentAddress::factory(5)->create();
+AdvisingApp\134StudentDataModel\134Models\134StudentAddress::factory(5)->create();
+clear
+AdvisingApp\134StudentDataModel\134Models\134StudentPhoneNumber::factory(5)->create();
+AdvisingApp\134StudentDataModel\134Models\134StudentPhoneNumber::factory(5)->create();
+clear
+AdvisingApp\134Prospect\134Models\134ProspectEmailAddress::factory(5)->create();
+AdvisingApp\134Prospect\134Models\134ProspectEmailAddress::factory(5)->create();
+AdvisingApp\134Prospect\134Models\134ProspectAddress::factory(5)->create();
+AdvisingApp\134Prospect\134Models\134ProspectAddress::factory(5)->create();
+AdvisingApp\134Prospect\134Models\134ProspectPhoneNumber::factory(5)->create();
+AdvisingApp\134Prospect\134Models\134ProspectPhoneNumber::factory(5)->create();
+exit

app-modules/prospect/database/factories/ProspectAddressFactory.php

@@ -0,0 +1,80 @@
+<?php
+
+/*
+<COPYRIGHT>
+
+    Copyright © 2016-2025, Canyon GBS LLC. All rights reserved.
+
+    Advising App™ is licensed under the Elastic License 2.0. For more details,
+    see https://github.com/canyongbs/advisingapp/blob/main/LICENSE.
+
+    Notice:
+
+    - You may not provide the software to third parties as a hosted or managed
+      service, where the service provides users with access to any substantial set of
+      the features or functionality of the software.
+    - You may not move, change, disable, or circumvent the license key functionality
+      in the software, and you may not remove or obscure any functionality in the
+      software that is protected by the license key.
+    - You may not alter, remove, or obscure any licensing, copyright, or other notices
+      of the licensor in the software. Any use of the licensor’s trademarks is subject
+      to applicable law.
+    - Canyon GBS LLC respects the intellectual property rights of others and expects the
+      same in return. Canyon GBS™ and Advising App™ are registered trademarks of
+      Canyon GBS LLC, and we are committed to enforcing and protecting our trademarks
+      vigorously.
+    - The software solution, including services, infrastructure, and code, is offered as a
+      Software as a Service (SaaS) by Canyon GBS LLC.
+    - Use of this software implies agreement to the license terms and conditions as stated
+      in the Elastic License 2.0.
+
+    For more information or inquiries please visit our website at
+    https://www.canyongbs.com or contact us via email at [email protected].
+
+</COPYRIGHT>
+*/
+
+namespace AdvisingApp\Prospect\Database\Factories;
+
+use AdvisingApp\Prospect\Models\Prospect;
+use AdvisingApp\Prospect\Models\ProspectAddress;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends Factory<ProspectAddress>
+ */
+class ProspectAddressFactory extends Factory
+{
+    private int $maxOrder;
+
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'prospect_id' => Prospect::factory(),
+            'line_1' => fake()->streetAddress(),
+            'line_2' => fake()->optional()->streetAddress(),
+            'line_3' => fake()->optional()->citySuffix(),
+            'city' => fake()->city(),
+            'state' => fake()->state(),
+            'postal' => fake()->postcode(),
+            'country' => fake()->country(),
+            'type' => fake()->randomElement(['Home', 'Dorm', 'Work']),
+            'order' => $this->getNewOrder(),
+        ];
+    }
+
+    public function getNewOrder(): int
+    {
+        return $this->maxOrder = $this->getMaxOrder() + 1;
+    }
+
+    public function getMaxOrder(): int
+    {
+        return $this->maxOrder ??= ProspectAddress::max('order') ?? 0;
+    }
+}

app-modules/prospect/database/factories/ProspectEmailAddressFactory.php

@@ -0,0 +1,74 @@
+<?php
+
+/*
+<COPYRIGHT>
+
+    Copyright © 2016-2025, Canyon GBS LLC. All rights reserved.
+
+    Advising App™ is licensed under the Elastic License 2.0. For more details,
+    see https://github.com/canyongbs/advisingapp/blob/main/LICENSE.
+
+    Notice:
+
+    - You may not provide the software to third parties as a hosted or managed
+      service, where the service provides users with access to any substantial set of
+      the features or functionality of the software.
+    - You may not move, change, disable, or circumvent the license key functionality
+      in the software, and you may not remove or obscure any functionality in the
+      software that is protected by the license key.
+    - You may not alter, remove, or obscure any licensing, copyright, or other notices
+      of the licensor in the software. Any use of the licensor’s trademarks is subject
+      to applicable law.
+    - Canyon GBS LLC respects the intellectual property rights of others and expects the
+      same in return. Canyon GBS™ and Advising App™ are registered trademarks of
+      Canyon GBS LLC, and we are committed to enforcing and protecting our trademarks
+      vigorously.
+    - The software solution, including services, infrastructure, and code, is offered as a
+      Software as a Service (SaaS) by Canyon GBS LLC.
+    - Use of this software implies agreement to the license terms and conditions as stated
+      in the Elastic License 2.0.
+
+    For more information or inquiries please visit our website at
+    https://www.canyongbs.com or contact us via email at [email protected].
+
+</COPYRIGHT>
+*/
+
+namespace AdvisingApp\Prospect\Database\Factories;
+
+use AdvisingApp\Prospect\Models\Prospect;
+use AdvisingApp\Prospect\Models\ProspectEmailAddress;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends Factory<ProspectEmailAddress>
+ */
+class ProspectEmailAddressFactory extends Factory
+{
+    private int $maxOrder;
+
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'prospect_id' => Prospect::factory(),
+            'address' => fake()->email(),
+            'type' => fake()->randomElement(['School', 'Personal', 'Work']),
+            'order' => $this->getNewOrder(),
+        ];
+    }
+
+    public function getNewOrder(): int
+    {
+        return $this->maxOrder = $this->getMaxOrder() + 1;
+    }
+
+    public function getMaxOrder(): int
+    {
+        return $this->maxOrder ??= ProspectEmailAddress::max('order') ?? 0;
+    }
+}

app-modules/prospect/database/factories/ProspectPhoneNumberFactory.php

@@ -0,0 +1,103 @@
+<?php
+
+/*
+<COPYRIGHT>
+
+    Copyright © 2016-2025, Canyon GBS LLC. All rights reserved.
+
+    Advising App™ is licensed under the Elastic License 2.0. For more details,
+    see https://github.com/canyongbs/advisingapp/blob/main/LICENSE.
+
+    Notice:
+
+    - You may not provide the software to third parties as a hosted or managed
+      service, where the service provides users with access to any substantial set of
+      the features or functionality of the software.
+    - You may not move, change, disable, or circumvent the license key functionality
+      in the software, and you may not remove or obscure any functionality in the
+      software that is protected by the license key.
+    - You may not alter, remove, or obscure any licensing, copyright, or other notices
+      of the licensor in the software. Any use of the licensor’s trademarks is subject
+      to applicable law.
+    - Canyon GBS LLC respects the intellectual property rights of others and expects the
+      same in return. Canyon GBS™ and Advising App™ are registered trademarks of
+      Canyon GBS LLC, and we are committed to enforcing and protecting our trademarks
+      vigorously.
+    - The software solution, including services, infrastructure, and code, is offered as a
+      Software as a Service (SaaS) by Canyon GBS LLC.
+    - Use of this software implies agreement to the license terms and conditions as stated
+      in the Elastic License 2.0.
+
+    For more information or inquiries please visit our website at
+    https://www.canyongbs.com or contact us via email at [email protected].
+
+</COPYRIGHT>
+*/
+
+namespace AdvisingApp\Prospect\Database\Factories;
+
+use AdvisingApp\Prospect\Models\Prospect;
+use AdvisingApp\Prospect\Models\ProspectPhoneNumber;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends Factory<ProspectPhoneNumber>
+ */
+class ProspectPhoneNumberFactory extends Factory
+{
+    private int $maxOrder;
+
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'prospect_id' => Prospect::factory(),
+            'number' => fake()->phoneNumber(),
+            'ext' => null,
+            'type' => fake()->randomElement(['Home', 'Mobile', 'Work']),
+            'can_recieve_sms' => fake()->boolean(),
+            'order' => $this->getNewOrder(),
+        ];
+    }
+
+    public function canNotRecieveSms(): Factory
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'can_recieve_sms' => false,
+            ];
+        });
+    }
+
+    public function canRecieveSms(): Factory
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'can_recieve_sms' => true,
+            ];
+        });
+    }
+
+    public function withExtension(): Factory
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'ext' => fake()->randomNumber(),
+            ];
+        });
+    }
+
+    public function getNewOrder(): int
+    {
+        return $this->maxOrder = $this->getMaxOrder() + 1;
+    }
+
+    public function getMaxOrder(): int
+    {
+        return $this->maxOrder ??= ProspectPhoneNumber::max('order') ?? 0;
+    }
+}

app-modules/prospect/database/migrations/2025_02_04_142318_create_prospect_addresses_table.php

@@ -0,0 +1,66 @@
+<?php
+
+/*
+<COPYRIGHT>
+
+    Copyright © 2016-2025, Canyon GBS LLC. All rights reserved.
+
+    Advising App™ is licensed under the Elastic License 2.0. For more details,
+    see https://github.com/canyongbs/advisingapp/blob/main/LICENSE.
+
+    Notice:
+
+    - You may not provide the software to third parties as a hosted or managed
+      service, where the service provides users with access to any substantial set of
+      the features or functionality of the software.
+    - You may not move, change, disable, or circumvent the license key functionality
+      in the software, and you may not remove or obscure any functionality in the
+      software that is protected by the license key.
+    - You may not alter, remove, or obscure any licensing, copyright, or other notices
+      of the licensor in the software. Any use of the licensor’s trademarks is subject
+      to applicable law.
+    - Canyon GBS LLC respects the intellectual property rights of others and expects the
+      same in return. Canyon GBS™ and Advising App™ are registered trademarks of
+      Canyon GBS LLC, and we are committed to enforcing and protecting our trademarks
+      vigorously.
+    - The software solution, including services, infrastructure, and code, is offered as a
+      Software as a Service (SaaS) by Canyon GBS LLC.
+    - Use of this software implies agreement to the license terms and conditions as stated
+      in the Elastic License 2.0.
+
+    For more information or inquiries please visit our website at
+    https://www.canyongbs.com or contact us via email at [email protected].
+
+</COPYRIGHT>
+*/
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class () extends Migration {
+    public function up(): void
+    {
+        Schema::create('prospect_addresses', function (Blueprint $table) {
+            $table->uuid('id')->primary();
+            $table->foreignUuid('prospect_id')->constrained('prospects')->onDelete('cascade');
+            $table->string('line_1')->nullable();
+            $table->string('line_2')->nullable();
+            $table->string('line_3')->nullable();
+            $table->string('city')->nullable();
+            $table->string('state')->nullable();
+            $table->string('postal')->nullable();
+            $table->string('country')->nullable();
+            $table->string('type')->nullable();
+            $table->integer('order');
+            $table->timestamps();
+
+            $table->index(['prospect_id', 'order']);
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('prospect_addresses');
+    }
+};