Restructure src/ and tests/ from package-by-type to package-by-domain

All classes are now organised by domain (Availability, Booking, Auth). Each domain package contains its value object, repository, admin controller, REST endpoint, and any shortcode pages under a matching sub-namespace. Cross-cutting wiring (Plugin, AdminMenu, RestRegistrar, ShortcodeRegistrar, Schema) lives at src/ root. Tests mirror the domain structure. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-30 16:37:30 -03:00
parent ed49924f95
commit 2fb2ca392d
26 changed files with 108 additions and 83 deletions
@@ -0,0 +1,143 @@
+<?php
+declare(strict_types=1);
+
+namespace Unsupervised\Schedular\Booking;
+
+use Unsupervised\Schedular\Availability\AvailabilityRepository;
+use Unsupervised\Schedular\Auth\RoleManager;
+
+class BookingEndpoint {
+
+	public function __construct(
+		private AvailabilityRepository $availability,
+		private BookingRepository $bookings,
+	) {}
+
+	public function registerRoutes( string $route_namespace ): void {
+		register_rest_route(
+			$route_namespace,
+			'/bookings',
+			[
+				[
+					'methods'             => \WP_REST_Server::READABLE,
+					'callback'            => [ $this, 'myLessons' ],
+					'permission_callback' => [ $this, 'isLoggedIn' ],
+				],
+				[
+					'methods'             => \WP_REST_Server::CREATABLE,
+					'callback'            => [ $this, 'book' ],
+					'permission_callback' => [ $this, 'canBook' ],
+					'args'                => [
+						'slot_id' => [
+							'type'              => 'integer',
+							'required'          => true,
+							'sanitize_callback' => 'absint',
+						],
+						'notes'   => [
+							'type'              => 'string',
+							'default'           => '',
+							'sanitize_callback' => 'sanitize_textarea_field',
+						],
+					],
+				],
+			]
+		);
+
+		register_rest_route(
+			$route_namespace,
+			'/bookings/(?P<id>\d+)/status',
+			[
+				[
+					'methods'             => \WP_REST_Server::EDITABLE,
+					'callback'            => [ $this, 'updateStatus' ],
+					'permission_callback' => [ $this, 'canManage' ],
+					'args'                => [
+						'status' => [
+							'type'     => 'string',
+							'required' => true,
+							'enum'     => Lesson::VALID_STATUSES,
+						],
+					],
+				],
+			]
+		);
+	}
+
+	public function myLessons( \WP_REST_Request $request ): \WP_REST_Response { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found
+		$userId  = get_current_user_id();
+		$lessons = current_user_can( RoleManager::CAP_MANAGE_AVAILABILITY )
+			? $this->bookings->findUpcomingForInstructor( $userId )
+			: $this->bookings->findByStudent( $userId );
+
+		return new \WP_REST_Response( array_map( fn( Lesson $l ) => $l->toArray(), $lessons ), 200 );
+	}
+
+	public function book( \WP_REST_Request $request ): \WP_REST_Response|\WP_Error {
+		$slotId = (int) $request->get_param( 'slot_id' );
+		$slot   = $this->availability->findById( $slotId );
+
+		if ( null === $slot ) {
+			return new \WP_Error( 'not_found', __( 'Slot not found.', 'unsupervised-schedular' ), [ 'status' => 404 ] );
+		}
+
+		if ( $slot->isBooked ) {
+			return new \WP_Error( 'slot_taken', __( 'This slot is already booked.', 'unsupervised-schedular' ), [ 'status' => 409 ] );
+		}
+
+		$notes  = (string) $request->get_param( 'notes' );
+		$lesson = new Lesson(
+			slotId:       $slotId,
+			studentId:    get_current_user_id(),
+			instructorId: $slot->instructorId,
+			notes:        '' !== $notes ? $notes : null,
+		);
+
+		$id = $this->bookings->insert( $lesson );
+		$this->availability->markBooked( $slotId );
+
+		return new \WP_REST_Response(
+			[
+				'id'     => $id,
+				'status' => Lesson::STATUS_PENDING,
+			],
+			201
+		);
+	}
+
+	public function updateStatus( \WP_REST_Request $request ): \WP_REST_Response|\WP_Error {
+		$id     = absint( $request->get_param( 'id' ) );
+		$lesson = $this->bookings->findById( $id );
+
+		if ( null === $lesson ) {
+			return new \WP_Error( 'not_found', __( 'Booking not found.', 'unsupervised-schedular' ), [ 'status' => 404 ] );
+		}
+
+		if ( get_current_user_id() !== $lesson->instructorId && ! current_user_can( 'manage_options' ) ) {
+			return new \WP_Error( 'forbidden', __( 'You cannot update this booking.', 'unsupervised-schedular' ), [ 'status' => 403 ] );
+		}
+
+		$this->bookings->updateStatus( $id, (string) $request->get_param( 'status' ) );
+
+		return new \WP_REST_Response(
+			[
+				'id'     => $id,
+				'status' => $request->get_param( 'status' ),
+			],
+			200
+		);
+	}
+
+	public function isLoggedIn(): bool {
+		return is_user_logged_in();
+	}
+
+	public function canBook(): bool {
+		return is_user_logged_in() && current_user_can( RoleManager::CAP_BOOK_LESSON );
+	}
+
+	public function canManage(): bool {
+		return is_user_logged_in() && (
+			current_user_can( RoleManager::CAP_MANAGE_AVAILABILITY ) || current_user_can( 'manage_options' )
+		);
+	}
+}