Skip to content

senal88/app-tributario

Repository files navigation

Sistema Tributário Full-Stack

Sistema full-stack completo de análise tributária para Grupos Empresariais.

Descrição

Este projeto foi criado para gerenciar análises tributárias de forma integrada e eficiente, oferecendo uma plataforma completa para análise e gestão tributária de grupos empresariais.

Estrutura do Projeto

app-tributario/
├── frontend/                 # React/TypeScript Frontend
│   ├── src/                 # Código fonte
│   ├── package.json         # Dependências Node.js
│   ├── tsconfig.json        # Configuração TypeScript
│   ├── vite.config.ts       # Configuração Vite
│   └── tailwind.config.js   # Configuração Tailwind CSS
├── backend/                 # Node.js/Python Backend
│   ├── src/                 # Código fonte
│   ├── package.json         # Dependências Node.js
│   ├── requirements.txt     # Dependências Python
│   └── tsconfig.json       # Configuração TypeScript
├── docs/                   # Documentação
│   ├── coding-standards.md # Padrões de código
│   ├── DEPLOY.md           # Guia de deploy
│   └── QUICKSTART.md       # Guia rápido
├── scripts/                # Scripts de automação
├── .vscode/                # Configurações VS Code
├── docker-compose.dev.yml  # Docker para desenvolvimento
├── Makefile               # Comandos automatizados
└── env.example            # Variáveis de ambiente

Tecnologias

  • Backend: Python (FastAPI) / Node.js (TypeScript)
  • Frontend: React / TypeScript
  • Banco de Dados: PostgreSQL
  • Infraestrutura: Docker, Traefik
  • Autenticação: 1Password Integration
  • Deploy: Scripts automatizados

Funcionalidades

  • Dashboard de análise tributária
  • Gestão de empresas
  • Upload e processamento de documentos
  • Integração com 1Password para segurança
  • Análise com IA/LLM

🚀 Comandos Rápidos

# Instalar dependências
make install

# Iniciar ambiente de desenvolvimento
make dev

# Executar testes
make test

# Formatar código
make format

# Limpar containers
make clean

# 1Password Integration
make 1password-setup    # Configurar itens nos cofres
make 1password-dev       # Desenvolvimento com segredos (macOS)
make 1password-prod      # Produção com segredos (VPS)

📚 Documentação

Status

✅ Projeto estruturado e padronizado - Pronto para desenvolvimento

Autor

Desenvolvido por senal88


Última atualização: 24/10/2025

About

istema full-stack completo de análise tributária para Grupos Empresarias

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published