refactor: rename lib/ to core/ for clearer core-module separation

Rename the top-level lib/ directory to core/ so the project root immediately communicates which code is core platform and which lives in modules/. PHP namespaces (MintyPHP\*) are unchanged — only the Composer PSR-4 path mapping moves from lib/ to core/. Module-internal lib/ directories (modules/*/lib/) are untouched. Updated across the full stack: - composer.json PSR-4 mapping - bootstrap entry points (web/index.php, bin/*, tests/bootstrap.php) - tooling configs (phpstan.neon, phpunit.xml, php-cs-fixer) - 26 architecture contract tests - enforcement-policy, guard-catalog, quality-gates - all documentation (CLAUDE.md, README, 25 docs/, .agents/skills/) - bin/qa-extended.sh search paths - .claude/settings.local.json permission paths Workflow: .agents/runs/CORE-LIB-RENAME-001/ (Analyst → Planner → Executor → Code Review (4 findings fixed) → Security Review → Acceptance Test → Finalizer) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-13 23:20:05 +02:00
parent 7c10fadcb9
commit 0e86925464
371 changed files with 191 additions and 192 deletions
--- a/core/Service/User/UserServicesFactory.php
+++ b/core/Service/User/UserServicesFactory.php
@@ -0,0 +1,163 @@
+<?php
+
+namespace MintyPHP\Service\User;
+
+use MintyPHP\App\Module\ModuleEventDispatcher;
+use MintyPHP\Repository\Access\UserRoleRepositoryInterface;
+use MintyPHP\Repository\Org\UserDepartmentRepositoryInterface;
+use MintyPHP\Repository\Support\DatabaseSessionRepository;
+use MintyPHP\Repository\Tenant\UserTenantRepositoryInterface;
+use MintyPHP\Repository\User\UserListQueryRepositoryInterface;
+use MintyPHP\Repository\User\UserReadRepositoryInterface;
+use MintyPHP\Repository\User\UserWriteRepositoryInterface;
+use MintyPHP\Service\Access\AssignableRoleService;
+use MintyPHP\Service\Audit\AuditRecorderInterface;
+use MintyPHP\Service\Audit\UserLifecycleAuditInterface;
+
+class UserServicesFactory
+{
+    private ?UserPasswordPolicyService $userPasswordPolicyService = null;
+    private ?UserPasswordService $userPasswordService = null;
+    private ?UserAvatarService $userAvatarService = null;
+    private ?UserAssignmentService $userAssignmentService = null;
+    private ?UserTenantContextService $userTenantContextService = null;
+    private ?UserAccountService $userAccountService = null;
+    private ?UserLifecycleService $userLifecycleService = null;
+    private ?UserLifecycleRestoreService $userLifecycleRestoreService = null;
+
+    /**
+     * @param \Closure(): AssignableRoleService $assignableRoleServiceFactory Lazy resolver to break circular dependency
+     */
+    public function __construct(
+        private readonly AuditRecorderInterface $auditRecorder,
+        private readonly UserLifecycleAuditInterface $userLifecycleAudit,
+        private readonly UserRepositoryFactory $userRepositoryFactory,
+        private readonly UserGatewayFactory $userGatewayFactory,
+        private readonly DatabaseSessionRepository $databaseSessionRepository,
+        private readonly \Closure $assignableRoleServiceFactory,
+        private readonly ?ModuleEventDispatcher $eventDispatcher = null
+    ) {
+    }
+
+    public function createUserAccountService(): UserAccountService
+    {
+        return $this->userAccountService ??= new UserAccountService(
+            $this->createUserReadRepository(),
+            $this->createUserWriteRepository(),
+            $this->createUserListQueryRepository(),
+            $this->createUserAssignmentService(),
+            $this->createUserPasswordService(),
+            $this->createUserSettingsGateway(),
+            $this->userGatewayFactory->getTenantScopeService(),
+            $this->createUserDirectoryGateway(),
+            $this->auditRecorder,
+            $this->databaseSessionRepository,
+            $this->eventDispatcher
+        );
+    }
+
+    public function createUserAssignmentService(): UserAssignmentService
+    {
+        return $this->userAssignmentService ??= new UserAssignmentService(
+            $this->createUserWriteRepository(),
+            $this->createUserTenantRepository(),
+            $this->createUserRoleRepository(),
+            $this->createUserDepartmentRepository(),
+            $this->createUserDirectoryGateway(),
+            $this->userGatewayFactory->createPermissionService(),
+            $this->databaseSessionRepository,
+            ($this->assignableRoleServiceFactory)()
+        );
+    }
+
+    public function createUserTenantContextService(): UserTenantContextService
+    {
+        return $this->userTenantContextService ??= new UserTenantContextService(
+            $this->createUserReadRepository(),
+            $this->createUserWriteRepository(),
+            $this->createUserTenantRepository(),
+            $this->userGatewayFactory->getTenantScopeService(),
+            $this->createUserDirectoryGateway()
+        );
+    }
+
+    public function createUserPasswordService(): UserPasswordService
+    {
+        return $this->userPasswordService ??= new UserPasswordService(
+            $this->createUserPasswordPolicyService(),
+            $this->createUserWriteRepository()
+        );
+    }
+
+    public function createUserAvatarService(): UserAvatarService
+    {
+        return $this->userAvatarService ??= new UserAvatarService();
+    }
+
+    public function createUserReadRepository(): UserReadRepositoryInterface
+    {
+        return $this->userRepositoryFactory->createUserReadRepository();
+    }
+
+    public function createUserWriteRepository(): UserWriteRepositoryInterface
+    {
+        return $this->userRepositoryFactory->createUserWriteRepository();
+    }
+
+    public function createUserListQueryRepository(): UserListQueryRepositoryInterface
+    {
+        return $this->userRepositoryFactory->createUserListQueryRepository();
+    }
+
+    public function createUserTenantRepository(): UserTenantRepositoryInterface
+    {
+        return $this->userRepositoryFactory->createUserTenantRepository();
+    }
+
+    public function createUserRoleRepository(): UserRoleRepositoryInterface
+    {
+        return $this->userRepositoryFactory->createUserRoleRepository();
+    }
+
+    public function createUserDepartmentRepository(): UserDepartmentRepositoryInterface
+    {
+        return $this->userRepositoryFactory->createUserDepartmentRepository();
+    }
+
+    public function createUserPasswordPolicyService(): UserPasswordPolicyService
+    {
+        return $this->userPasswordPolicyService ??= new UserPasswordPolicyService();
+    }
+
+    public function createUserSettingsGateway(): UserSettingsGateway
+    {
+        return $this->userGatewayFactory->createUserSettingsGateway();
+    }
+
+    public function createUserDirectoryGateway(): UserDirectoryGateway
+    {
+        return $this->userGatewayFactory->createUserDirectoryGateway();
+    }
+
+    public function createUserLifecycleService(): UserLifecycleService
+    {
+        return $this->userLifecycleService ??= new UserLifecycleService(
+            $this->createUserReadRepository(),
+            $this->createUserWriteRepository(),
+            $this->createUserSettingsGateway(),
+            $this->userLifecycleAudit,
+            $this->databaseSessionRepository
+        );
+    }
+
+    public function createUserLifecycleRestoreService(): UserLifecycleRestoreService
+    {
+        return $this->userLifecycleRestoreService ??= new UserLifecycleRestoreService(
+            $this->createUserReadRepository(),
+            $this->createUserWriteRepository(),
+            $this->userLifecycleAudit,
+            $this->databaseSessionRepository,
+            $this->createUserSettingsGateway()
+        );
+    }
+}