2.5 KiB
2.5 KiB
Visão Geral — SARAndroid
O que é
SAR Android (Sistema de Atendimento ao Representante) é um aplicativo Android para representantes comerciais. Permite ao representante trabalhar completamente offline — gerenciando clientes, produtos e pedidos no campo — e sincronizar com o ERP central da empresa via conexão direta ao banco PostgreSQL.
Domínio de Negócio
O app serve representantes comerciais de distribuidoras/indústrias que:
- Visitam clientes sem acesso à internet garantido
- Precisam consultar catálogo de produtos com preços atualizados
- Emitem pedidos de venda e bonificação
- Consultam histórico de pedidos e títulos a receber do cliente
- Enviam os pedidos ao sistema ERP após retornar à conectividade
Dados Técnicos
| Campo | Valor |
|---|---|
| Versão | 2.8.1 (versionCode 156) |
| Pacote | br.com.jcsinformatica.sarandroid |
| Linguagem | Java (sem Kotlin) |
| Build | Eclipse ADT (sem Gradle) |
| Min SDK | 19 (Android 4.4 KitKat) |
| Target SDK | 35 (Android 15) |
| Banco local | SQLite v40 |
| Banco remoto | PostgreSQL via JDBC |
Funcionalidades Principais
| Módulo | Descrição |
|---|---|
| Pedidos | Criar/editar pedidos de venda e bonificação com cálculo de IPI, ICMS-ST, comissão e descontos por pauta |
| Produtos | Consultar catálogo com 3 tabelas de preço, estoque, fotos e dados fiscais |
| Clientes | Consultar e cadastrar clientes com validação de CNPJ/CPF e dados fiscais |
| Contas a Receber | Consultar títulos vencidos e recebimentos do cliente |
| Consultas | Histórico de pedidos do servidor e resumo de vendas |
| Comunicação | Sincronização bidirecional com servidor PostgreSQL |
| Fotos | Download de fotos de produtos via FTP |
Arquitetura em Uma Frase
App Android offline-first com dual-database (SQLite local + PostgreSQL remoto), sincronização explícita via JDBC direto, sem framework de persistência — apenas DAOs Java puro.
Documentação Disponível
- Arquitetura — padrões, classes centrais, fluxos
- Modelos de Dados — schema SQLite, VOs, relacionamentos
- Árvore de Fontes — estrutura de diretórios anotada
- Guia de Desenvolvimento — como abrir, compilar e modificar
- Inventário de Componentes UI — adapters, fragments, views customizadas
- Contexto para Agentes IA — regras críticas de implementação