bac-fe-repogen

Interface web do Bacalhau para gerar repositórios via API bac-api-repogen.

Stack

• React + Vite
• React Router DOM
• TypeScript
• Tailwind CSS

Funcionalidades

🏠 Tela Inicial

• Lista de Projetos: Visualização de todos os projetos criados
• Status dos Projetos: Indicadores visuais para projetos concluídos, em progresso ou com falha
• Botão de Criação: Acesso rápido ao assistente de criação de novos projetos
• Interface Responsiva: Design moderno e adaptável para diferentes dispositivos

🔧 Assistente Passo a Passo

Fluxo de oito telas que chamam a API de geração de repositório:

1. Inicializar repositório – POST /repository/init
2. Configuração inicial – POST /setup
3. Extração do banco – POST /database/extract
4. Gerar módulo – POST /module/generate
5. Gerar API – POST /api/generate
6. Finalizar geração – POST /finalize
7. Pipeline completo – POST /pipeline/full
8. Geração final – POST /generate

✨ Recursos Adicionais

• Navegação Intuitiva: Botões de voltar, próximo e cancelar
• Barra de Progresso: Indicador visual do progresso no wizard
• Validação de Formulários: Verificação de campos obrigatórios
• Feedback Visual: Estados de carregamento e mensagens de erro
• API mock integrada para testes locais em http://localhost:3333

Como executar

Método Principal: Makefile (Recomendado)

Primeira execução

# Instalar todas as dependências
make install-all

# Iniciar servidores em background
make start-all

# Verificar status
make status

Desenvolvimento diário

# Iniciar servidores
make start-all

# Monitorar logs
make logs-all

# Parar servidores
make kill-all

Comandos úteis

make help        # Ver todos os comandos disponíveis
make status      # Verificar status dos serviços
make vite-logs   # Logs do frontend
make mock-logs   # Logs da API mock

Método Alternativo: Docker

docker compose up

URLs dos Serviços

• Interface web: http://localhost:3000 (ou 3001 se 3000 estiver ocupada)
• API mock: http://localhost:3333

Utilização do fluxo

1. Acesse a tela inicial e visualize seus projetos existentes
2. Clique em "Novo Projeto" para iniciar o assistente
3. Siga os passos em sequência preenchendo as informações necessárias
4. Monitore o progresso através da barra de progresso
5. Complete a geração e seja redirecionado para a tela inicial

Estrutura do Projeto

src/
├── components/
│   ├── steps/           # Componentes dos passos do wizard
│   └── ExampleComponent.tsx
├── pages/
│   ├── HomePage.tsx     # Tela inicial com lista de projetos
│   └── WizardPage.tsx   # Página do assistente
├── dto/                 # Interfaces TypeScript para API
├── main.tsx            # Ponto de entrada com roteamento
└── index.css           # Estilos globais (Tailwind)

Documentação de Engenharia

Consulte PROMPTING.md para:

• Instruções detalhadas de uso do Makefile
• Fluxo de desenvolvimento recomendado
• Comandos de gerenciamento de servidores

Testes E2E

Execute make test para rodar o script de testes automatizados com Puppeteer. O front-end e a API mock serão iniciados temporariamente.

Padrão de prompts

Consulte o arquivo PROMPTING.md para detalhes sobre a estrutura de prompts utilizada.

📜 Licença

Este projeto está licenciado sob a MIT.