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
parent 34e8f660ab
commit 49c59a950c
23 changed files with 702 additions and 98 deletions
@@ -115,6 +115,7 @@ class QuestionRepositoryTest extends TestCase
        $row = (object) [
            'id'          => '3',
            'offering_id' => '7',
+            'scope'       => Question::SCOPE_OFFERING,
            'label'       => 'Q',
            'field_type'  => Question::FIELD_TEXT,
            'options'     => null,
@@ -132,6 +133,68 @@ class QuestionRepositoryTest extends TestCase
        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 ...');