Initial plugin scaffold: lesson scheduling WordPress plugin

- Custom DB tables for availability slots and lesson bookings
- Instructor (wp-admin) and student (front-end) roles with custom capabilities
- REST API under us-scheduler/v1 for availability CRUD and booking
- [us_booking] and [us_student_login] shortcodes for student front end
- PHPUnit + Brain\Monkey unit test suite (29 tests)
- Gitea Actions CI: lint, PHPStan, tests on PHP 8.1/8.2/8.3, no-debug check
- Feature docs under docs/features/

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

src/Roles/RoleManager.php

@@ -0,0 +1,46 @@
+<?php
+declare(strict_types=1);
+
+namespace Unsupervised\Schedular\Roles;
+
+class RoleManager
+{
+    public const INSTRUCTOR = 'us_instructor';
+    public const STUDENT    = 'us_student';
+
+    public const CAP_MANAGE_AVAILABILITY = 'manage_availability';
+    public const CAP_VIEW_LESSONS        = 'view_own_lessons';
+    public const CAP_BOOK_LESSON         = 'book_lesson';
+
+    public function register(): void
+    {
+        add_action('init', [$this, 'createRoles']);
+    }
+
+    public function createRoles(): void
+    {
+        if (get_role(self::INSTRUCTOR) === null) {
+            add_role(
+                self::INSTRUCTOR,
+                __('Instructor', 'unsupervised-schedular'),
+                [
+                    'read'                         => true,
+                    self::CAP_MANAGE_AVAILABILITY  => true,
+                    self::CAP_VIEW_LESSONS         => true,
+                ]
+            );
+        }
+
+        if (get_role(self::STUDENT) === null) {
+            add_role(
+                self::STUDENT,
+                __('Student', 'unsupervised-schedular'),
+                [
+                    'read'                 => true,
+                    self::CAP_BOOK_LESSON  => true,
+                    self::CAP_VIEW_LESSONS => true,
+                ]
+            );
+        }
+    }
+}