Files
GSB-Construction/tests/Feature/ProjectWizardFlowTest.php
Ajjj 10eb7be033
Some checks failed
Tests / PHP 8.3 (push) Has been cancelled
Tests / PHP 8.4 (push) Has been cancelled
Tests / PHP 8.5 (push) Has been cancelled
feat: implement module API routes, controllers, and comprehensive system testing with role-based access control
2026-08-06 19:38:51 +08:00

621 lines
23 KiB
PHP

<?php
namespace Tests\Feature;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Modules\Equipments\Models\Equipment;
use Modules\Labors\Models\Labor;
use Modules\MasterData\Models\Material;
use Modules\ProjectManagement\Models\Project;
use Modules\ProjectManagement\Models\ProjectMilestone;
use Modules\ProjectManagement\Models\Task;
use Spatie\Permission\Models\Role;
use Tests\TestCase;
class ProjectWizardFlowTest extends TestCase
{
use RefreshDatabase;
protected User $admin;
protected function setUp(): void
{
parent::setUp();
Role::firstOrCreate(['name' => 'Super Admin', 'guard_name' => 'web']);
$this->admin = User::factory()->create([
'user_type' => 'admin',
'status' => 'active',
]);
$this->admin->assignRole('Super Admin');
$permission = \Spatie\Permission\Models\Permission::firstOrCreate([
'name' => 'projects.access',
'guard_name' => 'web',
]);
$this->admin->givePermissionTo($permission);
}
// ─── STEP 1: Project Create/Store ────────────────────────────────────────
/** @test */
public function guest_cannot_access_project_create(): void
{
$this->get(route('projects.create'))->assertRedirect(route('login'));
}
/** @test */
public function admin_can_view_project_create_page(): void
{
$this->actingAs($this->admin)
->get(route('projects.create'))
->assertOk()
->assertInertia(fn ($page) => $page->component('ProjectManagement::Projects/Create', false));
}
/** @test */
public function project_store_fails_without_name(): void
{
$this->actingAs($this->admin)
->post(route('projects.store'), ['name' => '', 'project_type' => 'standard'])
->assertSessionHasErrors('name');
}
/** @test */
public function project_store_fails_without_project_type(): void
{
$this->actingAs($this->admin)
->post(route('projects.store'), ['name' => 'Test', 'project_type' => ''])
->assertSessionHasErrors('project_type');
}
/** @test */
public function project_store_fails_with_invalid_project_type(): void
{
$this->actingAs($this->admin)
->post(route('projects.store'), ['name' => 'Test', 'project_type' => 'invalid'])
->assertSessionHasErrors('project_type');
}
/** @test */
public function project_store_fails_when_end_date_before_start_date(): void
{
$this->actingAs($this->admin)
->post(route('projects.store'), [
'name' => 'Date Test',
'project_type' => 'standard',
'start_date' => '2025-12-31',
'target_end_date' => '2025-01-01',
])
->assertSessionHasErrors('target_end_date');
}
/** @test */
public function project_store_succeeds_with_minimum_fields(): void
{
$this->actingAs($this->admin)
->post(route('projects.store'), [
'name' => 'Minimal Project',
'project_type' => 'standard',
]);
$project = Project::where('name', 'Minimal Project')->first();
$this->assertNotNull($project);
$this->assertEquals(2, $project->current_wizard_step);
}
/** @test */
public function project_store_auto_generates_code(): void
{
$this->actingAs($this->admin)
->post(route('projects.store'), [
'name' => 'Code Project',
'project_type' => 'standard',
]);
$project = Project::where('name', 'Code Project')->first();
$this->assertStringStartsWith('PRJ-' . now()->year . '-', $project->code);
}
/** @test */
public function project_codes_are_unique_and_sequential(): void
{
$this->actingAs($this->admin)->post(route('projects.store'), ['name' => 'P1', 'project_type' => 'standard']);
$this->actingAs($this->admin)->post(route('projects.store'), ['name' => 'P2', 'project_type' => 'standard']);
$c1 = Project::where('name', 'P1')->value('code');
$c2 = Project::where('name', 'P2')->value('code');
$this->assertNotEquals($c1, $c2);
$this->assertStringStartsWith('PRJ-', $c1);
}
/** @test */
public function project_store_saves_all_optional_fields(): void
{
$this->actingAs($this->admin)->post(route('projects.store'), [
'name' => 'Full Project',
'client_name' => 'Acme Corp',
'description' => 'Desc',
'location' => 'Manila',
'contract_value' => 5000000,
'contract_duration' => 365,
'start_date' => '2025-01-01',
'target_end_date' => '2025-12-31',
'project_type' => 'standard',
'is_unprofitable' => false,
]);
$project = Project::where('name', 'Full Project')->first();
$this->assertEquals('Acme Corp', $project->client_name);
$this->assertEquals(5000000, $project->contract_value);
}
// ─── STEP 2: Milestones & Tasks ──────────────────────────────────────────
/** @test */
public function save_tasks_fails_with_empty_milestone_name(): void
{
$project = Project::factory()->create(['current_wizard_step' => 2]);
$this->actingAs($this->admin)
->post(route('projects.wizard.tasks', $project), [
'milestones' => [['name' => '', 'weight_percentage' => 50]],
])
->assertSessionHasErrors('milestones.0.name');
}
/** @test */
public function save_tasks_fails_with_milestone_weight_over_100(): void
{
$project = Project::factory()->create(['current_wizard_step' => 2]);
$this->actingAs($this->admin)
->post(route('projects.wizard.tasks', $project), [
'milestones' => [['name' => 'Phase 1', 'weight_percentage' => 150]],
])
->assertSessionHasErrors('milestones.0.weight_percentage');
}
/** @test */
public function save_tasks_fails_with_empty_task_name(): void
{
$project = Project::factory()->create(['current_wizard_step' => 2]);
$this->actingAs($this->admin)
->post(route('projects.wizard.tasks', $project), [
'tasks' => [['name' => '']],
])
->assertSessionHasErrors('tasks.0.name');
}
/** @test */
public function save_tasks_with_empty_arrays_advances_step(): void
{
$project = Project::factory()->create(['current_wizard_step' => 2]);
$this->actingAs($this->admin)
->post(route('projects.wizard.tasks', $project), ['milestones' => [], 'tasks' => []])
->assertRedirect(route('projects.wizard', [$project, 'step' => 3]));
$this->assertEquals(3, $project->fresh()->current_wizard_step);
}
/** @test */
public function save_tasks_does_not_downgrade_already_advanced_step(): void
{
$project = Project::factory()->create(['current_wizard_step' => 5]);
$this->actingAs($this->admin)
->post(route('projects.wizard.tasks', $project), ['milestones' => [], 'tasks' => []]);
$this->assertEquals(5, $project->fresh()->current_wizard_step);
}
/** @test */
public function save_tasks_prepopulates_8_default_milestones(): void
{
$project = Project::factory()->create([
'current_wizard_step' => 2,
'start_date' => '2025-01-01',
'contract_duration' => 365,
]);
$this->actingAs($this->admin)
->post(route('projects.wizard.tasks', $project), ['prepopulate_milestones' => true]);
$this->assertEquals(8, $project->milestones()->count());
}
/** @test */
public function save_tasks_creates_milestones_and_tasks(): void
{
$project = Project::factory()->create(['current_wizard_step' => 2]);
$this->actingAs($this->admin)->post(route('projects.wizard.tasks', $project), [
'milestones' => [['name' => 'Phase 1', 'weight_percentage' => 100]],
'tasks' => [['name' => 'Task A', 'description' => 'First task']],
]);
$this->assertEquals(1, $project->milestones()->count());
$this->assertEquals(1, $project->tasks()->count());
}
// ─── STEP 3: Material Estimates ──────────────────────────────────────────
/** @test */
public function save_estimates_fails_without_material_ulid(): void
{
$project = Project::factory()->create(['current_wizard_step' => 3]);
$this->actingAs($this->admin)
->post(route('projects.wizard.estimates', $project), [
'estimates' => [['material_ulid' => '', 'estimated_qty' => 10, 'unit_cost' => 100]],
])
->assertSessionHasErrors('estimates.0.material_ulid');
}
/** @test */
public function save_estimates_fails_with_negative_quantity(): void
{
$project = Project::factory()->create(['current_wizard_step' => 3]);
$material = Material::factory()->create(['type' => 'single', 'status' => 'active']);
$this->actingAs($this->admin)
->post(route('projects.wizard.estimates', $project), [
'estimates' => [['material_ulid' => $material->ulid, 'estimated_qty' => -5, 'unit_cost' => 100]],
])
->assertSessionHasErrors('estimates.0.estimated_qty');
}
/** @test */
public function save_estimates_with_empty_array_advances_step(): void
{
$project = Project::factory()->create(['current_wizard_step' => 3]);
$this->actingAs($this->admin)
->post(route('projects.wizard.estimates', $project), ['estimates' => []])
->assertRedirect(route('projects.wizard', [$project, 'step' => 4]));
$this->assertEquals(4, $project->fresh()->current_wizard_step);
}
/** @test */
public function save_estimates_creates_material_estimate_record(): void
{
$project = Project::factory()->create(['current_wizard_step' => 3]);
$material = Material::factory()->create(['type' => 'single', 'status' => 'active']);
$this->actingAs($this->admin)->post(route('projects.wizard.estimates', $project), [
'estimates' => [['material_ulid' => $material->ulid, 'estimated_qty' => 10, 'unit_cost' => 250.00]],
]);
$this->assertEquals(1, $project->materialsEstimates()->count());
$est = $project->materialsEstimates()->first();
$this->assertEquals(10, $est->estimated_qty);
$this->assertEquals(250.00, $est->unit_cost);
}
// ─── STEP 4: Labor Allocation ────────────────────────────────────────────
/** @test */
public function save_labor_fails_without_task_ulid(): void
{
$project = Project::factory()->create(['current_wizard_step' => 4]);
$this->actingAs($this->admin)
->post(route('projects.wizard.labor', $project), [
'labor' => [['task_ulid' => '', 'labor_ulid' => 'x', 'estimated_hours' => 8]],
])
->assertSessionHasErrors('labor.0.task_ulid');
}
/** @test */
public function save_labor_fails_with_negative_hours(): void
{
$project = Project::factory()->create(['current_wizard_step' => 4]);
$task = Task::factory()->create(['project_id' => $project->id]);
$labor = Labor::factory()->create(['status' => 'active']);
$this->actingAs($this->admin)
->post(route('projects.wizard.labor', $project), [
'labor' => [['task_ulid' => $task->ulid, 'labor_ulid' => $labor->ulid, 'estimated_hours' => -2]],
])
->assertSessionHasErrors('labor.0.estimated_hours');
}
/** @test */
public function save_labor_with_empty_array_advances_step(): void
{
$project = Project::factory()->create(['current_wizard_step' => 4]);
$this->actingAs($this->admin)
->post(route('projects.wizard.labor', $project), ['labor' => []])
->assertRedirect(route('projects.wizard', [$project, 'step' => 5]));
$this->assertEquals(5, $project->fresh()->current_wizard_step);
}
// ─── STEP 5: Equipment Allocation ────────────────────────────────────────
/** @test */
public function save_equipment_fails_without_equipment_ulid(): void
{
$project = Project::factory()->create(['current_wizard_step' => 5]);
$this->actingAs($this->admin)
->post(route('projects.wizard.equipment', $project), [
'equipment' => [['task_ulid' => 'x', 'equipment_ulid' => '', 'estimated_hours' => 4]],
])
->assertSessionHasErrors('equipment.0.equipment_ulid');
}
/** @test */
public function save_equipment_with_empty_array_advances_step(): void
{
$project = Project::factory()->create(['current_wizard_step' => 5]);
$this->actingAs($this->admin)
->post(route('projects.wizard.equipment', $project), ['equipment' => []])
->assertRedirect(route('projects.wizard', [$project, 'step' => 6]));
$this->assertEquals(6, $project->fresh()->current_wizard_step);
}
// ─── STEP 6: Submit for Approval ─────────────────────────────────────────
/** @test */
public function submit_without_explicit_approvers_autoselects_approver(): void
{
$project = Project::factory()->create(['current_wizard_step' => 6]);
$this->actingAs($this->admin)
->post(route('projects.wizard.submit', $project), ['approver_ids' => []])
->assertRedirect(route('projects.show', $project));
}
/** @test */
public function submit_advances_step_to_7(): void
{
$project = Project::factory()->create(['current_wizard_step' => 6]);
$approver = User::factory()->create(['user_type' => 'admin', 'status' => 'active']);
$this->actingAs($this->admin)
->post(route('projects.wizard.submit', $project), ['approver_ids' => [$approver->ulid]]);
$this->assertEquals(7, $project->fresh()->current_wizard_step);
}
// ─── Locked Project Guards (step >= 8) ───────────────────────────────────
/** @test */
public function locked_project_blocks_task_save(): void
{
$project = Project::factory()->create(['current_wizard_step' => 8]);
$this->actingAs($this->admin)
->post(route('projects.wizard.tasks', $project), ['milestones' => [], 'tasks' => []])
->assertSessionHas('error');
}
/** @test */
public function locked_project_blocks_estimate_save(): void
{
$project = Project::factory()->create(['current_wizard_step' => 8]);
$this->actingAs($this->admin)
->post(route('projects.wizard.estimates', $project), ['estimates' => []])
->assertSessionHas('error');
}
/** @test */
public function locked_project_blocks_labor_save(): void
{
$project = Project::factory()->create(['current_wizard_step' => 8]);
$this->actingAs($this->admin)
->post(route('projects.wizard.labor', $project), ['labor' => []])
->assertSessionHas('error');
}
/** @test */
public function locked_project_blocks_equipment_save(): void
{
$project = Project::factory()->create(['current_wizard_step' => 8]);
$this->actingAs($this->admin)
->post(route('projects.wizard.equipment', $project), ['equipment' => []])
->assertSessionHas('error');
}
/** @test */
public function locked_project_blocks_update(): void
{
$project = Project::factory()->create(['current_wizard_step' => 8]);
$this->actingAs($this->admin)
->put(route('projects.update', $project), ['name' => 'Changed', 'project_type' => 'standard'])
->assertSessionHas('error');
$this->assertNotEquals('Changed', $project->fresh()->name);
}
// ─── Project Index Visibility ─────────────────────────────────────────────
/** @test */
public function index_only_shows_completed_wizard_projects(): void
{
$active = Project::factory()->create(['current_wizard_step' => 7, 'status' => 'planning']);
Project::factory()->create(['current_wizard_step' => 3]);
$this->actingAs($this->admin)
->get(route('projects.index'))
->assertOk()
->assertInertia(fn ($page) => $page
->has('projects.data', 1)
->where('projects.data.0.id', $active->id)
);
}
/** @test */
public function drafts_shows_incomplete_wizard_projects(): void
{
$draft = Project::factory()->create(['current_wizard_step' => 3]);
$this->actingAs($this->admin)
->get(route('projects.index'))
->assertOk()
->assertInertia(fn ($page) => $page
->has('drafts', 1)
->where('drafts.0.id', $draft->id)
);
}
/** @test */
public function admin_can_discard_a_draft_project(): void
{
$draft = Project::factory()->create(['current_wizard_step' => 3]);
$this->actingAs($this->admin)
->delete(route('projects.discard', $draft))
->assertRedirect(route('projects.index'))
->assertSessionHas('success');
$this->assertSoftDeleted('projects', ['id' => $draft->id]);
}
/** @test */
public function completed_wizard_projects_cannot_be_discarded(): void
{
$project = Project::factory()->create(['current_wizard_step' => 7]);
$this->actingAs($this->admin)
->delete(route('projects.discard', $project))
->assertSessionHas('error');
$this->assertDatabaseHas('projects', ['id' => $project->id, 'deleted_at' => null]);
}
// ─── Status Transitions ──────────────────────────────────────────────────
/** @test */
public function cannot_start_project_without_pm(): void
{
$project = Project::factory()->create(['current_wizard_step' => 8, 'status' => 'planning']);
$this->actingAs($this->admin)
->patch(route('projects.transition', $project), ['status' => 'in_progress'])
->assertSessionHas('error');
}
/** @test */
public function can_start_project_with_pm_assigned(): void
{
$project = Project::factory()->create(['current_wizard_step' => 8, 'status' => 'planning']);
$pm = User::factory()->create(['user_type' => 'admin']);
$project->personnel()->attach($pm->id, ['role' => 'pm']);
$this->actingAs($this->admin)
->patch(route('projects.transition', $project), ['status' => 'in_progress']);
$this->assertEquals('in_progress', $project->fresh()->status->value);
}
/** @test */
public function cannot_complete_parent_with_active_children(): void
{
$parent = Project::factory()->create(['current_wizard_step' => 8, 'status' => 'in_progress']);
$pm = User::factory()->create();
$parent->personnel()->attach($pm->id, ['role' => 'pm']);
Project::factory()->create([
'parent_project_id' => $parent->id,
'current_wizard_step' => 8,
'status' => 'in_progress',
]);
$this->actingAs($this->admin)
->patch(route('projects.transition', $parent), ['status' => 'completed'])
->assertSessionHas('error');
$this->assertEquals('in_progress', $parent->fresh()->status->value);
}
// ─── Update Project ───────────────────────────────────────────────────────
/** @test */
public function update_succeeds_on_unlocked_project(): void
{
$project = Project::factory()->create(['current_wizard_step' => 5, 'status' => 'planning']);
$this->actingAs($this->admin)
->put(route('projects.update', $project), ['name' => 'New Name', 'project_type' => 'standard']);
$this->assertEquals('New Name', $project->fresh()->name);
}
// ─── Personnel Management ─────────────────────────────────────────────────
/** @test */
public function add_personnel_fails_with_nonexistent_user(): void
{
$project = Project::factory()->create(['current_wizard_step' => 7, 'status' => 'planning']);
$this->actingAs($this->admin)
->post(route('projects.personnel.add', $project), ['user_id' => 'bad-ulid', 'role' => 'pm'])
->assertSessionHas('error');
}
/** @test */
public function add_personnel_fails_with_invalid_role(): void
{
$project = Project::factory()->create(['current_wizard_step' => 7, 'status' => 'planning']);
$user = User::factory()->create();
$this->actingAs($this->admin)
->post(route('projects.personnel.add', $project), ['user_id' => $user->ulid, 'role' => 'bad_role'])
->assertSessionHasErrors('role');
}
/** @test */
public function add_personnel_fails_on_duplicate(): void
{
$project = Project::factory()->create(['current_wizard_step' => 7, 'status' => 'planning']);
$user = User::factory()->create();
$project->personnel()->attach($user->id, ['role' => 'member']);
$this->actingAs($this->admin)
->post(route('projects.personnel.add', $project), ['user_id' => $user->ulid, 'role' => 'member'])
->assertSessionHas('error');
}
/** @test */
public function can_remove_personnel(): void
{
$project = Project::factory()->create(['current_wizard_step' => 7, 'status' => 'planning']);
$user = User::factory()->create();
$project->personnel()->attach($user->id, ['role' => 'member']);
$this->actingAs($this->admin)
->delete(route('projects.personnel.remove', [$project, $user]));
$this->assertFalse($project->personnel()->where('user_id', $user->id)->exists());
}
// ─── Wizard Step Clamping ─────────────────────────────────────────────────
/** @test */
public function cannot_skip_ahead_wizard_steps(): void
{
$project = Project::factory()->create(['current_wizard_step' => 2]);
$this->actingAs($this->admin)
->get(route('projects.wizard', [$project, 'step' => 5]))
->assertOk()
->assertInertia(fn ($page) => $page->where('step', 2));
}
}