Documentação consolidada em um único arquivo: veja
DOCUMENTACAO.md.
Dashboard interativo completo para Análise de Pontos de Função (APF), desenvolvido com Nuxt 4, TypeScript e Tailwind CSS. Ferramenta moderna e bem documentada para medição, estimativa e gestão de projetos de software usando a metodologia padronizada de Pontos de Função.
Este dashboard foi completamente reformulado a partir do projeto AFP original, trazendo:
- ✅ Arquitetura Moderna: Nuxt 4 com estrutura
app/directory - ✅ TypeScript: Tipagem completa para maior segurança
- ✅ Design Responsivo: Interface adaptável para todos os dispositivos
- ✅ Navbar Superior: Navegação intuitiva e moderna
- ✅ Rodapé Organizado: Informações e links úteis
- ✅ Componentização: Código modular e reutilizável
- ✅ Documentação Completa: Tudo em um único lugar
- Nuxt 4 - Framework Vue.js para aplicações web
- Vue 3 - Framework JavaScript progressivo
- TypeScript - JavaScript com tipagem estática
- Tailwind CSS - Framework CSS utilitário
- Nuxt Icon - Ícones para Nuxt
- Chart.js - Biblioteca para gráficos (preparado para uso futuro)
AFPNuxt4/
├── app/
│ ├── assets/
│ │ └── css/
│ │ └── main.css # Estilos globais (arquivo único)
│ ├── components/
│ │ ├── AppNavbar.vue # Navbar superior com menu responsivo
│ │ └── AppFooter.vue # Rodapé com informações e links
│ ├── composables/
│ │ └── useAPF.ts # Lógica de cálculos APF (IFPUG/SISP)
│ ├── layouts/
│ │ └── default.vue # Layout padrão com navbar e rodapé
│ ├── pages/
│ │ ├── index.vue # Página inicial - Visão geral
│ │ ├── calculadora.vue # Calculadora de projeto
│ │ ├── como-funciona.vue # Explicação do processo de contagem
│ │ └── referencias.vue # Tabelas e fórmulas de referência
│ ├── types/
│ │ └── apf.ts # Tipos TypeScript para APF
│ └── app.vue # Componente raiz da aplicação
├── public/ # Arquivos estáticos
├── .gitignore # Arquivos ignorados pelo Git
├── nuxt.config.ts # Configuração do Nuxt
├── package.json # Dependências do projeto
├── tailwind.config.ts # Configuração do Tailwind CSS
├── tsconfig.json # Configuração do TypeScript
├── DOCUMENTACAO.md # Documentação consolidada
└── README.md # Este arquivo (visão geral)
- Node.js 18+ instalado
- npm, yarn ou pnpm
- Clone ou navegue até o diretório do projeto
cd AFPNuxt4- Instale as dependências
npm install
# ou
yarn install
# ou
pnpm install- Execute o servidor de desenvolvimento
npm run dev
# ou
yarn dev
# ou
pnpm dev- Acesse no navegador
Abra http://localhost:3000 para ver a aplicação.
- Introdução à Análise de Pontos de Função
- Principais benefícios da metodologia
- Acesso rápido a todas as ferramentas
- Explicação do processo de contagem
- Diferença entre funções de dados (ALI/AIE) e transação (EE/SE/CE)
- Roteiro da Fiocruz e ordem de precedência
- Dicas didáticas (ex: Regra do Carro)
- Adicione funções ao projeto (EE, SE, CE, ALI, AIE)
- Cálculo automático de complexidade
- Visualização do tamanho total em PF
- Exemplo pré-carregado (SGAB)
- Fórmulas essenciais de estimativa
- Tabela de pontuação por tipo e complexidade
- Matrizes de complexidade (ALI/AIE, EE, SE/CE)
- Fatores de ponderação
O dashboard implementa as seguintes normas e padrões:
- IFPUG CPM 4.3.1 - Manual de Práticas de Contagem
- Roteiro SISP v2.3 - Roteiro de Métricas de Software
- ISO/IEC 20926 - Padrão internacional para medição funcional
- ALI (Arquivo Lógico Interno): Dados mantidos dentro da aplicação
- AIE (Arquivo de Interface Externa): Dados referenciados, mas mantidos fora
- EE (Entrada Externa): Processa dados que entram na aplicação
- SE (Saída Externa): Envia dados com lógica de processamento
- CE (Consulta Externa): Recuperação e apresentação direta de dados
A complexidade é determinada por:
- TDEs (Tipos de Dados Elementares): Campos únicos reconhecidos pelo usuário
- TRs (Tipos de Registro): Subgrupos de dados dentro de um ALI/AIE
- ARs (Arquivos Referenciados): Arquivos lidos ou mantidos pela função
O projeto usa uma paleta de cores baseada em Teal (Primary). Para alterar, edite tailwind.config.ts:
colors: {
primary: {
// Suas cores aqui
}
}Classes utilitárias personalizadas estão em app/assets/css/main.css:
.btn-primary- Botão primário.btn-secondary- Botão secundário.card- Card com sombra e borda.input-field- Campo de entrada estilizado.section-title- Título de seção.subsection-title- Subtítulo
# Desenvolvimento
npm run dev
# Build para produção
npm run build
# Gerar site estático
npm run generate
# Preview da build de produção
npm run preview
# Preparar tipos TypeScript
npm run postinstallnpm run buildnpm run generateOs arquivos serão gerados na pasta .output/public/ e podem ser hospedados em qualquer servidor estático.
- Vercel: Deploy automático via Git
- Netlify: Suporte nativo para Nuxt
- Cloudflare Pages: Deploy rápido e global
- Servidor Node.js: Use
npm run builde execute o servidor
Contribuições são bem-vindas! Para contribuir:
- Fork o projeto
- Crie uma branch para sua feature (
git checkout -b feature/MinhaFeature) - Commit suas mudanças (
git commit -m 'Adiciona MinhaFeature') - Push para a branch (
git push origin feature/MinhaFeature) - Abra um Pull Request
Este projeto é de uso interno e educacional.
Desenvolvido para facilitar a gestão de projetos de software através da metodologia de Análise de Pontos de Função.
- Documentação Nuxt 4
- IFPUG - International Function Point Users Group
- Roteiro de Métricas SISP
- ISO/IEC 20926
Para dúvidas ou sugestões sobre o dashboard, entre em contato com a equipe de desenvolvimento.
Dashboard APF - Transformando a medição de software em uma ferramenta estratégica de gestão.