Painel Administrativo

Todo app publicado no Proyecta já vem com um painel administrativo — um back office privado, protegido por login, onde você gerencia seu conteúdo e envios de formulários sem tocar no código.

A face pública do seu app é única e fiel à sua marca. Por trás dela, todo app precisa do mesmo back office essencial (ainda que pouco glamouroso): um lugar para editar conteúdo, revisar leads e tocar o dia a dia. O Proyecta constrói isso para você a partir de componentes baseados em schema e gerenciados pelo template, garantindo consistência e correção em todos os apps — e você nunca precisa esperar que a IA monte uma tela de CRUD do zero.

O que você pode gerenciar

Seção	O que faz	Status
Conteúdo	Criar, editar, publicar e arquivar entradas em cada uma das suas coleções	Disponível
Envios de formulários	Revisar, marcar como lido e arquivar envios dos seus formulários	Disponível
Pedidos do Commerce	Revisar e processar pedidos da sua loja	Disponível
Membros / usuários	Gerenciar as pessoas que fizeram login no seu app e seus papéis	Disponível

Quais seções você vê depende do que o seu app faz — o painel lê a estrutura ao vivo do seu app e renderiza apenas o que se aplica. Um app sem loja não tem seção de Pedidos.

Quem pode acessar

O painel é protegido por RBAC. Um visitante precisa estar logado com uma conta de admin para acessá-lo — toda ação administrativa é verificada no servidor, não apenas ocultada na interface.

O acesso de admin é concedido ao e-mail que você designa quando o app é criado, conferido com o endereço verificado do provedor de identidade. Ele não é entregue a quem fizer login primeiro — em um app normal, todos os demais entram como usuários comuns, inclusive quem visitar antes de todos. Veja Usuários & Autenticação para entender como o login funciona e como os papéis são atribuídos.

Os blocos de construção

O painel é montado a partir de componentes gerenciados pelo template. Você não os escreve — eles fazem parte de todo app — mas é útil conhecer os principais:

Componente	O que oferece
`CollectionManager`	Uma tela administrativa completa para uma coleção: uma lista pesquisável e ordenável, além de um formulário de criação/edição gerado automaticamente. Um por coleção.
`SubmissionsInbox`	A caixa de entrada dos formulários: abas Novo / Lido / Arquivado, um badge de não lidos e uma visualização detalhada por envio.
`AdminShell`	O visual que envolve tudo — uma barra lateral recolhível e uma barra superior que une todas as seções.

CollectionManager: CRUD automático a partir do seu schema

O CollectionManager lê o schema de uma coleção e constrói toda a experiência de edição com praticamente nenhum código escrito manualmente:

Lista suas entradas em uma tabela com badge de status, busca e um botão New.
Gera o formulário automaticamente a partir do tipo de cada campo — campos de texto viram inputs, textos longos viram textareas, números viram inputs numéricos, valores on/off viram switches, campos de escolha viram dropdowns, datas viram date pickers, referências viram um seletor sobre a coleção vinculada e campos de imagem ganham um botão de upload (com seletor de biblioteca de mídia e opção de colar uma URL).
Salva como rascunho primeiro — publicar é uma ação explícita e separada, para que nada vá ao ar por acidente. Você também pode despublicar ou arquivar uma entrada (arquivar é uma exclusão suave — a entrada desaparece do app e do painel, mas não é destruída).
Também lida com conteúdo avulso: coleções singleton (como as informações da sua empresa) renderizam o formulário diretamente, sem lista.

A edição é genuinamente no-code: você (ou qualquer pessoa que você tornar administradora) altera textos, preços, fotos e horários pelo painel, clica em publish e o app ao vivo é atualizado.

Nota: Produtos do Commerce são gerenciados com as ferramentas de commerce, não em um CollectionManager — mesmo que o catálogo seja conteúdo. Veja Commerce.

Como o painel é construído

Você não precisa pedir, e a IA não o escreve à mão. O painel é um “painel permanente” autoconfigurável: um /admin fixo incorporado ao template de todo app, que lê o schema de conteúdo ao vivo do seu app e a configuração de capacidades, e se renderiza sozinho — sem nenhuma configuração pela IA. Adicione uma nova coleção depois e ela aparece automaticamente, sem necessidade de rebuild.

Além de conteúdo e envios de formulários, surgem seções para tudo o que o seu app realmente faz — pedidos e devoluções, reservas e agendamentos, membros e papéis, uma biblioteca de mídia, e-mail e push. Você recebe as que se aplicam ao seu app e nenhuma das que não se aplicam.

Como ele pertence ao template, mantém-se consistente e correto em todos os apps, e não pode divergir nem quebrar quando a IA edita suas páginas públicas. Se mais tarde você quiser mudar o próprio console, é só pedir — essa é uma edição explícita, não algo que a primeira construção improvisa.

Padrões comuns

Você nunca precisa pedir o painel administrativo em si — todo app já vem com ele, e novas coleções aparecem lá sozinhas. O que vale a pena pedir à IA:

"Add a 'featured' toggle to my services so I can choose what shows on the homepage." — novos campos aparecem no painel automaticamente.
"Make the headline and hours on my homepage editable from the admin." — move o texto fixo no código para o conteúdo.
"Build me a back-office page showing this week's bookings at a glance." — uma página sob medida composta a partir dos mesmos blocos de construção.

Relacionados

Gerenciamento de Conteúdo — as coleções e entradas que o painel edita.
Formulários — a origem da caixa de entrada de envios.
Usuários & Autenticação — como o login funciona e como o papel de admin é concedido.
Commerce — gerencie seu catálogo e pedidos.