feat(admin): implement complete administrative module with RBAC and observability

- implement administrative dashboard with operational metrics
- add consolidated healthcheck and Prometheus metrics endpoints
- implement user management (list, search, block/unblock, password reset and role management)
- implement scraper management with manual trigger and reprocessing
- add audit log migration and administrative action tracking
- integrate audit logs into dashboard, observability and scraper operations
- implement role-based access control (support, admin and super_admin)
- split administrative routes into support, admin and super_admin scopes
- register administrative routes in the application
- export audit schema and update dashboard repository
- include user role in authenticated session for RBAC validation
- update authentication tests for new session contract
- ensure TypeScript compilation and unit tests pass

Author: hltav

.cspell/custom-dictionary-workspace.txt

@@ -89,46 +89,46 @@ Cache & Indexes:
 
 ## Endpoints principais
 
-Base: `/api`
+Base: `/`
 
 - Sistema
-  - `GET /api/health` — verifica disponibilidade (retorna `{ ok: true }`).
+  - `GET /health` — verifica disponibilidade (retorna `{ ok: true }`).
   - `GET /docs` — UI do Swagger (quando habilitado).
 
 - Auth / OAuth
-  - `GET /api/auth/:provider/url` — retorna URL de autenticação (ex: `google`, `github`, `linkedin`).
-  - `GET /api/auth/:provider/callback` — callback OAuth — processa código/state e cria sessão.
+  - `GET /auth/:provider/url` — retorna URL de autenticação (ex: `google`, `github`, `linkedin`).
+  - `GET /auth/:provider/callback` — callback OAuth — processa código/state e cria sessão.
 
 - Credenciais (email/senha)
-  - `POST /api/auth/register` — registra usuário (cria `users`, `credentials`, `userPreferences`) e inicia sessão.
-  - `POST /api/auth/login` — autentica e inicia sessão.
-  - `POST /api/auth/logout` — destroi sessão.
-  - `GET /api/auth/me` — retorna id do usuário autenticado.
+  - `POST /auth/register` — registra usuário (cria `users`, `credentials`, `userPreferences`) e inicia sessão.
+  - `POST /auth/login` — autentica e inicia sessão.
+  - `POST /auth/logout` — destroi sessão.
+  - `GET /auth/me` — retorna id do usuário autenticado.
 
 - Usuários
-  - `GET /api/users/profile` — retorna perfil do usuário autenticado.
-  - `PATCH /api/users/profile` — atualiza campos do perfil.
-  - `GET /api/users/preferences` — obtém preferências do usuário.
-  - `POST /api/users/preferences` — cria preferências (caso não existam).
-  - `PATCH /api/users/preferences` — atualiza preferências.
+  - `GET /users/profile` — retorna perfil do usuário autenticado.
+  - `PATCH /users/profile` — atualiza campos do perfil.
+  - `GET /users/preferences` — obtém preferências do usuário.
+  - `POST /users/preferences` — cria preferências (caso não existam).
+  - `PATCH /users/preferences` — atualiza preferências.
 
 - Jobs
-  - `GET /api/jobs/search?keywords=...` — busca vagas utilizando índices/Valkey/Redis. Retorna paginação e fonte (`source`).
+  - `GET /jobs/search?keywords=...` — busca vagas utilizando índices/Valkey/Redis. Retorna paginação e fonte (`source`).
 
 - Keywords
-  - `GET /api/keywords` — lista keywords persistidas no banco.
-  - `POST /api/keywords` — enfileira uma keyword para processamento pelo serviço Go (retorna 202).
+  - `GET /keywords` — lista keywords persistidas no banco.
+  - `POST /keywords` — enfileira uma keyword para processamento pelo serviço Go (retorna 202).
 
 - Vagas salvas (Saved Jobs)
-  - `GET /api/saved-jobs` — lista vagas salvas do usuário.
-  - `GET /api/saved-jobs/:id` — obtém vaga salva por id.
-  - `POST /api/saved-jobs` — cria nova vaga salva.
-  - `PATCH /api/saved-jobs/:id` — atualiza vaga salva.
-  - `DELETE /api/saved-jobs/:id` — remove vaga salva.
+  - `GET /saved-jobs` — lista vagas salvas do usuário.
+  - `GET /saved-jobs/:id` — obtém vaga salva por id.
+  - `POST /saved-jobs` — cria nova vaga salva.
+  - `PATCH /saved-jobs/:id` — atualiza vaga salva.
+  - `DELETE /saved-jobs/:id` — remove vaga salva.
 
 Observações de segurança nas rotas:
 
-- Rotas sob `/api/users`, `/api/jobs`, `/api/keywords` e `/api/saved-jobs` usam `withSession` + `requireAuth` (quando aplicável).
+- Rotas sob `/users`, `/jobs`, `/keywords` e `/saved-jobs` usam `withSession` + `requireAuth` (quando aplicável).
 - `auth` usa `withSession` para armazenar OAuth state e criar sessão.
 
 ## Variáveis de ambiente importantes

BACKEND.md

@@ -149,45 +149,45 @@ Os comandos abaixo existem hoje no repositório e foram conferidos nos package.j
 
 ## API backend (estado atual)
 
-Base: /api
+Base: /
 
 Sistema:
 
-- GET /api/health
+- GET /health
 
 Autenticação:
 
