docs: add class docblocks, business-rule comments, and transaction wrapper

- Add single-line class docblocks to all 59 repository classes and interfaces
  describing scope and responsibility
- Add multi-line docblocks to key services documenting business rules:
  AuthService (6-step login cascade), ImportService (3-phase CSV workflow),
  TenantScopeService (strict/permissive modes), PermissionService (RBAC
  resolution + two-tier caching), UserAccountService (atomicity + audit)
- Add transaction(callable) wrapper to DatabaseSessionRepository to DRY up
  begin/commit/rollback boilerplate

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

lib/Repository/Scheduler/ScheduledJobRepository.php

@@ -6,6 +6,7 @@ use MintyPHP\DB;
 use MintyPHP\Domain\Taxonomy\ScheduledJobStatus;
 use MintyPHP\Repository\Support\RepoQuery;
 
+/** Persists scheduled jobs with cron expressions, next-run calculation, and metadata updates. */
 class ScheduledJobRepository implements ScheduledJobRepositoryInterface
 {
     public function create(array $data): int|false

lib/Repository/Scheduler/ScheduledJobRepositoryInterface.php

@@ -2,6 +2,7 @@
 
 namespace MintyPHP\Repository\Scheduler;
 
+/** Contract for scheduled job CRUD, due-job queries, and run status tracking. */
 interface ScheduledJobRepositoryInterface
 {
     public function create(array $data): int|false;

lib/Repository/Scheduler/ScheduledJobRunRepository.php

@@ -7,6 +7,7 @@ use MintyPHP\Domain\Taxonomy\ScheduledJobRunStatus;
 use MintyPHP\Domain\Taxonomy\ScheduledJobTriggerType;
 use MintyPHP\Repository\Support\RepoQuery;
 
+/** Records individual job run results with duration, output, and retention-based purging. */
 class ScheduledJobRunRepository implements ScheduledJobRunRepositoryInterface
 {
     public function create(array $data): int|false

lib/Repository/Scheduler/ScheduledJobRunRepositoryInterface.php

@@ -2,6 +2,7 @@
 
 namespace MintyPHP\Repository\Scheduler;
 
+/** Contract for scheduled job run history: creation, pagination, and retention purge. */
 interface ScheduledJobRunRepositoryInterface
 {
     public function create(array $data): int|false;

lib/Repository/Scheduler/SchedulerRuntimeRepository.php

@@ -5,6 +5,7 @@ namespace MintyPHP\Repository\Scheduler;
 use MintyPHP\DB;
 use MintyPHP\Domain\Taxonomy\SchedulerRuntimeResult;
 
+/** Tracks scheduler daemon heartbeat, result codes, and error state. */
 class SchedulerRuntimeRepository implements SchedulerRuntimeRepositoryInterface
 {
     public function touchHeartbeat(string $result, ?string $errorCode = null, ?string $heartbeatAtUtc = null): bool

lib/Repository/Scheduler/SchedulerRuntimeRepositoryInterface.php

@@ -2,6 +2,7 @@
 
 namespace MintyPHP\Repository\Scheduler;
 
+/** Contract for scheduler daemon heartbeat and runtime status. */
 interface SchedulerRuntimeRepositoryInterface
 {
     public function touchHeartbeat(string $result, ?string $errorCode = null, ?string $heartbeatAtUtc = null): bool;