docs: documenta navegador de arquivos e sandbox de escrita (+ remove fallback os.execute)

- README.md / README.en.md / MANUAL.md: secao do navegador de arquivos
  explicando que escrita cross-resource exige add_filesystem_permission no
  server.cfg (sandbox do FiveM > 25770; sem wildcard, sem convar global)
- remove o fallback de escrita via os.execute (confirmado que tambem nao
  contorna o sandbox e so adicionava overhead); escrita usa so SaveResourceFile

Author: ggfto

MANUAL.md

@@ -54,7 +54,17 @@ Visualização da tela de jogadores em tempo real para monitoramento. Suporte a
 Sistema de logs com persistência em banco de dados, buffer em memória, webhooks Discord por categoria e filtros por resource. Configurável via painel sem reiniciar o resource.
 
 ### Recursos
-Listagem de todos os resources do servidor com controle de start/stop.
+Listagem de todos os resources do servidor com controle de **start/stop/restart**, ações rápidas por item, filtros por estado (rodando/parados) e um **navegador de arquivos**: explorar pastas, abrir e **editar arquivos de texto** em tempo real, além de criar e excluir arquivos/pastas.
+
+> **Importante — escrita e o sandbox do FiveM.** A partir dos artifacts > 25770, o FiveM bloqueia por padrão a escrita de um resource em arquivos de **outro** resource (proteção contra malware). A **leitura/navegação funciona em todos os resources**, mas **salvar/criar/excluir** só funciona:
+> - nos arquivos do **próprio `mri_Qadmin`**; ou
+> - em resources liberados explicitamente no `server.cfg`:
+>   ```
+>   add_filesystem_permission mri_Qadmin write <nome_do_resource>
+>   ```
+>   Uma linha **por resource** (o FiveM não suporta wildcard). Depois **reinicie o `mri_Qadmin`** para reavaliar.
+>
+> Quando o resource não é gravável, o painel exibe um aviso **"somente leitura"** com a linha exata do `add_filesystem_permission` e desabilita os controles de escrita. A exclusão exige as permissões `qadmin.action.change_resource` **e** `qadmin.action.resource_delete`.
 
 ### Configurações
 Editor visual de configurações sem precisar editar arquivos. Altera clima, hora, tema e integrações.

README.en.md

@@ -57,6 +57,29 @@ Master Admin (console bypass)
 | `mri_qadmin.debugperms [id]` | Show detailed permission debug for a player |
 | `mri_qadmin.inspectdb` | Inspect permission tables in the DB |
 
+## Resource File Browser
+
+The **Resources** page includes a browser to explore, open and **edit text files** of any resource, plus create/delete files and folders — straight from the panel.
+
+### Writing and the FiveM sandbox (must read)
+
+Since artifacts **> 25770**, FiveM **blocks by default** a resource from writing to **another** resource's files (anti-malware protection). This affects the browser:
+
+- **Reading/browsing** works for **all** resources.
+- **Saving / creating / deleting** only works:
+  - on **`mri_Qadmin`'s own** files; or
+  - on resources **explicitly allowed** in `server.cfg`.
+
+To allow editing a resource, add this to `server.cfg` (then restart `mri_Qadmin`):
+
+```cfg
+add_filesystem_permission mri_Qadmin write resource_name
+```
+
+> One line **per resource** — FiveM does **not** support wildcards (`*`), and there is **no** convar to disable the sandbox globally. Reverting to artifacts ≤ 25770 unlocks it but is a security regression and is not recommended.
+
+When a resource isn't writable, the panel shows a **"read-only"** notice with the exact line to add and disables the write controls. Write actions require the `qadmin.action.change_resource` permission; deletion also requires `qadmin.action.resource_delete`.
+
 ## In-Game Commands
 
 | Command | Requires | Description |

README.md

@@ -53,6 +53,29 @@ Arquivo principal: `shared/config.lua`
 | `Config.PlayerActions` | `{}` | Ações específicas para jogadores |
 | `Config.OtherActions` | `{}` | Outras ações administrativas |
 
+## Navegador de arquivos de recursos
+
+A página **Recursos** inclui um navegador que permite explorar, abrir e **editar arquivos de texto** de qualquer resource, além de criar/excluir arquivos e pastas — direto pelo painel.
+
+### Escrita e o sandbox do FiveM (obrigatório ler)
+
+A partir dos artifacts **> 25770**, o FiveM **bloqueia por padrão** que um resource escreva em arquivos de **outro** resource (proteção contra malware). Isso afeta o navegador:
+
+- **Ler/navegar** funciona em **todos** os resources.
+- **Salvar / criar / excluir** só funciona:
+  - nos arquivos do **próprio `mri_Qadmin`**; ou
+  - em resources **liberados explicitamente** no `server.cfg`.
+
+Para liberar a edição de um resource, adicione no `server.cfg` (e reinicie o `mri_Qadmin`):
+
+```cfg
+add_filesystem_permission mri_Qadmin write nome_do_resource
+```
+
+> Uma linha **por resource** — o FiveM **não** suporta wildcard (`*`), e **não há** convar para desabilitar o sandbox globalmente. Reverter para artifacts ≤ 25770 destrava, mas é uma regressão de segurança e não é recomendado.
+
+Quando um resource não é gravável, o painel mostra um aviso **"somente leitura"** com a linha exata a adicionar e desabilita os controles de escrita. As ações de escrita exigem a permissão `qadmin.action.change_resource`; a exclusão exige também `qadmin.action.resource_delete`.
+
 ## Comandos
 
 | Comando | Quem pode usar | Descrição |

server/resources.lua

@@ -710,36 +710,12 @@ writtenMatches = function(target, text)
     return type(native) == 'string' and sameTextContent(native, text)
 end
 
--- Grava `text` no destino e confirma por releitura. Retorna true se gravou.
---   1) native SaveResourceFile — limpa; bloqueada cross-resource pelo sandbox.
---   2) fallback os.execute (copy/cp): escreve um temp DENTRO do mri_Qadmin (que
---      e sempre gravavel) e copia via shell para o destino. O processo externo
---      do shell NAO passa pela vfs do FiveM, contornando o sandbox.
+-- Grava `text` no destino via native SaveResourceFile e confirma por releitura.
+-- Escrita cross-resource e bloqueada pelo sandbox do FiveM (io cru e os.execute
+-- tambem nao contornam) — so funciona no proprio mri_Qadmin ou com
+-- add_filesystem_permission no server.cfg.
 attemptWrite = function(target, text)
     SaveResourceFile(target.resource, target.relative, text, #text)
-    if writtenMatches(target, text) then
-        return true
-    end
-
-    -- Caminhos com metacaracteres de shell nao vao pro os.execute.
-    if hasShellHazard(target.absolute) then
-        return false
-    end
-
-    local tmpRel = '.qadmin_write_tmp'
-    SaveResourceFile(GetCurrentResourceName(), tmpRel, text, #text)
-    local tmpAbs = normalizeSlashes(GetResourcePath(GetCurrentResourceName()) or '') .. '\\' .. tmpRel
-    if hasShellHazard(tmpAbs) then
-        os.remove(tmpAbs)
-        return false
-    end
-
-    local command = isWindows()
-        and ('cmd /c copy /y %s %s >nul 2>nul'):format(cmdQuote(tmpAbs), cmdQuote(target.absolute))
-        or ('cp -f %s %s >/dev/null 2>&1'):format(cmdQuote(tmpAbs), cmdQuote(target.absolute))
-    os.execute(command)
-    os.remove(tmpAbs)
-
     return writtenMatches(target, text)
 end