Files
unsupervised-scheduler/tests/Unit/Registration/QuestionRepositoryTest.php
T
thatguygriffandClaude Opus 4.8 49c59a950c
CI / Tests (PHP 8.2) (pull_request) Successful in 44s
CI / Tests (PHP 8.1) (pull_request) Successful in 45s
CI / No Debug Code (pull_request) Successful in 2s
CI / Coding Standards (pull_request) Successful in 2m46s
CI / PHPStan (pull_request) Successful in 2m58s
CI / Tests (PHP 8.3) (pull_request) Successful in 2m41s
CI / Build Plugin Zip (pull_request) Skipped
Add studio-defined account-registration questions
Studio admins can now define registration questions that every new student
answers as a required second step during signup, with each student's answers
shown under a "Registration Information" section in the admin.

Extends the existing Registration domain: us_questions gains a scope column
(offering | account) and a nullable offering_id, and account answers reuse
us_question_answers with registration_type = 'account'. Authoring reuses the
Offerings -> Questions page via an "Account signup" scope (studio-admin only).
The registration form becomes two steps (progressive enhancement via
assets/js/register.js; works without JS); required answers are validated before
the account is created and apply to all signup paths (invite, group link,
self-approval). StudentHistory::registrationInfo() powers the admin section.

Bumps the plugin version to 1.1.0 so dbDelta runs the schema migration.

Closes #90

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-07-23 09:59:59 -03:00

216 lines
7.0 KiB
PHP

