Uma operação organizada.
Do primeiro atendimento à entrega.

Gestão para empresas prestadoras de serviços.
Clientes, veículos, ordens de serviço e recebimentos em uma plataforma SaaS multi-tenant.

Conheça o produto · Executar localmente · Documentação · Próximos passos

Gestão conectada, da recepção ao financeiro

O Ofizzy reúne a rotina operacional de prestadores de serviços em um único lugar. A primeira vertical é Automotive, com um fluxo que conecta cliente, veículo, diagnóstico, serviços, peças e entrega.

Cada organização tem seus usuários, permissões, módulos e dados. Uma nova empresa é provisionada pela própria plataforma, sem outro deploy ou banco dedicado.

Recurso	O que você pode fazer
Clientes e veículos	Pesquisar cadastros, consultar contatos e manter o vínculo entre cliente e veículo.
Catálogo	Organizar serviços e peças com preços e classificação fiscal por vigência.
Ordens de serviço	Registrar queixa e diagnóstico, incluir itens e acompanhar o atendimento até a conclusão.
Recebimentos	Registrar pagamentos, liquidações parciais, taxas e estornos com histórico na OS.
Dashboard e documentos	Acompanhar indicadores operacionais e imprimir ordens de serviço em HTML/PDF.
Organizações e acesso	Provisionar empresas, concluir onboarding e trabalhar com múltiplos vínculos e papéis.
Desktop, tablet e celular	Operar com layouts adaptados, incluindo cartões e controles próprios para toque.

O produto em ação

Capturas da aplicação com API real e PostgreSQL, usando apenas dados fictícios em ambiente isolado. Como atualizar as imagens.

Acompanhe cada atendimento

Todos os detalhes da OS, no mesmo fluxo

Recebimentos com histórico

A operação também cabe no celular

Estado do projeto

O produto está em desenvolvimento ativo. Os fluxos operacionais e o financeiro manual estão implementados; o módulo fiscal tem implementação local avançada e ainda depende de homologação externa.

Configuração e preparação fiscal, assinatura e validação de XML, consultas, cancelamentos e documentos auxiliares fazem parte da fase atual. A transmissão/PDF RTC e a cadeia fiscal alfanumérica completa permanecem pendentes. Testes locais e simulação não equivalem à autorização de SEFAZ ou NFS-e Nacional. O financeiro manual não executa Split Payment automático.

Consulte o status com evidências, a fase fiscal e os critérios dos próximos passos.

Arquitetura

Um monólito modular: uma API ASP.NET Core, um frontend Angular e um PostgreSQL compartilhado. O backend concentra autorização, isolamento por organização, regras de negócio e cálculos; o Nginx entrega uma origem única.

flowchart LR
    Browser["Desktop · Tablet · Celular"] --> Nginx
    Nginx --> Web["Angular 21 · PrimeNG · Tailwind CSS"]
    Nginx --> API["ASP.NET Core 10"]
    API --> Platform["Identidade e organizações"]
    API --> Business["Clientes · Catálogo · OS · Financeiro · Fiscal"]
    API --> Automotive["Vertical Automotive"]
    Platform & Business & Automotive --> DB[(PostgreSQL 18)]

Loading

Decisões e limites estão em Arquitetura, Modelo de dados e ADRs.

Comece por aqui

Pré-requisito: Docker com Compose. Na raiz do repositório:

cp .env.example .env
# Edite .env: configure senhas e uma chave JWT aleatória de pelo menos 32 bytes.
docker compose build
docker compose --profile tools run --rm migrate
docker compose up -d --wait

A origem padrão é http://localhost:8080. Em banco vazio, habilite temporariamente PLATFORM_BOOTSTRAP_ENABLED=true em acesso privado, crie o operador em /setup e desabilite o bootstrap. Depois provisione a empresa em /plataforma e conclua seu onboarding.

Para desenvolver com hot reload, use .NET SDK 10, Node.js 24 e PostgreSQL no Docker. Comandos, portas, configuração de sessão e testes estão no guia de início. Para instalar ou atualizar um ambiente, consulte Instalação manual.

Organização do repositório

ofizzy/
├── .github/          # CI, Dependabot e templates
├── docs/             # Produto, arquitetura, operação e releases
├── infra/            # Variantes do Compose e Nginx
├── scripts/          # Ferramentas de manutenção e demonstração
├── src/backend/      # API e testes .NET
├── src/frontend/     # Aplicação Angular e E2E
├── compose.yaml      # Entrada padrão da stack completa
└── Ofizzy.slnx       # Solução .NET

A versão publicada está em Releases. A publicação de uma versão não dispara deploy; a instalação é manual.

Qualidade e contribuição

O CI verifica build e testes do backend, lint, testes unitários, E2E e build do frontend, além da configuração Compose. A suíte visual determinística é distinta do aceite com API real pelo Nginx.

Desenvolvimento acontece em develop; main é reservada para releases. Use Conventional Commits e registre evidências proporcionais à alteração. Leia o guia de contribuição antes de enviar um PR. Para bugs e propostas, utilize os formulários de issues.

Documentação

Para conhecer	Para desenvolver	Para operar
Visão do produto	Início e execução	Instalação manual
Estratégia	Frontend	Segurança
Roadmap	Contratos da API	Backup e restauração
Status atual	Testes	Operação fiscal

Continuidade técnica: AGENTS.md · AI-HANDOFF.md · Log de implementação.

Direitos de uso

Copyright © 2026 Pedro Tunin. Todos os direitos reservados. O código está disponível para consulta; este repositório não concede uma licença de código aberto. Uso, modificação ou redistribuição dependem de autorização do titular. Dependências e materiais de terceiros preservam suas próprias licenças. Consulte LICENSE.