# elivanjr/dsc_sistema_mercearia architecture

> Architecture diagram of the GitHub repository elivanjr/dsc_sistema_mercearia, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/elivanjr/dsc_sistema_mercearia
- Repository: https://github.com/elivanjr/dsc_sistema_mercearia

## Overview

SmartMercearia is a Java desktop system for managing minimarket operations. Its documented capabilities include stock by lot, sales, customer accounts and credit sales (fiado), cash movements, management reports, and role-based access. The sampled stock controller validates lot data before delegating persistence; DAO classes use a shared database connection. Other domain branches are included because the README documents them, but their runtime wiring was not sampled, so no unverified workflow links are asserted.

Main entry points: [`SistemaMercearia/src/main/java/br/com/sistemamercearia/util/DatabaseConnection.java`](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/util/DatabaseConnection.java) (Database connection), [`SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/ProdutoDAO.java`](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/ProdutoDAO.java) (Product DAO), [`SistemaMercearia/src/main/java/br/com/sistemamercearia/controller/EstoqueController.java`](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/controller/EstoqueController.java) (Stock controller), [`SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/ClienteDAO.java`](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/ClienteDAO.java) (Customers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_stock["Stock management"]
  node_stock_ui["Stock screen<br/>[TelaEstoque.java]"]
  node_stock_controller["Stock controller"]
end

subgraph group_operations["Store operations"]
  node_sales["Sales"]
  node_customers["Customers<br/>[ClienteDAO.java]"]
  node_credit["Credit sales<br/>[NotaFiadoDAO.java]"]
  node_cash["Cash operations<br/>[CaixaDAO.java]"]
  node_reports["Management reports"]
end

subgraph group_access["Access and reporting"]
  node_access_control["Role-based access<br/>[UsuarioDAO.java]"]
  node_audit["Audit logging"]
  node_hashing["Password hashing"]
end

subgraph group_persistence["Persistence and domain"]
  node_product_dao["Product DAO<br/>[ProdutoDAO.java]"]
  node_product["Products and lots<br/>[Produto.java]"]
  node_customer_entity["Customer account<br/>[Cliente.java]"]
  node_sale_entity["Sale and items<br/>[Venda.java]"]
  node_cash_entity["Cash movements"]
  node_db_connection["Database connection"]
end

node_operator(("Store staff"))
node_mysql[("MySQL / MariaDB")]

node_stock_controller -->|"delegates to"| node_product_dao
node_stock_controller -->|"validates"| node_product
node_product_dao -->|"maps data"| node_product
node_product_dao -->|"opens connection"| node_db_connection
node_customers -->|"persists"| node_customer_entity
node_customers -->|"opens connection"| node_db_connection
node_cash -->|"persists"| node_cash_entity
node_cash -->|"opens connection"| node_db_connection
node_credit -->|"opens connection"| node_db_connection
node_sales -.->|"uses connection"| node_db_connection
node_access_control -->|"uses connection"| node_db_connection
node_audit -->|"uses connection"| node_db_connection
node_customer_entity -->|"hashes passwords"| node_hashing
node_db_connection -->|"connects to"| node_mysql

click node_stock_ui "https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/view/TelaEstoque.java"
click node_stock_controller "https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/controller/EstoqueController.java"
click node_product_dao "https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/ProdutoDAO.java"
click node_product "https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/entity/Produto.java"
click node_sales "https://github.com/elivanjr/dsc_sistema_mercearia/tree/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model"
click node_customers "https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/ClienteDAO.java"
click node_credit "https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/NotaFiadoDAO.java"
click node_cash "https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/CaixaDAO.java"
click node_reports "https://github.com/elivanjr/dsc_sistema_mercearia/tree/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao"
click node_access_control "https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/UsuarioDAO.java"
click node_audit "https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/LogAuditoriaDAO.java"
click node_customer_entity "https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/entity/Cliente.java"
click node_sale_entity "https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/entity/Venda.java"
click node_cash_entity "https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/entity/MovimentacaoCaixa.java"
click node_hashing "https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/util/CriptografiaUtil.java"
click node_db_connection "https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/util/DatabaseConnection.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_stock_ui,node_stock_controller toneBlue
class node_sales,node_customers,node_credit,node_cash,node_reports,node_mysql toneAmber
class node_access_control,node_audit,node_hashing toneMint
class node_product_dao,node_product,node_customer_entity,node_sale_entity,node_cash_entity,node_db_connection toneRose
class node_operator toneIndigo
```

## Components

### Stock management

- [Stock screen](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/view/TelaEstoque.java): `SistemaMercearia/src/main/java/br/com/sistemamercearia/view/TelaEstoque.java`
- [Stock controller](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/controller/EstoqueController.java): `SistemaMercearia/src/main/java/br/com/sistemamercearia/controller/EstoqueController.java`

### Store operations

- [Sales](https://github.com/elivanjr/dsc_sistema_mercearia/tree/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model): `SistemaMercearia/src/main/java/br/com/sistemamercearia/model`
- [Customers](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/ClienteDAO.java): `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/ClienteDAO.java`
- [Credit sales](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/NotaFiadoDAO.java): `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/NotaFiadoDAO.java`
- [Cash operations](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/CaixaDAO.java): `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/CaixaDAO.java`
- [Management reports](https://github.com/elivanjr/dsc_sistema_mercearia/tree/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao): `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao`

### Access and reporting

- [Role-based access](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/UsuarioDAO.java): `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/UsuarioDAO.java`
- [Audit logging](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/LogAuditoriaDAO.java): `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/LogAuditoriaDAO.java`
- [Password hashing](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/util/CriptografiaUtil.java): `SistemaMercearia/src/main/java/br/com/sistemamercearia/util/CriptografiaUtil.java`

### Persistence and domain

- [Product DAO](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/ProdutoDAO.java): `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/ProdutoDAO.java`
- [Products and lots](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/entity/Produto.java): `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/entity/Produto.java`
- [Customer account](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/entity/Cliente.java): `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/entity/Cliente.java`
- [Sale and items](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/entity/Venda.java): `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/entity/Venda.java`
- [Cash movements](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/model/entity/MovimentacaoCaixa.java): `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/entity/MovimentacaoCaixa.java`
- [Database connection](https://github.com/elivanjr/dsc_sistema_mercearia/blob/main/SistemaMercearia/src/main/java/br/com/sistemamercearia/util/DatabaseConnection.java): `SistemaMercearia/src/main/java/br/com/sistemamercearia/util/DatabaseConnection.java`

### Other components

- **Store staff**
- **MySQL / MariaDB**

## Connections

- Stock controller → Product DAO: delegates to (evidence: `SistemaMercearia/src/main/java/br/com/sistemamercearia/controller/EstoqueController.java`)
- Stock controller → Products and lots: validates (evidence: `SistemaMercearia/src/main/java/br/com/sistemamercearia/controller/EstoqueController.java`)
- Product DAO → Products and lots: maps data (evidence: `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/ProdutoDAO.java`)
- Product DAO → Database connection: opens connection (evidence: `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/ProdutoDAO.java`)
- Customers → Customer account: persists (evidence: `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/ClienteDAO.java`)
- Customers → Database connection: opens connection (evidence: `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/ClienteDAO.java`)
- Cash operations → Cash movements: persists (evidence: `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/CaixaDAO.java`)
- Cash operations → Database connection: opens connection (evidence: `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/CaixaDAO.java`)
- Credit sales → Database connection: opens connection (evidence: `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/NotaFiadoDAO.java`)
- Sales → Database connection: uses connection (evidence: `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/ClienteDAO.java`)
- Role-based access → Database connection: uses connection (evidence: `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/UsuarioDAO.java`)
- Audit logging → Database connection: uses connection (evidence: `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/dao/LogAuditoriaDAO.java`)
- Customer account → Password hashing: hashes passwords (evidence: `SistemaMercearia/src/main/java/br/com/sistemamercearia/model/entity/Cliente.java`)
- Database connection → MySQL / MariaDB: connects to (evidence: `SistemaMercearia/src/main/java/br/com/sistemamercearia/util/DatabaseConnection.java`)
