COMO PUBLICAR NO CPANEL
========================

1) No cPanel, abra o "Gerenciador de Arquivos" (File Manager) e entre na
   pasta pública do site (geralmente public_html, ou uma subpasta dela
   se o painel vai ficar em um endereço tipo seusite.com.br/painel).

2) Envie estes itens para essa pasta, mantendo a estrutura:
     gestao-prazos-obras.html
     oficios.php
     api.php
     admin/                (pasta inteira: index.html e add-oficio.php)
     data/                 (pasta inteira: oficios.json, overrides.json e .htaccess)

   Dica: pode enviar o .zip e usar a opção "Extract" do próprio
   Gerenciador de Arquivos do cPanel - ele já extrai preservando as pastas.

3) Dê permissão de escrita nos arquivos que o sistema atualiza sozinho:
     - data/               -> permissão 755 (ou 775, se 755 não bastar)
     - data/oficios.json   -> permissão 644 (ou 664)
     - data/overrides.json -> permissão 644 (ou 664)
   Clique com o botão direito no arquivo/pasta > Permissions (Permissões).

4) PROTEJA A PASTA "admin" COM SENHA (só você deve acessá-la):
     a. No cPanel, procure por "Diretórios Protegidos por Senha"
        (em inglês: "Directory Privacy" ou "Password Protect Directories").
     b. Navegue até a pasta admin/ dentro do seu site e selecione-a.
     c. Marque a opção para proteger o diretório, dê um nome
        (ex.: "Área administrativa") e clique em salvar.
     d. Na mesma tela (ou logo em seguida), crie um usuário e uma senha
        de acesso a essa pasta.
     e. A partir daí, sempre que alguém tentar abrir
        seusite.com.br/admin/, o navegador vai pedir usuário e senha
        antes de mostrar qualquer coisa. Sem a senha, ninguém consegue
        ver o formulário nem cadastrar ofícios.

   Isso é feito inteiramente pelo próprio cPanel - não precisa mexer em
   nenhum arquivo para configurar a senha.

5) Acesse gestao-prazos-obras.html pelo navegador para ver o painel
   normalmente (esse endereço continua público, sem senha).
   Para cadastrar ofícios novos, acesse seusite.com.br/admin/ e
   informe o usuário e senha que você criou no passo 4.

REQUISITOS
----------
- Hospedagem com PHP (qualquer cPanel padrão já tem). Não precisa de
  banco de dados - os dados ficam guardados em arquivos .json dentro
  da pasta "data".

COMO FUNCIONA A SEPARAÇÃO DE ACESSOS
--------------------------------------
- gestao-prazos-obras.html  -> página pública, qualquer um pode ver.
- oficios.php               -> devolve a lista de ofícios (leitura
                                pública, usada pela própria página).
- api.php                   -> grava/lê as marcações de "concluído" e
                                observações (pública para leitura e
                                gravação - qualquer pessoa que usa o
                                painel pode marcar um ofício, mas
                                precisa informar o nome dela).
- admin/index.html          -> formulário para cadastrar ofício novo.
- admin/add-oficio.php      -> grava o ofício novo em data/oficios.json.
  Esses dois últimos ficam protegidos por senha (passo 4 acima), então
  só quem tiver o usuário e senha consegue cadastrar ofícios novos.

SOBRE A PASTA "data"
---------------------
O arquivo data/.htaccess bloqueia o acesso direto de qualquer pessoa
aos arquivos .json pelo navegador (ex: seusite.com.br/data/oficios.json
deve dar erro 403). Só o oficios.php, api.php e admin/add-oficio.php
conseguem ler/gravar esses arquivos, cada um fazendo sua parte.

ATUALIZANDO OFÍCIOS
---------------------
- Para incluir um ofício novo: use o formulário em admin/ (com senha).
- Não é mais necessário gerar um HTML novo a cada atualização - a
  tabela sempre lê data/oficios.json na hora que a página é aberta.
- As marcações de "concluído" e as observações (data/overrides.json)
  são vinculadas à posição do ofício na lista (0, 1, 2...). Como o
  formulário sempre adiciona no fim da lista, as marcações já feitas
  continuam corretas mesmo depois de novos cadastros.