Internal Documentation
Bem-vindo à documentação interna de front-end da plataforma Cactus Gaming. Este espaço cobre tudo que o time de desenvolvimento precisa saber para trabalhar no ecossistema de front.
Comece por aqui
:::warning O front-web-base tem várias branches principais
O template roda com trunks paralelas de longa duração (main, main-7k,
main-b, …) e features são portadas entre elas, não mergeadas. Estas docs
descrevem a main-7k. Se você está em outra branch, parte do que está aqui
pode não existir no seu código.
Leia Trunks de marca antes de qualquer outra página de arquitetura. :::
O que você encontra aqui
- Arquitetura — Trunks de marca, visão geral do sistema, multi-tenancy, fluxos de auth e brand, camadas de cache
- SDK (@cactus-agents/*) — Pacotes TypeScript do monorepo
front-cactus-core - Template (front-web-base) — O template React Router v7 que todas as marcas compartilham
- Fork de Marca — Como criar e manter overrides de marca
- Endpoints — Mapa completo da API backend
- Contributing — Setup do ambiente, convenções de código e PRs
Repositórios
Lista viva em feca.yaml na raiz do workspace.
| Repo | Descrição |
|---|---|
front-cactus-core | SDK TypeScript — pacotes @cactus-agents/* |
front-web-base | Template React Router v7 (SSR / Cloudflare Workers) — 13 marcas em overrides/ |
front-cactus-docs | Esta documentação (Docusaurus) |
front-ops | Reusable workflows de deploy + config por brand/repo/ambiente |
front-service-api | Worker proxy da API (Smart Placement + cache por path) |
front-service-api-dev-proxy | Dev proxy (domain remap + auth por dev) |
front-service-api-warmup | Worker de warmup de cache (cron) |
fecadm | Admin CLI + web dashboard (CF workers, Access, Zero Trust) |
front-tests-e2e | Testes E2E Playwright |
Stack principal
| Camada | Tecnologia |
|---|---|
| Framework | React Router v7 (SSR nativo no Cloudflare Workers) |
| Build | Vite |
| Styling | Tailwind CSS v3 + CSS custom properties |
| State (client) | Zustand — stores em app/store/ + useAccountsStore do core |
| State (server) | React Router loaders |
| Ícones | unplugin-icons + datasets Iconify |
| Linter/formatter | Biome |
| Testes | Vitest + React Testing Library |
| Package manager | pnpm (enforced) |
| Node | >=24.0.0 (recomendado: 24.14.1) |