@hed-hog/developer-mode 0.0.273 → 0.0.275

package/README.md

@@ -1,3 +1,4 @@
+```markdown
 # @hed-hog/developer-mode
 
 ## 1. Visão geral do módulo
@@ -226,6 +227,17 @@ Este módulo não define tabelas de banco de dados próprias. As permissões sã
 
 ### role.yaml
 
+- **Finalidade:** Define o papel de administrador do modo desenvolvedor com acesso total às funcionalidades do módulo.
+- **Colunas:**
+  - `slug` (string): Identificador único do papel.
+  - `name` (objeto): Nome do papel em inglês e português.
+  - `description` (objeto): Descrição do papel em inglês e português.
+- **Defaults:** Não aplicável.
+- **Nulabilidade:** Todos os campos obrigatórios.
+- **Integridade:** `slug` único.
+- **Índices:** Índice único em `slug`.
+- **Enums:** Não aplicável.
+
 ```yaml
 - slug: admin-developer-mode
   name:
@@ -238,6 +250,17 @@ Este módulo não define tabelas de banco de dados próprias. As permissões sã
 
 ### route.yaml
 
+- **Finalidade:** Define a rota protegida `/developer-mode` para acesso restrito aos papéis `admin` e `admin-developer-mode`.
+- **Colunas:**
+  - `url` (string): Caminho da rota.
+  - `method` (string): Método HTTP.
+  - `relations` (objeto): Relação com papéis autorizados.
+- **Defaults:** Não aplicável.
+- **Nulabilidade:** Todos os campos obrigatórios.
+- **Integridade:** Associação correta com papéis existentes.
+- **Índices:** Índice em `url` e `method`.
+- **Enums:** Não aplicável.
+
 ```yaml
 - url: /developer-mode
   method: GET
@@ -264,9 +287,14 @@ Este módulo não define tabelas de banco de dados próprias. As permissões sã
 
 - A execução de scripts é feita via `pnpm run <script>`, com múltiplos fallbacks para garantir compatibilidade em diferentes ambientes (Windows, Linux, etc).
 - A saída dos scripts é transmitida em tempo real via SSE, com eventos estruturados para facilitar o consumo no frontend.
-- O status dos apps é detectado tentando uma requisição HEAD na porta padrão associada a cada app.
-- Informações do banco de dados são extraídas de arquivos `.env` e `docker-compose.yaml` para identificar conexão e estado.
-- Informações do Git são obtidas via comandos Git, incluindo branch atual, número de branches, PRs abertos e últimos commits.
+- O status dos apps é detectado tentando uma requisição HEAD na porta padrão associada a cada app:
+  - `admin`: porta 3200
+  - `web`: porta 3000
+  - `api`: porta 3100
+- Informações do banco de dados são extraídas de arquivos `.env` e `docker-compose.yaml` para identificar conexão e estado, incluindo número de tabelas, tamanho e conexões ativas.
+- Informações do Git são obtidas via comandos Git, incluindo branch atual, número de branches, PRs abertos (via GitHub CLI se disponível) e últimos commits.
+- O uptime do projeto é estimado com base na data de criação do diretório da API.
+- A validação de scripts e alvos impede execução de scripts não autorizados ou inexistentes.
 
 ## 9. Guia rápido de uso (exemplos)
 
@@ -298,7 +326,7 @@ A resposta será um fluxo SSE com eventos `start`, `output`, `error` e `end`.
 
 ```
 event: start
-data: {"message":"Starting app script dev (apps/admin)...","timestamp":"2024-06-01T12:00:00.000Z"}
+data: {"message":"Starting app script dev (admin)...","timestamp":"2024-06-01T12:00:00.000Z"}
 
 event: output
 data: {"message":"[HedHog] Working directory: /path/to/apps/admin","timestamp":"2024-06-01T12:00:01.000Z"}
@@ -316,3 +344,4 @@ data: {"success":true,"timestamp":"2024-06-01T12:05:00.000Z"}
 ---
 
 Este módulo é essencial para desenvolvedores que desejam monitorar e interagir com o ambiente de desenvolvimento do monorepo HedHog de forma segura e eficiente.
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/developer-mode",
-  "version": "0.0.273",
+  "version": "0.0.275",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -9,11 +9,11 @@
     "@nestjs/core": "^11",
     "@nestjs/jwt": "^11",
     "@nestjs/mapped-types": "*",
+    "@hed-hog/api-prisma": "0.0.5",
     "@hed-hog/api": "0.0.4",
-    "@hed-hog/api-locale": "0.0.13",
-    "@hed-hog/core": "0.0.273",
+    "@hed-hog/core": "0.0.275",
     "@hed-hog/api-pagination": "0.0.6",
-    "@hed-hog/api-prisma": "0.0.5"
+    "@hed-hog/api-locale": "0.0.13"
   },
   "exports": {
     ".": {