melabidi/alrahma_sunday_school_api
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

add inventory and supply logic

Browse Source
This commit is contained in:
root
2026-03-10 18:21:08 -04:00
parent 17d73e2f92
commit 25e7b3c67c
62 changed files with 3846 additions and 2781 deletions
Download Patch File Download Diff File Expand all files Collapse all files
tests/Feature/Api/V1/Inventory/InventoryCategoriesControllerTest.php
+109
View File
@@ -0,0 +1,109 @@
<?php
namespace Tests\Feature\Api\V1\Inventory;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\DB;
use Laravel\Sanctum\Sanctum;
use Tests\TestCase;
class InventoryCategoriesControllerTest extends TestCase
{
use RefreshDatabase;
public function test_index_returns_categories(): void
{
$user = $this->seedUser();
$this->seedCategory('classroom');
Sanctum::actingAs($user);
$response = $this->getJson('/api/v1/inventory/categories?type=classroom');
$response->assertOk();
$response->assertJsonPath('status', true);
$this->assertNotEmpty($response->json('data.categories'));
}
public function test_store_creates_category(): void
{
$user = $this->seedUser();
Sanctum::actingAs($user);
$response = $this->postJson('/api/v1/inventory/categories', [
'type' => 'office',
'name' => 'Supplies',
]);
$response->assertStatus(201);
$this->assertDatabaseHas('inventory_categories', ['name' => 'Supplies']);
}
public function test_update_changes_category(): void
{
$user = $this->seedUser();
$categoryId = $this->seedCategory('office');
Sanctum::actingAs($user);
$response = $this->patchJson('/api/v1/inventory/categories/' . $categoryId, [
'name' => 'Updated',
]);
$response->assertOk();
$this->assertDatabaseHas('inventory_categories', ['id' => $categoryId, 'name' => 'Updated']);
}
public function test_destroy_deletes_category(): void
{
$user = $this->seedUser();
$categoryId = $this->seedCategory('office');
Sanctum::actingAs($user);
$response = $this->deleteJson('/api/v1/inventory/categories/' . $categoryId);
$response->assertOk();
$this->assertDatabaseMissing('inventory_categories', ['id' => $categoryId]);
}
public function test_validation_fails(): void
{
$user = $this->seedUser();
Sanctum::actingAs($user);
$response = $this->postJson('/api/v1/inventory/categories', []);
$response->assertStatus(422);
}
private function seedUser(): User
{
$userId = DB::table('users')->insertGetId([
'firstname' => 'User',
'lastname' => 'One',
'cellphone' => '9999999999',
'email' => 'user@example.com',
'address_street' => '123 Street',
'city' => 'City',
'state' => 'ST',
'zip' => '12345',
'accept_school_policy' => 1,
'password' => bcrypt('password'),
'user_type' => 'primary',
'semester' => 'Fall',
'school_year' => '2025-2026',
'status' => 'Active',
]);
return User::query()->findOrFail($userId);
}
private function seedCategory(string $type): int
{
return DB::table('inventory_categories')->insertGetId([
'type' => $type,
'name' => ucfirst($type) . ' Category',
'created_at' => now(),
'updated_at' => now(),
]);
}
}
tests/Feature/Api/V1/Inventory/InventoryItemsControllerTest.php
+339
View File
@@ -0,0 +1,339 @@
<?php
namespace Tests\Feature\Api\V1\Inventory;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\DB;
use Laravel\Sanctum\Sanctum;
use Tests\TestCase;
class InventoryItemsControllerTest extends TestCase
{
use RefreshDatabase;
public function test_index_returns_items(): void
{
$user = $this->seedUser();
$this->seedConfig();
$categoryId = $this->seedInventoryCategory('classroom');
$this->seedInventoryItem($categoryId);
Sanctum::actingAs($user);
$response = $this->getJson('/api/v1/inventory/items?type=classroom');
$response->assertOk();
$response->assertJsonPath('status', true);
$this->assertNotEmpty($response->json('data.items'));
}
public function test_show_returns_item(): void
{
$user = $this->seedUser();
$this->seedConfig();
$categoryId = $this->seedInventoryCategory('classroom');
$itemId = $this->seedInventoryItem($categoryId);
Sanctum::actingAs($user);
$response = $this->getJson('/api/v1/inventory/items/' . $itemId);
$response->assertOk();
$response->assertJsonPath('status', true);
$response->assertJsonPath('data.id', $itemId);
}
public function test_store_creates_item(): void
{
$user = $this->seedUser();
$this->seedConfig();
$categoryId = $this->seedInventoryCategory('classroom');
Sanctum::actingAs($user);
$response = $this->postJson('/api/v1/inventory/items', [
'type' => 'classroom',
'category_id' => $categoryId,
'name' => 'Markers',
'quantity' => 5,
'condition' => 'good',
]);
$response->assertStatus(201);
$this->assertDatabaseHas('inventory_items', ['name' => 'Markers']);
$this->assertDatabaseHas('inventory_movements', ['movement_type' => 'initial']);
}
public function test_update_changes_item(): void
{
$user = $this->seedUser();
$this->seedConfig();
$categoryId = $this->seedInventoryCategory('classroom');
$itemId = $this->seedInventoryItem($categoryId);
Sanctum::actingAs($user);
$response = $this->patchJson('/api/v1/inventory/items/' . $itemId, [
'name' => 'Updated Item',
]);
$response->assertOk();
$this->assertDatabaseHas('inventory_items', ['id' => $itemId, 'name' => 'Updated Item']);
}
public function test_destroy_deletes_item(): void
{
$user = $this->seedUser();
$this->seedConfig();
$categoryId = $this->seedInventoryCategory('classroom');
$itemId = $this->seedInventoryItem($categoryId);
Sanctum::actingAs($user);
$response = $this->deleteJson('/api/v1/inventory/items/' . $itemId);
$response->assertOk();
$this->assertDatabaseMissing('inventory_items', ['id' => $itemId]);
}
public function test_audit_updates_classroom_item(): void
{
$user = $this->seedUser();
$this->seedConfig();
$categoryId = $this->seedInventoryCategory('classroom');
$itemId = $this->seedInventoryItem($categoryId);
Sanctum::actingAs($user);
$response = $this->postJson('/api/v1/inventory/items/' . $itemId . '/audit', [
'needs_repair_qty' => 1,
'need_replace_qty' => 1,
'cannot_find_qty' => 0,
]);
$response->assertOk();
$this->assertDatabaseHas('inventory_items', ['id' => $itemId, 'needs_repair_qty' => 1]);
}
public function test_adjust_creates_movement(): void
{
$user = $this->seedUser();
$this->seedConfig();
$categoryId = $this->seedInventoryCategory('classroom');
$itemId = $this->seedInventoryItem($categoryId, 0);
Sanctum::actingAs($user);
$response = $this->postJson('/api/v1/inventory/items/' . $itemId . '/adjust', [
'mode' => 'in',
'quantity' => 2,
'reason' => 'Restock',
]);
$response->assertOk();
$this->assertDatabaseHas('inventory_movements', ['item_id' => $itemId, 'movement_type' => 'in']);
}
public function test_summary_returns_aggregates(): void
{
$user = $this->seedUser();
$this->seedConfig();
$categoryId = $this->seedInventoryCategory('classroom');
$this->seedInventoryItem($categoryId);
Sanctum::actingAs($user);
$response = $this->getJson('/api/v1/inventory/summary/classroom');
$response->assertOk();
$response->assertJsonPath('status', true);
$this->assertNotEmpty($response->json('data.items'));
}
public function test_summary_all_returns_rows(): void
{
$user = $this->seedUser();
$this->seedConfig();
$categoryId = $this->seedInventoryCategory('classroom');
$this->seedInventoryItem($categoryId);
Sanctum::actingAs($user);
$response = $this->getJson('/api/v1/inventory/summary-all');
$response->assertOk();
$response->assertJsonPath('status', true);
}
public function test_teacher_distribution_endpoints(): void
{
$user = $this->seedUser();
$this->seedConfig();
$this->seedTeacherRole($user->id);
$classSectionId = $this->seedClassSection();
$this->seedTeacherClass($user->id, $classSectionId);
$studentId = $this->seedStudent(100, $user->id);
$this->seedStudentClass($studentId, $classSectionId);
$categoryId = $this->seedInventoryCategory('book');
$bookId = $this->seedInventoryItem($categoryId, 5, 'book');
Sanctum::actingAs($user);
$formResponse = $this->getJson('/api/v1/inventory/teacher-distribution?class_section_id=' . $classSectionId . '&item_id=' . $bookId);
$formResponse->assertOk();
$storeResponse = $this->postJson('/api/v1/inventory/teacher-distribution', [
'item_id' => $bookId,
'class_section_id' => $classSectionId,
'student_ids' => [$studentId],
]);
$storeResponse->assertOk();
$this->assertDatabaseHas('inventory_movements', ['item_id' => $bookId, 'movement_type' => 'distribution']);
}
public function test_validation_fails_for_store(): void
{
$user = $this->seedUser();
Sanctum::actingAs($user);
$response = $this->postJson('/api/v1/inventory/items', []);
$response->assertStatus(422);
$response->assertJsonPath('message', 'Validation failed.');
}
public function test_requires_authentication(): void
{
$response = $this->getJson('/api/v1/inventory/items');
$response->assertStatus(401);
}
private function seedConfig(): void
{
DB::table('configuration')->insert([
['config_key' => 'school_year', 'config_value' => '2025-2026'],
['config_key' => 'semester', 'config_value' => 'Fall'],
]);
}
private function seedUser(): User
{
$userId = DB::table('users')->insertGetId([
'firstname' => 'Teacher',
'lastname' => 'User',
'cellphone' => '9999999999',
'email' => 'teacher@example.com',
'address_street' => '123 Street',
'city' => 'City',
'state' => 'ST',
'zip' => '12345',
'accept_school_policy' => 1,
'password' => bcrypt('password'),
'user_type' => 'primary',
'semester' => 'Fall',
'school_year' => '2025-2026',
'status' => 'Active',
]);
return User::query()->findOrFail($userId);
}
private function seedInventoryCategory(string $type): int
{
return DB::table('inventory_categories')->insertGetId([
'type' => $type,
'name' => ucfirst($type) . ' Category',
'created_at' => now(),
'updated_at' => now(),
]);
}
private function seedInventoryItem(int $categoryId, int $quantity = 3, string $type = 'classroom'): int
{
return DB::table('inventory_items')->insertGetId([
'type' => $type,
'category_id' => $categoryId,
'name' => 'Item ' . $type,
'quantity' => $quantity,
'semester' => 'Fall',
'school_year' => '2025-2026',
'created_at' => now(),
'updated_at' => now(),
]);
}
private function seedTeacherRole(int $userId): void
{
$roleId = DB::table('roles')->insertGetId([
'name' => 'teacher',
'dashboard_route' => 'teacher',
'priority' => 1,
'is_active' => 1,
]);
DB::table('user_roles')->insert([
'user_id' => $userId,
'role_id' => $roleId,
'created_at' => now(),
'updated_at' => now(),
]);
}
private function seedClassSection(): int
{
DB::table('classes')->insert([
'id' => 1,
'class_name' => 'Grade 1',
'created_at' => now(),
'updated_at' => now(),
]);
DB::table('classSection')->insert([
'class_section_id' => 200,
'class_section_name' => 'Grade 1',
'class_id' => 1,
'semester' => 'Fall',
'school_year' => '2025-2026',
'created_at' => now(),
'updated_at' => now(),
]);
return 200;
}
private function seedTeacherClass(int $userId, int $classSectionId): void
{
DB::table('teacher_class')->insert([
'teacher_id' => $userId,
'class_section_id' => $classSectionId,
'position' => 'main',
'school_year' => '2025-2026',
'created_at' => now(),
'updated_at' => now(),
]);
}
private function seedStudent(int $id, int $parentId): int
{
DB::table('students')->insert([
'id' => $id,
'school_id' => 'SCH1',
'firstname' => 'Student',
'lastname' => 'One',
'age' => 10,
'gender' => 'Male',
'photo_consent' => 1,
'parent_id' => $parentId,
'year_of_registration' => '2025-2026',
'semester' => 'Fall',
'school_year' => '2025-2026',
'is_active' => 1,
]);
return $id;
}
private function seedStudentClass(int $studentId, int $classSectionId): void
{
DB::table('student_class')->insert([
'student_id' => $studentId,
'class_section_id' => $classSectionId,
'school_year' => '2025-2026',
'semester' => 'Fall',
'is_event_only' => 0,
'created_at' => now(),
'updated_at' => now(),
]);
}
}
tests/Feature/Api/V1/Inventory/InventoryMovementsControllerTest.php
+146
View File
@@ -0,0 +1,146 @@
<?php
namespace Tests\Feature\Api\V1\Inventory;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\DB;
use Laravel\Sanctum\Sanctum;
use Tests\TestCase;
class InventoryMovementsControllerTest extends TestCase
{
use RefreshDatabase;
public function test_index_returns_movements(): void
{
$user = $this->seedUser();
$itemId = $this->seedItem();
$this->seedMovement($itemId);
Sanctum::actingAs($user);
$response = $this->getJson('/api/v1/inventory/movements');
$response->assertOk();
$response->assertJsonPath('status', true);
$this->assertNotEmpty($response->json('data.movements'));
}
public function test_store_creates_movement(): void
{
$user = $this->seedUser();
$itemId = $this->seedItem();
Sanctum::actingAs($user);
$response = $this->postJson('/api/v1/inventory/movements', [
'item_id' => $itemId,
'qty_change' => 2,
'movement_type' => 'in',
]);
$response->assertStatus(201);
$this->assertDatabaseHas('inventory_movements', ['item_id' => $itemId, 'movement_type' => 'in']);
}
public function test_update_changes_movement(): void
{
$user = $this->seedUser();
$itemId = $this->seedItem();
$movementId = $this->seedMovement($itemId);
Sanctum::actingAs($user);
$response = $this->patchJson('/api/v1/inventory/movements/' . $movementId, [
'qty_change' => 3,
'movement_type' => 'in',
]);
$response->assertOk();
$this->assertDatabaseHas('inventory_movements', ['id' => $movementId, 'qty_change' => 3]);
}
public function test_destroy_deletes_movement(): void
{
$user = $this->seedUser();
$itemId = $this->seedItem();
$movementId = $this->seedMovement($itemId);
Sanctum::actingAs($user);
$response = $this->deleteJson('/api/v1/inventory/movements/' . $movementId);
$response->assertOk();
$this->assertDatabaseMissing('inventory_movements', ['id' => $movementId]);
}
public function test_bulk_delete_removes_movements(): void
{
$user = $this->seedUser();
$itemId = $this->seedItem();
$first = $this->seedMovement($itemId);
$second = $this->seedMovement($itemId);
Sanctum::actingAs($user);
$response = $this->postJson('/api/v1/inventory/movements/bulk-delete', [
'ids' => [$first, $second],
]);
$response->assertOk();
$this->assertDatabaseMissing('inventory_movements', ['id' => $first]);
$this->assertDatabaseMissing('inventory_movements', ['id' => $second]);
}
private function seedUser(): User
{
$userId = DB::table('users')->insertGetId([
'firstname' => 'User',
'lastname' => 'One',
'cellphone' => '9999999999',
'email' => 'movement@example.com',
'address_street' => '123 Street',
'city' => 'City',
'state' => 'ST',
'zip' => '12345',
'accept_school_policy' => 1,
'password' => bcrypt('password'),
'user_type' => 'primary',
'semester' => 'Fall',
'school_year' => '2025-2026',
'status' => 'Active',
]);
return User::query()->findOrFail($userId);
}
private function seedItem(): int
{
$categoryId = DB::table('inventory_categories')->insertGetId([
'type' => 'office',
'name' => 'Office',
'created_at' => now(),
'updated_at' => now(),
]);
return DB::table('inventory_items')->insertGetId([
'type' => 'office',
'category_id' => $categoryId,
'name' => 'Printer',
'quantity' => 10,
'semester' => 'Fall',
'school_year' => '2025-2026',
'created_at' => now(),
'updated_at' => now(),
]);
}
private function seedMovement(int $itemId): int
{
return DB::table('inventory_movements')->insertGetId([
'item_id' => $itemId,
'qty_change' => 1,
'movement_type' => 'in',
'semester' => 'Fall',
'school_year' => '2025-2026',
'created_at' => now(),
'updated_at' => now(),
]);
}
}
tests/Feature/Api/V1/Inventory/SuppliersControllerTest.php
+98
View File
@@ -0,0 +1,98 @@
<?php
namespace Tests\Feature\Api\V1\Inventory;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\DB;
use Laravel\Sanctum\Sanctum;
use Tests\TestCase;
class SuppliersControllerTest extends TestCase
{
use RefreshDatabase;
public function test_index_returns_suppliers(): void
{
$user = $this->seedUser();
$this->seedSupplier('Supplier A');
Sanctum::actingAs($user);
$response = $this->getJson('/api/v1/inventory/suppliers');
$response->assertOk();
$response->assertJsonPath('status', true);
$this->assertNotEmpty($response->json('data.suppliers'));
}
public function test_store_creates_supplier(): void
{
$user = $this->seedUser();
Sanctum::actingAs($user);
$response = $this->postJson('/api/v1/inventory/suppliers', [
'name' => 'Supplier B',
'email' => 'b@example.com',
]);
$response->assertStatus(201);
$this->assertDatabaseHas('suppliers', ['name' => 'Supplier B']);
}
public function test_update_changes_supplier(): void
{
$user = $this->seedUser();
$supplierId = $this->seedSupplier('Supplier C');
Sanctum::actingAs($user);
$response = $this->patchJson('/api/v1/inventory/suppliers/' . $supplierId, [
'name' => 'Supplier Updated',
]);
$response->assertOk();
$this->assertDatabaseHas('suppliers', ['id' => $supplierId, 'name' => 'Supplier Updated']);
}
public function test_destroy_deletes_supplier(): void
{
$user = $this->seedUser();
$supplierId = $this->seedSupplier('Supplier D');
Sanctum::actingAs($user);
$response = $this->deleteJson('/api/v1/inventory/suppliers/' . $supplierId);
$response->assertOk();
$this->assertDatabaseMissing('suppliers', ['id' => $supplierId]);
}
private function seedUser(): User
{
$userId = DB::table('users')->insertGetId([
'firstname' => 'User',
'lastname' => 'One',
'cellphone' => '9999999999',
'email' => 'supplier@example.com',
'address_street' => '123 Street',
'city' => 'City',
'state' => 'ST',
'zip' => '12345',
'accept_school_policy' => 1,
'password' => bcrypt('password'),
'user_type' => 'primary',
'semester' => 'Fall',
'school_year' => '2025-2026',
'status' => 'Active',
]);
return User::query()->findOrFail($userId);
}
private function seedSupplier(string $name): int
{
return DB::table('suppliers')->insertGetId([
'name' => $name,
'created_at' => now(),
'updated_at' => now(),
]);
}
}
tests/Feature/Api/V1/Inventory/SupplyCategoriesControllerTest.php
+97
View File
@@ -0,0 +1,97 @@
<?php
namespace Tests\Feature\Api\V1\Inventory;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\DB;
use Laravel\Sanctum\Sanctum;
use Tests\TestCase;
class SupplyCategoriesControllerTest extends TestCase
{
use RefreshDatabase;
public function test_index_returns_categories(): void
{
$user = $this->seedUser();
$this->seedCategory('Paper');
Sanctum::actingAs($user);
$response = $this->getJson('/api/v1/inventory/supply-categories');
$response->assertOk();
$response->assertJsonPath('status', true);
$this->assertNotEmpty($response->json('data.categories'));
}
public function test_store_creates_category(): void
{
$user = $this->seedUser();
Sanctum::actingAs($user);
$response = $this->postJson('/api/v1/inventory/supply-categories', [
'name' => 'Cleaning',
]);
$response->assertStatus(201);
$this->assertDatabaseHas('supply_categories', ['name' => 'Cleaning']);
}
public function test_update_changes_category(): void
{
$user = $this->seedUser();
$categoryId = $this->seedCategory('Pens');
Sanctum::actingAs($user);
$response = $this->patchJson('/api/v1/inventory/supply-categories/' . $categoryId, [
'name' => 'Pens Updated',
]);
$response->assertOk();
$this->assertDatabaseHas('supply_categories', ['id' => $categoryId, 'name' => 'Pens Updated']);
}
public function test_destroy_deletes_category(): void
{
$user = $this->seedUser();
$categoryId = $this->seedCategory('Markers');
Sanctum::actingAs($user);
$response = $this->deleteJson('/api/v1/inventory/supply-categories/' . $categoryId);
$response->assertOk();
$this->assertDatabaseMissing('supply_categories', ['id' => $categoryId]);
}
private function seedUser(): User
{
$userId = DB::table('users')->insertGetId([
'firstname' => 'User',
'lastname' => 'One',
'cellphone' => '9999999999',
'email' => 'supply@example.com',
'address_street' => '123 Street',
'city' => 'City',
'state' => 'ST',
'zip' => '12345',
'accept_school_policy' => 1,
'password' => bcrypt('password'),
'user_type' => 'primary',
'semester' => 'Fall',
'school_year' => '2025-2026',
'status' => 'Active',
]);
return User::query()->findOrFail($userId);
}
private function seedCategory(string $name): int
{
return DB::table('supply_categories')->insertGetId([
'name' => $name,
'created_at' => now(),
'updated_at' => now(),
]);
}
}