# Implantação 005 - Usuários, ACL e Relatórios

Data: 2026-01-28

## O que foi feito
- CRUD de usuários com gerenciamento de permissões.
- ACL com permissões por perfil (admin/secretaria/escola) e por usuário.
- Relatórios iniciais (alunos, turmas, matrículas) com filtros.
- Tela de vínculos de turmas (professores/disciplina) mais amigável.

## Arquivos alterados/criados
- `app/Http/Controllers/UserController.php`
- `app/Http/Controllers/ClassroomLinkController.php`
- `app/Http/Controllers/ReportController.php`
- `app/Models/Permission.php`
- `app/Models/PermissionRole.php`
- `app/Models/User.php`
- `database/migrations/2026_01_28_132449_create_permissions_table.php`
- `database/migrations/2026_01_28_132457_create_permission_user_table.php`
- `database/migrations/2026_01_28_132506_create_permission_role_table.php`
- `database/seeders/PermissionsSeeder.php`
- `database/seeders/DatabaseSeeder.php`
- `app/Http/Middleware/PermissionMiddleware.php`
- `bootstrap/app.php`
- `routes/web.php`
- `app/Helpers/MenuHelper.php`
- `resources/views/pages/users/index.blade.php`
- `resources/views/pages/users/create.blade.php`
- `resources/views/pages/users/edit.blade.php`
- `resources/views/pages/users/permissions.blade.php`
- `resources/views/pages/links/classrooms/index.blade.php`
- `resources/views/pages/links/classrooms/edit.blade.php`
- `resources/views/pages/reports/index.blade.php`
- `resources/views/pages/reports/students.blade.php`
- `resources/views/pages/reports/classrooms.blade.php`
- `resources/views/pages/reports/enrollments.blade.php`
- `resources/views/components/common/permission-badge.blade.php`

## Comandos recomendados
- `php8.4 artisan migrate --force`
- `php8.4 artisan db:seed --force`
- `npm run build`

## Rollback
1) `sudo /var/www/html/escolar/scripts/rollback_snapshot.sh`
2) `sudo /var/www/html/escolar/scripts/rollback_restore.sh <timestamp>`