Desenvolvimento de Plataforma de Controle Financeiro com Automação de Notas Fiscais e Boletos

Projeto: Painel Financeiro Automático — NFS-e + Boletos Itaú
Empresa: Strucon Engenharia · Florianópolis/SC
Publicação para: Workana

1. Contexto
Hoje emitimos manualmente:

Nota Fiscal de Serviços Eletrônica (NFS-e) — portal Softplan/Prefeitura de Florianópolis.

Boletos bancários — gerados no Internet Banking Itaú.

Já possuímos scripts em Python que:

separam e somam notas de materiais por obra/mês;

calculam o valor do serviço (parcela mensal).

Precisamos transformar esse processo em um painel web único, 100 % automatizado.

2. Objetivo do projeto
Criar um sistema full-stack que:

consolide valores de material × serviço por obra/mês;

emita nfs-e via api softplan (oauth2 + xml rps);

registre boletos itaú (api cobrança v2, mtls);

armazene pdf/links, mostre histórico e estados;

rode tarefas agendadas (celery) e envie alertas de erro.

3. Entregáveis principais
Módulo    Descrição resumida
Backend (FastAPI)    Endpoints rest, jwt auth, jobs celery, integrações nfps-e & itaú.
Frontend (React 18 + Mantine ou Shadcn)    Painel Admin: Materiais, Faturas, NFS-e, Boletos, Configurações.
Banco & Fila    SQLite + Redis (via Docker Compose).
Automação    Scripts de agregação, geração Xml, registro de boletos, conciliação.
ci/cd docker    pipeline github/gitlab actions, deploy no vps ubuntu 22.04 da Strucon.
Documentação    readme técnico + handbook de operação (pdf).

4. Requisitos técnicos mínimos
Python 3.11 (FastAPI, Celery, httpx, pydantic).

React + Hooks (TypeScript opcional).

Experiência nfs-e ou nf-e (integração softplan é plus).

Integração bancária REST com mTLS (Itaú, Sicoob, etc.).

Docker, Docker-Compose e básica de ci/cd.

Versionamento Git, testes unitários.

Diferenciais

Conhecimento de CNAB 400/240.

Segurança de secrets em Docker Swarm/K8s ou Vault.

5. Critérios de aceite
 nfs-e em hml e prod validadas contra xsd oficial.

 Boletos Itaú gerados em sandbox e produção, com pdf disponível na ui.

 Painel mostra status em tempo real; ações de reenvio/cancelamento funcionam.

 Cobertura de testes ≥ 80 %.

 Job agendado executa 3 ciclos completos sem falhas.

6. Prazo & carga estimada
8 sprints semanais (≈ 2 meses).

Dedicação mínima: 20 h/semana.

Início imediato após assinatura de nda e entrega de credenciais hml.

7. Como se candidatar
Envie:

Portfólio ou repositório com projetos similares (integrações fiscais ou bancárias).

Breve plano de abordagem técnica (2-3 parágrafos).

Valor/hora ou pacotes fechados.