Add policy, intake, and payment history to the admin student detail view

The student-administration spec deferred three detail-view sections until
Payments landed. Adds them now: policy-acceptance history (title, version,
context, date), intake answers (label, answer, context), and — gated on
manage_billing — payment history with HST breakdown and receipt numbers.

New Auth\StudentHistory builds the display rows from per-student queries
added to AcceptanceRepository, AnswerRepository, and PaymentRepository;
the Payment model now carries created_at so unpaid rows still have a date.

Closes #69

Co-Authored-By: Claude Fable 5 <[email protected]>

src/AdminMenu.php

@@ -13,6 +13,7 @@ use Unsupervised\Schedular\Auth\RegistrationController;
 use Unsupervised\Schedular\Auth\RegistrationMailer;
 use Unsupervised\Schedular\Auth\RoleManager;
 use Unsupervised\Schedular\Auth\StudentController;
+use Unsupervised\Schedular\Auth\StudentHistory;
 use Unsupervised\Schedular\Booking\BookingRepository;
 use Unsupervised\Schedular\Booking\LessonController;
 use Unsupervised\Schedular\GroupClass\EnrollmentRepository;
@@ -25,10 +26,12 @@ use Unsupervised\Schedular\Payment\PaymentReportController;
 use Unsupervised\Schedular\Payment\PaymentRepository;
 use Unsupervised\Schedular\Payment\PaymentService;
 use Unsupervised\Schedular\Payment\StudioSettings;
+use Unsupervised\Schedular\Policy\AcceptanceRepository;
 use Unsupervised\Schedular\Policy\PolicyController;
 use Unsupervised\Schedular\Policy\PolicyRepository;
 use Unsupervised\Schedular\Policy\PolicyService;
 use Unsupervised\Schedular\Policy\PolicyVersionRepository;
+use Unsupervised\Schedular\Registration\AnswerRepository;
 use Unsupervised\Schedular\Registration\QuestionController;
 use Unsupervised\Schedular\Registration\QuestionRepository;
 