<?php
declare(strict_types=1);
namespace Unsupervised\Schedular\Tests\Unit\Registration;
use Brain\Monkey\Functions;
use Mockery;
use Unsupervised\Schedular\Registration\Question;
use Unsupervised\Schedular\Registration\QuestionRepository;
use Unsupervised\Schedular\Tests\Unit\TestCase;
class QuestionRepositoryTest extends TestCase
{
private \wpdb $db;
private QuestionRepository $repo;
protected function setUp(): void
{
parent::setUp();
$this->db = Mockery::mock(\wpdb::class);
$this->db->prefix = 'wp_';
$this->repo = new QuestionRepository($this->db);
}
public function testInsertWithNullOptionsStoresNull(): void
{
Functions\expect('current_time')->with('mysql')->andReturn('2026-04-01 12:00:00');
$this->db->shouldReceive('insert')
->once()
->with(
'wp_us_questions',
Mockery::on(static function (array $data): bool {
return $data['offering_id'] === 7
&& $data['label'] === 'Your level?'
&& $data['field_type'] === Question::FIELD_TEXT
&& $data['options'] === null
&& $data['is_required'] === 0
&& $data['created_at'] === '2026-04-01 12:00:00';
}),
Mockery::type('array')
);
$this->db->insert_id = 21;
$question = new Question(7, 'Your level?');
self::assertSame(21, $this->repo->insert($question));
}
public function testInsertEncodesOptionsAsJson(): void
{
Functions\expect('current_time')->andReturn('2026-04-01 12:00:00');
Functions\expect('wp_json_encode')
->once()
->with(['Beginner', 'Advanced'])
->andReturn('["Beginner","Advanced"]');
$this->db->shouldReceive('insert')
->once()
->with(
'wp_us_questions',
Mockery::on(static fn (array $data): bool => $data['options'] === '["Beginner","Advanced"]'),
Mockery::type('array')
);
$this->db->insert_id = 22;
$question = new Question(
offeringId: 7,
label: 'Pick a level',
fieldType: Question::FIELD_SELECT,
options: ['Beginner', 'Advanced'],
);
self::assertSame(22, $this->repo->insert($question));
}
public function testUpdateReturnsTrueOnSuccess(): void
{
$this->db->shouldReceive('update')
->once()
->with(
'wp_us_questions',
Mockery::on(static fn (array $data): bool => $data['label'] === 'Renamed' && $data['is_required'] === 1),
['id' => 5],
Mockery::type('array'),
['%d']
)
->andReturn(1);
$question = new Question(7, 'Renamed', isRequired: true, id: 5);
self::assertTrue($this->repo->update(5, $question));
}
public function testFindByOfferingActiveOnlyPreparesQuery(): void
{
$this->db->shouldReceive('prepare')
->once()
->with(
Mockery::pattern('/offering_id = %d AND is_active = %d/'),
Mockery::on(static fn (array $p): bool => $p === ['wp_us_questions', 7, 1])
)
->andReturn('SELECT ...');
$this->db->shouldReceive('get_results')->andReturn([]);
self::assertSame([], $this->repo->findByOffering(7, activeOnly: true));
}
public function testFindByOfferingReturnsQuestions(): void
{
$row = (object) [
'id' => '3',
'offering_id' => '7',
'scope' => Question::SCOPE_OFFERING,
'label' => 'Q',
'field_type' => Question::FIELD_TEXT,
'options' => null,
'is_required' => '0',
'sort_order' => '0',
'is_active' => '1',
];
$this->db->shouldReceive('prepare')->andReturn('SELECT ...');
$this->db->shouldReceive('get_results')->andReturn([$row]);
$questions = $this->repo->findByOffering(7);
self::assertCount(1, $questions);
self::assertInstanceOf(Question::class, $questions[0]);
}
public function testInsertAccountQuestionStoresScopeAndNullOffering(): void
{
Functions\expect('current_time')->andReturn('2026-04-01 12:00:00');
$this->db->shouldReceive('insert')
->once()
->with(
'wp_us_questions',
Mockery::on(static function (array $data): bool {
return $data['offering_id'] === null
&& $data['scope'] === Question::SCOPE_ACCOUNT
&& $data['label'] === 'Emergency contact';
}),
Mockery::type('array')
);
$this->db->insert_id = 30;
$question = new Question(null, 'Emergency contact', scope: Question::SCOPE_ACCOUNT);
self::assertSame(30, $this->repo->insert($question));
}
public function testFindByScopeActiveOnlyPreparesQuery(): void
{
$this->db->shouldReceive('prepare')
->once()
->with(
Mockery::pattern('/scope = %s AND is_active = %d/'),
Mockery::on(static fn (array $p): bool => $p === ['wp_us_questions', Question::SCOPE_ACCOUNT, 1])
)
->andReturn('SELECT ...');
$this->db->shouldReceive('get_results')->andReturn([]);
self::assertSame([], $this->repo->findByScope(Question::SCOPE_ACCOUNT, activeOnly: true));
}
public function testFindByScopeReturnsQuestions(): void
{
$row = (object) [
'id' => '5',
'offering_id' => null,
'scope' => Question::SCOPE_ACCOUNT,
'label' => 'How did you hear about us?',
'field_type' => Question::FIELD_TEXT,
'options' => null,
'is_required' => '1',
'sort_order' => '0',
'is_active' => '1',
];
$this->db->shouldReceive('prepare')->andReturn('SELECT ...');
$this->db->shouldReceive('get_results')->andReturn([$row]);
$questions = $this->repo->findByScope(Question::SCOPE_ACCOUNT);
self::assertCount(1, $questions);
self::assertNull($questions[0]->offeringId);
self::assertSame(Question::SCOPE_ACCOUNT, $questions[0]->scope);
}
public function testFindByIdReturnsNullWhenNotFound(): void
{
$this->db->shouldReceive('prepare')->andReturn('SELECT ...');
$this->db->shouldReceive('get_row')->andReturn(null);
self::assertNull($this->repo->findById(99));
}
public function testDeleteCallsWpdbDelete(): void
{
$this->db->shouldReceive('delete')
->once()
->with('wp_us_questions', ['id' => 4], ['%d'])
->andReturn(1);
self::assertTrue($this->repo->delete(4));
}
}