Skip to content

Commit 4cac491

Browse files
docs: adiciona seção de integração com bitsark-web
1 parent 63085c9 commit 4cac491

1 file changed

Lines changed: 36 additions & 1 deletion

File tree

docs/MAINTENANCE.md

Lines changed: 36 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -222,6 +222,41 @@ headers: { "X-Internal-Token": process.env.BITSARK_INTERNAL_TOKEN }
222222

223223
---
224224

225+
## 🔗 Integração com bitsark-web
226+
227+
Ao final do `scrape-fees.yml`, um evento `repository_dispatch` é enviado para o
228+
repo [`bitsark-web`](https://github.com/bitsARK-Labs/bitsark-web) com o tipo
229+
`exchanges-data-updated`. Isso aciona um commit vazio no `main` do `bitsark-web`,
230+
que por sua vez acorda o **Cloudflare Pages** para um rebuild automático do site Astro.
231+
Durante o build, o site faz `fetch` na API e gera as páginas estáticas atualizadas.
232+
233+
### Fluxo completo
234+
235+
```
236+
scrape-fees.yml (este repo) conclui com sucesso
237+
└→ POST para github.com/repos/bitsARK-Labs/bitsark-web/dispatches
238+
└→ deploy.yml do bitsark-web é acionado
239+
└→ commit vazio no main do bitsark-web
240+
└→ Cloudflare Pages detecta → astro build → deploy ✓
241+
```
242+
243+
### Secret necessário neste repo
244+
245+
| Secret | Descrição |
246+
|---|---|
247+
| `BITSARK_WEB_DEPLOY_TOKEN` | Fine-grained PAT com `Actions: Read and write` no repo `bitsark-web`. Permite disparar o `repository_dispatch`. |
248+
249+
### Se o token expirar
250+
251+
Se o rebuild automático parar de funcionar após uma quarta-feira, verifique se o token
252+
expirou em **github.com → Settings → Developer settings → Fine-grained tokens**.
253+
Para recriar, siga as instruções em `bitsark-web/docs/WORKFLOWS.md`.
254+
255+
> O deploy manual do `bitsark-web` continua funcionando normalmente mesmo se o token
256+
> expirar — apenas o trigger automático pára.
257+
258+
---
259+
225260
## 🗂️ Lista de todas as corretoras no dataset
226261

227262
| # | ID | Nome | Regime Fiscal BR | Pix | Página de Taxas |
@@ -271,4 +306,4 @@ Clique em **Details** ao lado do check vermelho para ver o erro. Geralmente é u
271306
Não. Só atualize as que tiveram mudança de taxa. Mas **sempre atualize o `updated_at`** de todas as que você verificou, mesmo que os valores não tenham mudado — isso reseta o contador de staleness.
272307

273308
**Como faço para rotacionar o `DOLARMAP_SECRET`?**
274-
Gere um novo token com `node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"`, rode `wrangler secret put DOLARMAP_SECRET` e atualize a variável de ambiente no app DolarMap. O token antigo deixa de funcionar imediatamente após o redeploy do worker.
309+
Gere um novo token com `node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"`, rode `wrangler secret put DOLARMAP_SECRET` e atualize a variável de ambiente no app DolarMap. O token antigo deixa de funcionar imediatamente após o redeploy do worker.

0 commit comments

Comments
 (0)