@@ -49,7 +52,7 @@ class AdminMenu {
 	private PaymentController $paymentController;
 	private PaymentReportController $paymentReportController;
 
-	public function __construct( AvailabilityRepository $availability, BookingRepository $bookings, OfferingRepository $offerings, QuestionRepository $questions, PolicyRepository $policies, PolicyVersionRepository $policyVersions, PolicyService $policyService, InviteRepository $invites, EnrollmentRepository $enrollments, StudioSettings $settings, PaymentRepository $payments, PaymentService $paymentService, BillingMethodResolver $resolver ) {
+	public function __construct( AvailabilityRepository $availability, BookingRepository $bookings, OfferingRepository $offerings, QuestionRepository $questions, AnswerRepository $answers, PolicyRepository $policies, PolicyVersionRepository $policyVersions, PolicyService $policyService, AcceptanceRepository $acceptances, InviteRepository $invites, EnrollmentRepository $enrollments, StudioSettings $settings, PaymentRepository $payments, PaymentService $paymentService, BillingMethodResolver $resolver ) {
 		$this->availabilityController         = new AvailabilityController( $availability, $offerings );
 		$this->lessonController               = new LessonController( $bookings, $payments, $availability );
 		$this->offeringController             = new OfferingController( $offerings );
@@ -58,7 +61,7 @@ class AdminMenu {
 		$this->registrationController         = new RegistrationController( $invites );
 		$this->registrationApprovalController = new RegistrationApprovalController( new RegistrationMailer() );
 		$this->groupClassController           = new GroupClassController( $enrollments, $offerings );
-		$this->studentController              = new StudentController( $bookings, $availability, $offerings, $enrollments, $resolver );
+		$this->studentController              = new StudentController( $bookings, $availability, $offerings, $enrollments, $resolver, new StudentHistory( $acceptances, $policies, $policyVersions, $answers, $questions, $payments ) );
 		$this->instructorController           = new InstructorController();
 		$this->settings                       = $settings;
 		$this->accessSettings                 = new AccessSettings();

src/Auth/StudentController.php

@@ -21,6 +21,7 @@ class StudentController {
 		private OfferingRepository $offerings,
 		private EnrollmentRepository $enrollments,
 		private BillingMethodResolver $resolver,
+		private StudentHistory $history,
 	) {}
 
 	public function renderPage(): void {
@@ -100,6 +101,10 @@ class StudentController {
 			$this->enrollments->findByStudent( (int) $student->ID )
 		);
 
+		$acceptances = $this->history->policyAcceptances( (int) $student->ID );
+		$intake      = $this->history->intakeAnswers( (int) $student->ID );
+		$payments    = $canBilling ? $this->history->payments( (int) $student->ID ) : [];
+
 		$backUrl = admin_url( 'admin.php?page=us-students' );
 		include USC_PLUGIN_DIR . 'templates/admin/student-detail.php';
 	}

src/Auth/StudentHistory.php

@@ -0,0 +1,112 @@
+<?php
+declare(strict_types=1);
+
+namespace Unsupervised\Schedular\Auth;
+
+use Unsupervised\Schedular\Payment\Payment;
+use Unsupervised\Schedular\Payment\PaymentRepository;
+use Unsupervised\Schedular\Policy\AcceptanceRepository;
+use Unsupervised\Schedular\Policy\PolicyAcceptance;
+use Unsupervised\Schedular\Policy\PolicyRepository;
+use Unsupervised\Schedular\Policy\PolicyVersionRepository;
+use Unsupervised\Schedular\Registration\Answer;
+use Unsupervised\Schedular\Registration\AnswerRepository;
+use Unsupervised\Schedular\Registration\QuestionRepository;
+
+/**
+ * Builds the display rows for the history sections of the admin student detail
+ * view: policy acceptances, intake answers, and payments.
+ */
+class StudentHistory {
+
+	public function __construct(
+		private AcceptanceRepository $acceptances,
+		private PolicyRepository $policies,
+		private PolicyVersionRepository $policyVersions,
+		private AnswerRepository $answers,
+		private QuestionRepository $questions,
+		private PaymentRepository $payments,
+	) {}
+
+	/**
+	 * Every policy acceptance the student has recorded, newest first.
+	 *
+	 * @return list<array{policy: string, version: string, context: string, accepted_at: string}>
+	 */
+	public function policyAcceptances( int $studentId ): array {
+		return array_map(
+			function ( PolicyAcceptance $acceptance ): array {
+				$version = $this->policyVersions->findById( $acceptance->policyVersionId );
+				$policy  = $version ? $this->policies->findById( $version->policyId ) : null;
+
+				return [
+					'policy'      => $policy ? $policy->title : sprintf( '#%d', $acceptance->policyVersionId ),
+					'version'     => $version ? sprintf( 'v%d', $version->versionNumber ) : '—',
+					'context'     => $this->contextLabel( $acceptance->registrationType, $acceptance->registrationId ),
+					'accepted_at' => $acceptance->acceptedAt ?? '',
+				];
+			},
+			$this->acceptances->findByStudent( $studentId )
+		);
+	}
+
+	/**
+	 * Every intake answer the student has submitted, newest registration first.
+	 *
+	 * @return list<array{question: string, answer: string, context: string}>
+	 */
+	public function intakeAnswers( int $studentId ): array {
+		return array_map(
+			function ( Answer $answer ): array {
+				$question = $this->questions->findById( $answer->questionId );
+
+				return [
+					'question' => $question ? $question->label : sprintf( '#%d', $answer->questionId ),
+					'answer'   => $answer->answerValue ?? '—',
+					'context'  => $this->contextLabel( $answer->registrationType, $answer->registrationId ),
+				];
+			},
+			$this->answers->findByStudent( $studentId )
+		);
+	}
+
+	/**
+	 * Every payment for the student, newest first.
+	 *
+	 * @return list<array{created_at: string, context: string, method: string, status: string, amount: float, tax_amount: float, total: float, currency: string, receipt: string}>
+	 */
+	public function payments( int $studentId ): array {
+		return array_map(
+			fn( Payment $payment ): array => [
+				'created_at' => $payment->createdAt ?? '',
+				'context'    => $this->contextLabel( $payment->registrationType, $payment->registrationId ),
+				'method'     => $payment->method,
+				'status'     => $payment->status,
+				'amount'     => $payment->amount,
+				'tax_amount' => $payment->taxAmount,
+				'total'      => $payment->total(),
+				'currency'   => $payment->currency,
+				'receipt'    => $payment->receiptNumber ?? '—',
+			],
+			$this->payments->findByStudent( $studentId )
+		);
+	}
+
+	/**
+	 * Human label for a polymorphic registration target.
+	 */
+	private function contextLabel( string $registrationType, int $registrationId ): string {
+		switch ( $registrationType ) {
+			case PolicyAcceptance::REG_ACCOUNT:
+				return __( 'Account signup', 'unsupervised-schedular' );
+			case PolicyAcceptance::REG_LESSON:
+				/* translators: %d: the lesson id */
+				return sprintf( __( 'Lesson #%d', 'unsupervised-schedular' ), $registrationId );
+			case PolicyAcceptance::REG_ENROLLMENT:
+				/* translators: %d: the group-class enrolment id */
+				return sprintf( __( 'Enrolment #%d', 'unsupervised-schedular' ), $registrationId );
+			default:
+				return sprintf( '%s #%d', $registrationType, $registrationId );
+		}
+	}
+}

src/Payment/Payment.php

@@ -49,6 +49,7 @@ class Payment {
 		public readonly ?string $receiptNumber = null,
 		public readonly ?string $receiptSentAt = null,
 		public readonly ?string $paidAt = null,
+		public readonly ?string $createdAt = null,
 		public readonly ?int $id = null,
 	) {}
 
@@ -69,6 +70,7 @@ class Payment {
 			receiptNumber:         Val::stringOrNull( $row->receipt_number ),
 			receiptSentAt:         Val::stringOrNull( $row->receipt_sent_at ),
 			paidAt:                Val::stringOrNull( $row->paid_at ),
+			createdAt:             Val::stringOrNull( $row->created_at ),
 			id:                    Val::int( $row->id ),
 		);
 	}
@@ -120,6 +122,7 @@ class Payment {
 			'status'            => $this->status,
 			'receipt_number'    => $this->receiptNumber,
 			'paid_at'           => $this->paidAt,
+			'created_at'        => $this->createdAt,
 		];
 	}
 }

src/Payment/PaymentRepository.php

@@ -132,6 +132,23 @@ class PaymentRepository {
 		return $row ? Payment::fromRow( $row ) : null;
 	}
 
+	/**
+	 * Every payment for a student, newest first (admin payment history).
+	 *
+	 * @return list<Payment>
+	 */
+	public function findByStudent( int $studentId ): array {
+		$rows = $this->db->get_results(
+			$this->db->prepare(
+				'SELECT * FROM %i WHERE student_id = %d ORDER BY created_at DESC, id DESC',
+				$this->table,
+				$studentId
+			)
+		);
+
+		return array_map( Payment::fromRow( ... ), $rows ?? [] );
+	}
+
 	/**
 	 * Pending payments, newest first (studio-admin confirmation queue).
 	 *

src/Plugin.php

@@ -79,7 +79,7 @@ class Plugin {
 		( new RoleManager() )->register();
 		( new RegistrationLoginGate() )->register();
 		( new EmailConfirmationHandler( $settings, $registrationMailer ) )->register();
-		( new AdminMenu( $availability, $bookings, $offerings, $questions, $policies, $policyVersions, $policyService, $invites, $enrollments, $settings, $paymentRepo, $paymentService, $resolver ) )->register();
+		( new AdminMenu( $availability, $bookings, $offerings, $questions, $answers, $policies, $policyVersions, $policyService, $acceptances, $invites, $enrollments, $settings, $paymentRepo, $paymentService, $resolver ) )->register();
 		( new RestRegistrar( $availability, $bookings, $offerings, $questions, $policies, $policyVersions, $policyService, $registrationGate, $enrollments, $paymentService ) )->register();
 		( new ShortcodeRegistrar( $bookingPage, $loginPage, $registrationPage, $groupClassPage ) )->register();
 		( new BlockRegistrar( $bookingPage, $loginPage, $registrationPage, $groupClassPage ) )->register();

src/Policy/AcceptanceRepository.php

@@ -55,4 +55,21 @@ class AcceptanceRepository {
 
 		return array_map( PolicyAcceptance::fromRow( ... ), $rows ?? [] );
 	}
+
+	/**
+	 * Find every acceptance a student has recorded, newest first.
+	 *
+	 * @return list<PolicyAcceptance>
+	 */
+	public function findByStudent( int $studentId ): array {
+		$rows = $this->db->get_results(
+			$this->db->prepare(
+				'SELECT * FROM %i WHERE student_id = %d ORDER BY accepted_at DESC, id DESC',
+				$this->table,
+				$studentId
+			)
+		);
+
+		return array_map( PolicyAcceptance::fromRow( ... ), $rows ?? [] );
+	}
 }

src/Registration/AnswerRepository.php

@@ -55,4 +55,21 @@ class AnswerRepository {
 
 		return array_map( Answer::fromRow( ... ), $rows ?? [] );
 	}
+
+	/**
+	 * Find every answer a student has submitted, newest registration first.
+	 *
+	 * @return list<Answer>
+	 */
+	public function findByStudent( int $studentId ): array {
+		$rows = $this->db->get_results(
+			$this->db->prepare(
+				'SELECT * FROM %i WHERE student_id = %d ORDER BY id DESC',
+				$this->table,
+				$studentId
+			)
+		);
+
+		return array_map( Answer::fromRow( ... ), $rows ?? [] );
+	}
 }