feat(database): 添加用户角色权限系统及相关监控功能

- 创建用户表(users)包含基本信息和认证字段 - 创建角色表(roles)用于权限控制 - 创建权限表(permissions)定义系统权限 - 创建用户角色关联表(user_roles)建立用户与角色关系 - 创建角色权限关联表(role_permissions)建立角色与权限关系 - 创建迁移记录表(migrations)追踪数据库变更 - 添加AdminController提供管理员面板功能 - 实现系统监控、配置管理、缓存清理等功能 - 添加AOP切面编程支持的各种通知类型 - 实现告警管理AlertManager支持多渠道告警 - 添加文档注解接口规范
2026-06-15 23:12:49 +08:00 · 2026-04-08 17:00:28 +08:00
commit 2782d765fb
270 changed files with 107192 additions and 0 deletions
--- a/app/Service/UserService.php
+++ b/app/Service/UserService.php
@@ -0,0 +1,198 @@
+<?php
+declare(strict_types=1);
+
+namespace App\Service;
+
+use Fendx\Core\Annotation\Service;
+use Fendx\Core\Annotation\Inject;
+use Fendx\Db\Annotation\Transactional;
+use Fendx\Cache\Annotation\Cacheable;
+use Fendx\Cache\Annotation\CacheUpdate;
+use Fendx\Cache\Annotation\CacheEvict;
+use App\Dao\UserDao;
+use App\Entity\User;
+use Fendx\Web\Validator\Validator;
+use Fendx\Common\Exception\BusinessException;
+
+#[Service]
+class UserService
+{
+    #[Inject]
+    private UserDao $userDao;
+
+    #[Cacheable(key: "user:{id}", ttl: 3600)]
+    public function getUser(int $id): ?User
+    {
+        return $this->userDao->findById($id);
+    }
+
+    public function getUserByEmail(string $email): ?User
+    {
+        return $this->userDao->findByEmail($email);
+    }
+
+    public function getUserByUsername(string $username): ?User
+    {
+        return $this->userDao->findByUsername($username);
+    }
+
+    #[Cacheable(key: "users:active", ttl: 1800)]
+    public function getActiveUsers(): array
+    {
+        return $this->userDao->findAllActive();
+    }
+
+    public function getUsersPaginated(int $page = 1, int $pageSize = 10): array
+    {
+        return $this->userDao->findPaginated($page, $pageSize);
+    }
+
+    #[Transactional]
+    #[CacheUpdate(key: "user:{id}")]
+    public function createUser(array $data): User
+    {
+        // 验证数据
+        $this->validateUserData($data);
+        
+        // 检查邮箱和用户名是否已存在
+        if ($this->userDao->findByEmail($data['email'])) {
+            throw new BusinessException(400, 'Email already exists');
+        }
+        
+        if ($this->userDao->findByUsername($data['username'])) {
+            throw new BusinessException(400, 'Username already exists');
+        }
+        
+        // 加密密码
+        $data['password'] = password_hash($data['password'], PASSWORD_DEFAULT);
+        
+        return $this->userDao->create($data);
+    }
+
+    #[Transactional]
+    #[CacheUpdate(key: "user:{id}")]
+    public function updateUser(int $id, array $data): bool
+    {
+        $user = $this->userDao->findById($id);
+        if (!$user) {
+            throw new BusinessException(404, 'User not found');
+        }
+
+        // 如果更新邮箱，检查是否已存在
+        if (isset($data['email']) && $data['email'] !== $user->email) {
+            if ($this->userDao->findByEmail($data['email'])) {
+                throw new BusinessException(400, 'Email already exists');
+            }
+        }
+
+        // 如果更新用户名，检查是否已存在
+        if (isset($data['username']) && $data['username'] !== $user->username) {
+            if ($this->userDao->findByUsername($data['username'])) {
+                throw new BusinessException(400, 'Username already exists');
+            }
+        }
+
+        // 如果更新密码，需要加密
+        if (isset($data['password'])) {
+            $data['password'] = password_hash($data['password'], PASSWORD_DEFAULT);
+        }
+
+        return $this->userDao->update($id, $data);
+    }
+
+    #[Transactional]
+    #[CacheEvict(key: "user:{id}")]
+    public function deleteUser(int $id): bool
+    {
+        $user = $this->userDao->findById($id);
+        if (!$user) {
+            throw new BusinessException(404, 'User not found');
+        }
+
+        return $this->userDao->delete($id);
+    }
+
+    public function searchUsers(string $keyword, int $page = 1, int $pageSize = 10): array
+    {
+        return $this->userDao->search($keyword, $page, $pageSize);
+    }
+
+    public function getUsersCount(): int
+    {
+        return $this->userDao->count();
+    }
+
+    public function getActiveUsersCount(): int
+    {
+        return $this->userDao->countActive();
+    }
+
+    public function validatePassword(string $password, string $hash): bool
+    {
+        return password_verify($password, $hash);
+    }
+
+    public function changePassword(int $userId, string $oldPassword, string $newPassword): bool
+    {
+        $user = $this->userDao->findById($userId);
+        if (!$user) {
+            throw new BusinessException(404, 'User not found');
+        }
+
+        if (!$this->validatePassword($oldPassword, $user->password)) {
+            throw new BusinessException(400, 'Invalid old password');
+        }
+
+        return $this->updateUser($userId, ['password' => $newPassword]);
+    }
+
+    public function toggleUserStatus(int $id): bool
+    {
+        $user = $this->userDao->findById($id);
+        if (!$user) {
+            throw new BusinessException(404, 'User not found');
+        }
+
+        $newStatus = $user->status === 1 ? 0 : 1;
+        
+        return $this->updateUser($id, ['status' => $newStatus]);
+    }
+
+    private function validateUserData(array $data): void
+    {
+        $validator = Validator::make($data, [
+            'username' => 'required|min:3|max:50',
+            'email' => 'required|email',
+            'password' => 'required|min:6'
+        ]);
+
+        if (!$validator->validate()) {
+            throw new BusinessException(422, 'Validation failed', $validator->errors());
+        }
+    }
+
+    public function validateUserUpdateData(array $data): void
+    {
+        $rules = [];
+        
+        if (isset($data['username'])) {
+            $rules['username'] = 'required|min:3|max:50';
+        }
+        
+        if (isset($data['email'])) {
+            $rules['email'] = 'required|email';
+        }
+        
+        if (isset($data['password'])) {
+            $rules['password'] = 'required|min:6';
+        }
+
+        if (!empty($rules)) {
+            $validator = Validator::make($data, $rules);
+            
+            if (!$validator->validate()) {
+                throw new BusinessException(422, 'Validation failed', $validator->errors());
+            }
+        }
+    }
+}