chore: add spec-kit and standardize signatures
- Added GitHub spec-kit for development workflow - Standardized file signatures to Descomplicar® format - Updated development configuration 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Emanuel Almeida
251
tests/contract/test-clinic-endpoints.php
Normal file
251
tests/contract/test-clinic-endpoints.php
Normal file
@@ -0,0 +1,251 @@
|
||||
/**
|
||||
* Descomplicar® Crescimento Digital
|
||||
* https://descomplicar.pt
|
||||
*/
|
||||
|
||||
<?php
|
||||
/**
|
||||
* Contract tests for Clinic endpoints.
|
||||
*
|
||||
* These tests define the API contract and MUST FAIL initially (TDD RED phase).
|
||||
*
|
||||
* @package KiviCare_API\Tests\Contract
|
||||
*/
|
||||
|
||||
/**
|
||||
* Clinic endpoints contract tests.
|
||||
*/
|
||||
class Test_Clinic_Endpoints_Contract extends KiviCare_API_Test_Case {
|
||||
|
||||
/**
|
||||
* Test GET /wp-json/kivicare/v1/clinics endpoint contract.
|
||||
*
|
||||
* @test
|
||||
*/
|
||||
public function test_get_clinics_endpoint_contract() {
|
||||
// This test will fail initially as the endpoint doesn't exist yet
|
||||
$this->markTestIncomplete( 'Clinics GET endpoint not implemented yet - TDD RED phase' );
|
||||
|
||||
// ARRANGE: Authenticated administrator
|
||||
wp_set_current_user( $this->admin_user );
|
||||
|
||||
// ACT: Make GET request to clinics endpoint
|
||||
$response = $this->make_request( '/wp-json/kivicare/v1/clinics' );
|
||||
|
||||
// ASSERT: Response contract
|
||||
$this->assertRestResponse( $response, 200 );
|
||||
|
||||
$data = $response->get_data();
|
||||
$this->assertIsArray( $data );
|
||||
|
||||
// Validate pagination structure
|
||||
if ( ! empty( $data ) ) {
|
||||
$this->assertArrayHasKey( 'data', $data );
|
||||
$this->assertArrayHasKey( 'total', $data );
|
||||
$this->assertArrayHasKey( 'page', $data );
|
||||
$this->assertArrayHasKey( 'per_page', $data );
|
||||
|
||||
// Validate clinic data structure
|
||||
$clinic = $data['data'][0];
|
||||
$this->assertClinicStructure( $clinic );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Test POST /wp-json/kivicare/v1/clinics endpoint contract.
|
||||
*
|
||||
* @test
|
||||
*/
|
||||
public function test_create_clinic_endpoint_contract() {
|
||||
// This test will fail initially as the endpoint doesn't exist yet
|
||||
$this->markTestIncomplete( 'Clinics POST endpoint not implemented yet - TDD RED phase' );
|
||||
|
||||
// ARRANGE: Valid clinic data
|
||||
$clinic_data = array(
|
||||
'name' => 'Nova Clínica',
|
||||
'email' => 'nova@clinica.com',
|
||||
'telephone_no' => '+351987654321',
|
||||
'address' => 'Rua Nova, 456',
|
||||
'city' => 'Porto',
|
||||
'state' => 'Porto',
|
||||
'country' => 'Portugal',
|
||||
'postal_code' => '4000-001',
|
||||
'specialties' => 'Cardiology,Neurology',
|
||||
);
|
||||
|
||||
// ACT: Make POST request as administrator
|
||||
$response = $this->make_request( '/wp-json/kivicare/v1/clinics', 'POST', $clinic_data, $this->admin_user );
|
||||
|
||||
// ASSERT: Response contract
|
||||
$this->assertRestResponse( $response, 201 );
|
||||
|
||||
$data = $response->get_data();
|
||||
$this->assertClinicStructure( $data );
|
||||
$this->assertEquals( $clinic_data['name'], $data['name'] );
|
||||
$this->assertEquals( $clinic_data['email'], $data['email'] );
|
||||
$this->assertIsInt( $data['id'] );
|
||||
$this->assertGreaterThan( 0, $data['id'] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Test POST /wp-json/kivicare/v1/clinics with invalid data.
|
||||
*
|
||||
* @test
|
||||
*/
|
||||
public function test_create_clinic_invalid_data() {
|
||||
// This test will fail initially as the endpoint doesn't exist yet
|
||||
$this->markTestIncomplete( 'Clinics POST validation not implemented yet - TDD RED phase' );
|
||||
|
||||
// ARRANGE: Invalid clinic data (missing required fields)
|
||||
$invalid_data = array(
|
||||
'name' => '', // Empty name should fail
|
||||
'email' => 'invalid-email', // Invalid email format
|
||||
);
|
||||
|
||||
// ACT: Make POST request with invalid data
|
||||
$response = $this->make_request( '/wp-json/kivicare/v1/clinics', 'POST', $invalid_data, $this->admin_user );
|
||||
|
||||
// ASSERT: Validation error contract
|
||||
$this->assertRestResponse( $response, 400 );
|
||||
|
||||
$data = $response->get_data();
|
||||
$this->assertArrayHasKey( 'code', $data );
|
||||
$this->assertEquals( 'rest_invalid_param', $data['code'] );
|
||||
$this->assertArrayHasKey( 'data', $data );
|
||||
$this->assertArrayHasKey( 'params', $data['data'] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Test GET /wp-json/kivicare/v1/clinics/{id} endpoint contract.
|
||||
*
|
||||
* @test
|
||||
*/
|
||||
public function test_get_clinic_by_id_endpoint_contract() {
|
||||
// This test will fail initially as the endpoint doesn't exist yet
|
||||
$this->markTestIncomplete( 'Clinic by ID endpoint not implemented yet - TDD RED phase' );
|
||||
|
||||
// ARRANGE: Existing clinic
|
||||
$clinic_id = $this->create_test_clinic();
|
||||
|
||||
// ACT: Make GET request for specific clinic
|
||||
$response = $this->make_request( "/wp-json/kivicare/v1/clinics/{$clinic_id}", 'GET', array(), $this->admin_user );
|
||||
|
||||
// ASSERT: Response contract
|
||||
$this->assertRestResponse( $response, 200 );
|
||||
|
||||
$data = $response->get_data();
|
||||
$this->assertClinicStructure( $data );
|
||||
$this->assertEquals( $clinic_id, $data['id'] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Test PUT /wp-json/kivicare/v1/clinics/{id} endpoint contract.
|
||||
*
|
||||
* @test
|
||||
*/
|
||||
public function test_update_clinic_endpoint_contract() {
|
||||
// This test will fail initially as the endpoint doesn't exist yet
|
||||
$this->markTestIncomplete( 'Clinic PUT endpoint not implemented yet - TDD RED phase' );
|
||||
|
||||
// ARRANGE: Existing clinic and update data
|
||||
$clinic_id = $this->create_test_clinic();
|
||||
$update_data = array(
|
||||
'name' => 'Clínica Atualizada',
|
||||
'telephone_no' => '+351111222333',
|
||||
);
|
||||
|
||||
// ACT: Make PUT request to update clinic
|
||||
$response = $this->make_request( "/wp-json/kivicare/v1/clinics/{$clinic_id}", 'PUT', $update_data, $this->admin_user );
|
||||
|
||||
// ASSERT: Response contract
|
||||
$this->assertRestResponse( $response, 200 );
|
||||
|
||||
$data = $response->get_data();
|
||||
$this->assertClinicStructure( $data );
|
||||
$this->assertEquals( $update_data['name'], $data['name'] );
|
||||
$this->assertEquals( $update_data['telephone_no'], $data['telephone_no'] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Test DELETE /wp-json/kivicare/v1/clinics/{id} endpoint contract.
|
||||
*
|
||||
* @test
|
||||
*/
|
||||
public function test_delete_clinic_endpoint_contract() {
|
||||
// This test will fail initially as the endpoint doesn't exist yet
|
||||
$this->markTestIncomplete( 'Clinic DELETE endpoint not implemented yet - TDD RED phase' );
|
||||
|
||||
// ARRANGE: Existing clinic
|
||||
$clinic_id = $this->create_test_clinic();
|
||||
|
||||
// ACT: Make DELETE request
|
||||
$response = $this->make_request( "/wp-json/kivicare/v1/clinics/{$clinic_id}", 'DELETE', array(), $this->admin_user );
|
||||
|
||||
// ASSERT: Response contract
|
||||
$this->assertRestResponse( $response, 200 );
|
||||
|
||||
$data = $response->get_data();
|
||||
$this->assertArrayHasKey( 'deleted', $data );
|
||||
$this->assertTrue( $data['deleted'] );
|
||||
$this->assertEquals( $clinic_id, $data['id'] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Test clinic permissions for different user roles.
|
||||
*
|
||||
* @test
|
||||
*/
|
||||
public function test_clinic_permissions_contract() {
|
||||
// This test will fail initially as role-based permissions aren't implemented
|
||||
$this->markTestIncomplete( 'Role-based permissions not implemented yet - TDD RED phase' );
|
||||
|
||||
// ARRANGE: Existing clinic
|
||||
$clinic_id = $this->create_test_clinic();
|
||||
|
||||
// ACT & ASSERT: Doctor should not be able to create clinics
|
||||
$response = $this->make_request( '/wp-json/kivicare/v1/clinics', 'POST', array( 'name' => 'Test' ), $this->doctor_user );
|
||||
$this->assertRestResponse( $response, 403 );
|
||||
|
||||
// ACT & ASSERT: Patient should not be able to access clinics
|
||||
$response = $this->make_request( '/wp-json/kivicare/v1/clinics', 'GET', array(), $this->patient_user );
|
||||
$this->assertRestResponse( $response, 403 );
|
||||
|
||||
// ACT & ASSERT: Administrator should have full access
|
||||
$response = $this->make_request( "/wp-json/kivicare/v1/clinics/{$clinic_id}", 'GET', array(), $this->admin_user );
|
||||
$this->assertRestResponse( $response, 200 );
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper method to assert clinic data structure.
|
||||
*
|
||||
* @param array $clinic Clinic data to validate.
|
||||
*/
|
||||
private function assertClinicStructure( $clinic ) {
|
||||
$this->assertIsArray( $clinic );
|
||||
|
||||
// Required fields
|
||||
$this->assertArrayHasKey( 'id', $clinic );
|
||||
$this->assertArrayHasKey( 'name', $clinic );
|
||||
$this->assertArrayHasKey( 'status', $clinic );
|
||||
|
||||
// Optional fields that should be present in response
|
||||
$expected_fields = array(
|
||||
'email', 'telephone_no', 'address', 'city',
|
||||
'state', 'country', 'postal_code', 'specialties',
|
||||
'clinic_admin_id', 'created_at'
|
||||
);
|
||||
|
||||
foreach ( $expected_fields as $field ) {
|
||||
$this->assertArrayHasKey( $field, $clinic );
|
||||
}
|
||||
|
||||
// Data type validations
|
||||
$this->assertIsInt( $clinic['id'] );
|
||||
$this->assertIsString( $clinic['name'] );
|
||||
$this->assertIsInt( $clinic['status'] );
|
||||
|
||||
if ( ! empty( $clinic['email'] ) ) {
|
||||
$this->assertIsString( $clinic['email'] );
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user