Skip to content

A01 · Bootstrap do front-admin com base_nuxt_modular #49

Closed

Description

@tecrodrigocastro

Contexto

O painel da organização nasce do template base de módulos Nuxt, com o tema Sertão.

Escopo

  • Criar front-admin/ a partir do base_nuxt_modular e remover o que não for usado
  • Configurar TypeScript estrito, ESLint, Prettier, Vitest e Playwright
  • Carregar a fonte Lexend (400, 500, 600) e declarar os tokens do tema como variáveis CSS (--ph-*) em um único arquivo
  • Configurar variáveis de ambiente (NUXT_PUBLIC_API_URL) e proxy local para a API
  • Job de CI: lint, typecheck, testes unitários e build

Critérios de aceite

  • pnpm dev abre o painel contra a API local
  • CI falha em erro de lint, tipo ou teste
  • Trocar os valores de --ph-* muda o visual de todo o painel sem alterar componentes

Notas técnicas

  • Seguir a convenção de módulos do template (app/modules/<nome>) e documentar em front-admin/docs/ARCHITECTURE.md
  • Tema escuro não faz parte do escopo inicial

Definição de pronto

  • Testes passando na CI
  • Lint e análise estática sem erros
  • Documentação atualizada (OpenAPI via Scramble no backend, ou README do módulo no front)
  • Revisado por pelo menos uma pessoa

Activity

  1. moved this from Todo to In Progress in PHPeste Platformon Nov 4, 2026
  2. tecrodrigocastro commented on Nov 4, 2026

    @tecrodrigocastro
    MemberAuthor

    Progresso no PR #1 (merged):

    • front-admin/ criado a partir do base_nuxt_modular, 40 testes do template passando (npm test).
    • .env.example com NUXT_PUBLIC_API_BASE apontando pro backend local.

    Falta pra fechar:

    • Fonte Lexend e tokens do tema Sertão (--ph-*) — ainda não entramos nisso
    • Renomear/ajustar variável de ambiente pro padrão NUXT_PUBLIC_API_URL + proxy local, se for o caso
    • Job de CI (lint, typecheck, testes, build)
    • Remover do template o que não for usado

    Deixando em In Progress.

  3. moved this from In Progress to Done in PHPeste Platformon Nov 4, 2026
  4. tecrodrigocastro commented on Nov 4, 2026

    @tecrodrigocastro
    MemberAuthor

    Pendências fechadas no PR #85:

    • Tema "Sertão" aplicado em app/assets/css/main.css: fonte Lexend + tokens --ph-* oficiais (docs/design/tema-sertao-tokens.png)
    • ESLint via @nuxt/eslint (cobre formatação também, por isso não adicionamos um Prettier separado)
    • NUXT_PUBLIC_API_URL (era NUXT_PUBLIC_API_BASE no template)
    • CI (.github/workflows/front-admin-ci.yml): lint, typecheck, test, build
    • README reescrito pro projeto real; removida a versão pt-BR duplicada do template

    Desvio do escopo original: sem proxy de dev — backend/config/cors.php já libera a origem do front-admin em desenvolvimento, então o HttpClient.ts chama a API direto. Detalhe em docs/adr/0004-bootstrap-front-admin.md. Marcando como Done.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Type

No type

Projects

Relationships

None yet

Development

No branches or pull requests

Issue actions