Threeebs Alpha 02.1 — Arquitetura e Experiência da Plataforma
2026-09-03 21:27:06
Threeebs Alpha 02.1 — Arquitetura e Experiência da Plataforma
Objetivo
Esta sprint tem como objetivo fortalecer a fundação do Threeebs antes de iniciar novas funcionalidades. A prioridade é melhorar a experiência de uso, padronizar a interface e preparar o suporte a domínios personalizados.
Importante:
* Executar uma etapa por vez.
* Aguardar aprovação antes de iniciar a próxima.
* Não alterar a arquitetura existente além do necessário.
* Manter compatibilidade com a estrutura atual do Threeebs.
---
Etapa 01 — Sistema de Jornadas
Objetivo
Criar um sistema de jornadas (onboarding) para acompanhar o progresso de cada usuário dentro da plataforma.
Este sistema deverá servir tanto para:
* Administradores
* Colaboradores
* Clientes
Cada perfil possui uma sequência diferente de etapas.
As jornadas deverão ser armazenadas no banco threeebs_control, pois representam o estado operacional do usuário dentro da plataforma e não tarefas de trabalho.
Requisitos
* Criar estrutura de banco para Jornadas.
* Criar estrutura de banco para Etapas.
* Registrar progresso por usuário.
* Permitir jornadas diferentes para cada perfil.
* Preparar a estrutura para futuras versões das jornadas.
* Não criar interface completa nesta etapa.
* Apenas disponibilizar a lógica necessária para que o painel consiga identificar a próxima etapa do usuário.
Critério de aceite
* Um administrador visualiza sua jornada.
* Um cliente visualiza outra jornada.
* O sistema consegue identificar automaticamente a próxima etapa pendente.
---
Etapa 02 — Padronização Visual
Objetivo
Criar uma base visual simples e reutilizável para o Admin e Portal.
Não criar framework CSS.
Não utilizar Bootstrap.
Não utilizar Tailwind.
Apenas criar uma estrutura organizada para evolução futura.
Estrutura
Cada aplicação deverá possuir:
apps/admin/assets/
apps/portal/assets/Dentro de cada uma:
assets/
css/
base.css
main.cssbase.css
Responsável por:
* Reset básico
* Variáveis CSS
* Tipografia
* Cores globais
* Espaçamentos
* Inputs
* Botões
* Tabelas
* Cards
main.css
Responsável por:
* Layout
* Header
* Sidebar
* Containers
* Componentes da aplicação
Requisitos
Referenciar automaticamente os arquivos CSS nos public/index.php do Admin e Portal.
Não alterar o Sandbox nem o Host nesta etapa.
Critério de aceite
Admin e Portal passam a compartilhar uma identidade visual básica, limpa e consistente, mantendo a possibilidade de CSS específico por aplicação no futuro.
---
Etapa 03 — Domínio Personalizado
Objetivo
Adicionar suporte a domínio personalizado por projeto.
Nesta Alpha, todo o provisionamento será manual.
Não integrar com API da Cloudflare.
Fluxo
- O projeto possui um subdomínio interno da Threeebs.
- Opcionalmente poderá possuir um domínio personalizado.
- A equipe da Threeebs fará manualmente a configuração na Cloudflare.
- A Cloudflare utilizará proxy.
- Não deverá existir redirect.
- O domínio do cliente deverá permanecer na barra do navegador.
Banco
Adicionar ao projeto um campo para domínio personalizado.
O subdomínio continua sendo obrigatório.
O domínio personalizado é opcional.
Garantir unicidade do domínio personalizado.
Host
Atualizar a resolução do projeto para aceitar tanto:
* subdomínio da Threeebs
* domínio personalizado
A resolução deverá utilizar exclusivamente o HTTP_HOST.
Não deverá existir diferença de comportamento entre acessar pelo subdomínio ou pelo domínio personalizado.
Ambos deverão servir exatamente o mesmo projeto.
Importante
A arquitetura deverá permanecer preparada para, futuramente, integrar automaticamente com a API da Cloudflare.
Essa futura automação não deverá exigir alterações na lógica do Host.
A única mudança futura deverá ser a forma como o domínio é provisionado.
Critério de aceite
* O subdomínio continua funcionando.
* O domínio personalizado funciona.
* Ambos apontam para o mesmo projeto.
* O domínio do cliente permanece visível durante toda a navegação.
* A arquitetura continua simples e preparada para evolução futura.