-- GET /api/auth/:provider/url
-- GET /api/auth/:provider/callback
-- POST /api/auth/register
-- POST /api/auth/login
-- POST /api/auth/logout
-- GET /api/auth/me
+- GET /auth/:provider/url
+- GET /auth/:provider/callback
+- POST /auth/register
+- POST /auth/login
+- POST /auth/logout
+- GET /auth/me
 
 Usuários:
 
-- GET /api/users/profile
-- PATCH /api/users/profile
-- GET /api/users/preferences
-- POST /api/users/preferences
-- PATCH /api/users/preferences
+- GET /users/profile
+- PATCH /users/profile
+- GET /users/preferences
+- POST /users/preferences
+- PATCH /users/preferences
 
 Jobs:
 
-- GET /api/jobs/search
+- GET /jobs/search
 
 Keywords:
 
-- GET /api/keywords
-- POST /api/keywords
+- GET /keywords
+- POST /keywords
 
 Saved jobs:
 
-- GET /api/saved-jobs
-- GET /api/saved-jobs/:id
-- POST /api/saved-jobs
-- PATCH /api/saved-jobs/:id
-- DELETE /api/saved-jobs/:id
+- GET /saved-jobs
+- GET /saved-jobs/:id
+- POST /saved-jobs
+- PATCH /saved-jobs/:id
+- DELETE /saved-jobs/:id
 
 Swagger:
 

README.md

@@ -34,21 +34,21 @@ Validar o comportamento real da aplicacao no estado atual do codigo, cobrindo fr
 
 ### Backend implementado
 
-- GET /api/health publico.
+- GET /health publico.
 - Rotas de auth:
-1. GET /api/auth/:provider/url
-2. GET /api/auth/:provider/callback
-3. POST /api/auth/register
-4. POST /api/auth/login
-5. POST /api/auth/logout
-6. GET /api/auth/me
+1. GET /auth/:provider/url
+2. GET /auth/:provider/callback
+3. POST /auth/register
+4. POST /auth/login
+5. POST /auth/logout
+6. GET /auth/me
 - Rotas protegidas por sessao + requireAuth:
-1. GET /api/jobs/search
-2. GET /api/keywords
-3. POST /api/keywords
-4. GET/PATCH /api/users/profile
-5. GET/POST/PATCH /api/users/preferences
-6. GET/GET:id/POST/PATCH:id/DELETE:id /api/saved-jobs
+1. GET /jobs/search
+2. GET /keywords
+3. POST /keywords
+4. GET/PATCH /users/profile
+5. GET/POST/PATCH /users/preferences
+6. GET/GET:id/POST/PATCH:id/DELETE:id /saved-jobs
 
 ### Diferencas reais entre frontend e backend atual
 

TESTING.md

@@ -65,4 +65,8 @@ GITHUB_CLIENT_ID=
 GITHUB_CLIENT_SECRET=
 
 # Scraper Go service URL
-GO_SCRAPER_URL=http://localhost:8081
+GO_SCRAPER_URL=http://localhost:8081
+
+
+SCRAPER_URL=http://scraper-go:8081
+PROMETHEUS_URL=http://prometheus:9090

backend/.env.example

@@ -7,6 +7,10 @@ COPY package*.json ./
 COPY backend/package*.json ./backend/
 
 # Instala tudo com workspaces (tsx vem da raiz)
+RUN npm config set fetch-retries 5 \
+  && npm config set fetch-retry-factor 2 \
+  && npm config set fetch-retry-mintimeout 20000 \
+  && npm config set fetch-retry-maxtimeout 120000
 RUN npm ci --workspace=backend --include-workspace-root
 
 # Copia o código do backend
@@ -18,4 +22,4 @@ EXPOSE 3001
 
 # Roda a partir da pasta do workspace
 WORKDIR /app/backend
-CMD ["npx", "tsx", "src/server.ts"]
+CMD ["npx", "tsx", "src/server.ts"]

backend/Dockerfile

@@ -0,0 +1,22 @@
+meta {
+  name: Update Role
+  type: http
+  seq: 2
+}
+
+patch {
+  url: {{base_url}}/admin/users/01cac0ad-01a3-4e1b-8afb-c262031956f9/role
+  body: json
+  auth: inherit
+}
+
+body:json {
+  {
+    "role": "super_admin"
+  }
+}
+
+settings {
+  encodeUrl: true
+  timeout: 0
+}

backend/bruno/Admin/Update Role.bru

@@ -0,0 +1,20 @@
+meta {
+  name: Users
+  type: http
+  seq: 1
+}
+
+get {
+  url: {{base_url}}/admin/users
+  body: json
+  auth: none
+}
+
+headers {
+  Cookie: {{sessionCookie}}
+}
+
+settings {
+  encodeUrl: true
+  timeout: 0
+}

backend/bruno/Admin/Users.bru

@@ -0,0 +1,8 @@
+meta {
+  name: Admin
+  seq: 4
+}
+
+auth {
+  mode: inherit
+}

backend/bruno/Admin/folder.bru

@@ -12,8 +12,8 @@ post {
 
 body:json {
   {
-    "email":"hudsonteste@email.com",
-    "password":"teste1234"
+    "email":"hudsontavares@gmail.com",
+    "password":"tavares10"
   }
 }