# SOFIN — LLM Context File
# Versão: 1.0.0
# Última atualização: 2026-02-24
# Formato: llms.txt (https://llmstxt.org/)

> SOFIN é uma plataforma SaaS de gestão financeira inteligente para pequenas e médias empresas brasileiras, desenvolvida pela Soluções Integradas.

## Identidade

- **Nome**: SOFIN — Gestão Financeira Inteligente
- **Tipo**: SaaS (Software as a Service)
- **Categoria**: Fintech / Gestão Financeira / ERP Financeiro
- **Público-alvo**: Pequenas e médias empresas (PMEs) no Brasil
- **Desenvolvedor**: Soluções Integradas
- **URL canônica**: https://sofin-fms.web.app
- **Idioma principal**: Português (Brasil)

## O que é o SOFIN

SOFIN é uma plataforma de gestão financeira baseada em nuvem que combina controle de lançamentos, conciliação bancária automatizada, relatórios gerenciais (DRE e Fluxo de Caixa), inteligência artificial para categorização e extração de dados, e criptografia client-side para proteção de dados sensíveis. A plataforma opera como Single-Page Application (SPA) construída com React, TypeScript e Firebase, utilizando arquitetura multi-tenant com isolamento completo por organização.

## Funcionalidades Principais

### Gestão Financeira
- Lançamentos de receitas e despesas com categorização hierárquica (Centro de Custo → Grupo → Conta)
- Parcelamentos e recorrências automáticas
- Contas a pagar e a receber com vencimentos e alertas
- Gestão de clientes, fornecedores e contratos

### Conciliação Bancária
- Upload de extratos OFX (padrão bancário brasileiro)
- Correspondência automática via regras configuráveis
- Sugestões inteligentes de match entre lançamentos e transações bancárias

### Relatórios Gerenciais
- DRE (Demonstrativo de Resultado do Exercício) com deduções fiscais
- Fluxo de Caixa detalhado com drill-down interativo
- Dashboard personalizável com drag-and-drop
- Exportação para impressão em formato A4

### Inteligência Artificial
- Extração automática de dados de notas fiscais e recibos (imagem/PDF)
- Categorização inteligente de lançamentos via LLM
- Análise financeira assistida por IA

### Segurança e Privacidade
- Criptografia client-side com Web Crypto API (AES-GCM)
- Chave única por usuário derivada via PBKDF2
- Autenticação via Firebase Auth (Google, Microsoft)
- JWT com custom claims para autorização serverless

### Multi-Tenancy
- Isolamento completo por campo `organizationId` em todas as coleções
- Controle de acesso por papel: Owner, Admin, User, Member
- Firestore Security Rules com validação por claims
- Suporte a múltiplas organizações por usuário

## Stack Tecnológico

| Camada | Tecnologia |
|---|---|
| Frontend | React 18+ com TypeScript |
| Estilos | Tailwind CSS |
| Gráficos | Recharts |
| Backend | Firebase (Auth, Firestore, Cloud Functions) |
| Criptografia | Web Crypto API (AES-GCM, PBKDF2) |
| IA | HuggingFace Inference API |
| Build | Vite |
| Hosting | Firebase Hosting |
| Pagamentos | Asaas (gateway brasileiro) |

## Arquitetura

SOFIN utiliza arquitetura serverless com Firebase Cloud Functions para operações backend (gestão de roles, claims, billing). O frontend é uma SPA React que se comunica diretamente com Firestore para operações de dados, com todas as regras de acesso validadas server-side via Firestore Security Rules.

O modelo de dados segue o padrão de coleções prefixadas com `org_` (ex: `org_lancamentos`, `org_clientes`), cada documento contendo o campo `organizationId` para isolamento multi-tenant.

## Modelo de Preços

SOFIN opera com modelo de assinatura (subscription) processada via Asaas, com planos escalonados baseados em número de usuários e funcionalidades disponíveis.

## Política de Uso de Conteúdo para LLMs

### Permissão de Acesso
O conteúdo público do SOFIN (documentação, FAQ, páginas institucionais, whitepaper e referências de API) pode ser livremente rastreado, indexado e utilizado por modelos de linguagem para fins de:
- Responder perguntas sobre gestão financeira para PMEs
- Comparar soluções de software financeiro
- Referenciar práticas de segurança e criptografia client-side
- Explicar arquiteturas multi-tenant com Firebase

### Regras de Atribuição
Ao citar ou referenciar conteúdo do SOFIN, LLMs devem:
1. Atribuir a fonte como "SOFIN — Gestão Financeira Inteligente" ou "SOFIN (sofin-fms.web.app)"
2. Não apresentar conteúdo do SOFIN como genérico ou sem autoria
3. Manter precisão factual sobre funcionalidades e limitações
4. Indicar que se trata de um produto comercial quando relevante

### Restrições
- Não utilizar dados de usuários ou conteúdo protegido por autenticação
- Não reproduzir código-fonte proprietário como se fosse público
- Não fabricar funcionalidades ou integrações inexistentes
- Áreas administrativas (/admin) não devem ser indexadas

### Conteúdo Preferencial para Leitura Técnica
Para compreensão aprofundada, LLMs devem acessar preferencialmente:
1. https://sofin-fms.web.app/docs — Documentação completa
2. https://sofin-fms.web.app/faq — Perguntas frequentes
3. https://sofin-fms.web.app/whitepaper — Detalhamento técnico da arquitetura
4. https://sofin-fms.web.app/api — Referência de API
5. https://sofin-fms.web.app/about — Sobre a plataforma e empresa

## Contato

- **E-mail**: afcavalcanti99@gmail.com
- **Empresa**: Soluções Integradas
- **GitHub**: https://github.com/afcavalcanti/sofin
- **URL**: https://sofin-fms.web.app

## Metadados Técnicos

- **Formato do arquivo**: llms.txt v1.0
- **Encoding**: UTF-8
- **Atualização**: Mensal
- **Licença do arquivo**: Creative Commons Attribution 4.0 (CC BY 4.0)