sar-android/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

SAR Android (Sistema de Atendimento ao Representante) is a legacy Java Android sales-representative app. It allows sales reps to manage clients, products, and orders offline, then sync with a central PostgreSQL server.

Language: Java (no Kotlin)
Build System: Eclipse ADT (pre-Gradle) — no build.gradle; configured via .project, .classpath, and project.properties
Min SDK: 19 | Target SDK: 35
Root package: br.com.jcsinformatica.sarandroid

Building

This is an Eclipse ADT project, not an Android Studio/Gradle project. There are no gradlew commands.

• Open in Eclipse with ADT plugin or import into Android Studio using "Import Eclipse ADT Project"
• SDK target is set in project.properties (target=android-23)
• ProGuard config exists in proguard-project.txt but is disabled
• Lint suppressions are in lint.xml

There are no automated tests (no test/ or androidTest/ directories, no JUnit/Espresso setup).

Architecture

Entry Flow

SplashScreen → LoginActivity → MainActivity (expandable menu) → feature Activities

Key Classes

• Global — static singleton holding runtime state: current Empresa, Pedido, ItemPedido. Call Global.getEmpresa() (throws WarningException if unset).
• GlobalActivity — base Activity subclass for all post-login screens; reads company name from Global and sets the title.
• DatabaseHelper — SQLiteOpenHelper managing the local SQLite schema.
• ConnectionManager — manages PostgreSQL JDBC connections (20s timeout); used for remote sync.

Package Structure

Package	Role
vo/	Plain value objects (models): Produto, Cliente, Pedido, ItemPedido, Empresa, Representante, etc.
database/	SQLite DAOs (named *DB.java or *BD.java): CRUD + sync logic with MD5 change detection
postgres/	PostgreSQL JDBC operations mirroring the DAO layer (*PGSQL.java)
uimodels/	Custom list adapters and UI helpers
pedido/	Order/quote Activities (UpdatePedidoActivity, UpdatePedItemActivity, BrowsePedido, etc.)
produto/	Product Activities (BrowseProduto, UpdateProduto, FotosProduto)
cliente/	Client Activities (BrowseCliente, UpdateCliente)
comunicacao/	ComunicaActivity — orchestrates full data sync with the PostgreSQL server
consulta/	Query/report Activities (BrowsePedidoConsulta, ConsultaVendasActivity)

Dual-Database Sync Pattern

All persistent data lives in local SQLite and is periodically synced to/from PostgreSQL over direct JDBC. The pattern per entity:

1. *DB.java — reads/writes SQLite, computes MD5 checksums for change detection
2. *PGSQL.java — mirrors inserts/updates to the PostgreSQL server
3. ComunicaActivity acts as the sync orchestrator and provides a callback interface for progress updates

Third-Party Libraries (in libs/)

• postgresql-8.2-jdbc3.jar — PostgreSQL JDBC driver
• joda-time-2.5.jar — date/time calculations
• commons-net-3.3.jar — FTP support