Skip to content

README.md

Latest commit

 

History

History
170 lines (121 loc) · 4.05 KB

README.md

File metadata and controls

170 lines (121 loc) · 4.05 KB

Visão Geral do Projeto

Este sistema foi desenvolvido com fins educacionais, com o objetivo de explorar conceitos fundamentais da arquitetura cliente-servidor utilizando a linguagem de programação Delphi. A proposta foi simular um ambiente real de cadastro e faturamento de produtos, integrando funcionalidades como controle de estoque e emissão de notas fiscais, com divisão clara entre camadas e aplicação de boas práticas como separação de responsabilidades e uso de microserviços.

✅ Comportamentos Esperados

  • Validação de saldo antes da impressão
  • Se o saldo for suficiente:
    • Nota é impressa (.txt)
    • Estoque é baixado
    • Status da nota é alterado para "Fechada"
    • Usuário recebe feedback claro

🏗️ Arquitetura

1. EstoqueService

  • CRUD de produtos
  • Controle e baixa de saldo
  • Endpoints expostos via TIdHTTPServer

2. FaturamentoService

  • CRUD de notas fiscais e itens
  • Impressão e comunicação com EstoqueService
  • Endpoints via TIdHTTPServer

3. Cliente Delphi (VCL)

  • Interface gráfica para gerenciar os dados
  • Comunicação HTTP com os serviços
  • Geração de arquivo .txt da nota

🛠️ Tecnologias Utilizadas

  • Delphi VCL
  • Firebird 4.0.5
  • Indy Components (TIdHTTP, TIdHTTPServer)
  • JSON (System.JSON)
  • Arquivos .txt para logs e impressão

🔁 Fluxo da Aplicação

  1. Cadastro de produto (EAN, nome, saldo, custo e preço)
  2. Criação de nota fiscal
  3. Inclusão de produtos na nota
  4. Impressão:
    • Validação de saldo
    • Baixa de estoque
    • Alteração de status
    • Geração de .txt

⚠️ Tratamento de Falhas

Cenário Simulado:

  • Serviço de estoque offline → operação é abortada
  • Nenhuma alteração na nota
  • Mensagem de erro exibida:
    "Erro de conexão: serviço está desligado."

🔐 Transações ACID

Operações críticas usam:

  • StartTransaction
  • Commit
  • Rollback

🧵 Concorrência

  • Endpoint /produto/saldo usa: 
    SELECT Saldo FROM Produtos WHERE ID = :id FOR UPDATE WITH LOCK

Isso garante bloqueio de linha e evita problemas de leitura suja em acessos simultâneos.

🖥️ Como Executar

1. Banco de Dados

  • Instale o Firebird
  • Caminho padrão: \ProdManager\Data\BANCO.FDB
  • Ajuste o caminho no código, se necessário

2. Instalação dos serviços

cd \ProdManager\EstoqueService\Server\Win32\Release
EstoqueService.exe /install

cd \ProdManager\FaturamentoService\Server\Win32\Release
FaturamentoService.exe /install

3. Execução

  • Pressione Win + R → services.msc
  • Inicie: EstoqueController e FaturamentoController
  • Execute: \ProdManager\Client\Win32\Release\Client.exe

🔎 Endpoints Principais

EstoqueService (porta 8081)

  • GET /produto
  • GET /produto/{ean}
  • POST /produto
  • POST /produto/{id}
  • POST /produto/saldo
  • POST /produto/delete/{id}

FaturamentoService (porta 8082)

  • GET /nota
  • GET /nota/{id}
  • GET /nota/itens/
  • POST /nota
  • POST /nota/item
  • POST /nota/imprimir
  • POST /nota/deletar/{id}
  • POST /nota/item/deletar/{id}
  • POST /nota/atualizar/{id}
  • POST /nota/atualizar/valortotal/{id}
  • POST /nota/atualizar/chave/{id}

📂 Geração de Arquivo da Nota

Notas emitidas são salvas em:

\ProdManager\NotasEmitidas\Nota_{ID}.txt

✅ Requisitos Atendidos

Funcionalidade Status
Cadastro de produtos ✅
Cadastro de notas com itens ✅
Impressão com validação de saldo ✅
Baixa de estoque e fechamento da nota ✅
Microserviços independentes ✅
Transações ACID ✅
Cenário de falha com recuperação ✅
Controle de concorrência ✅

👨‍💻 Desenvolvedor

Arthur Fonseca
📧 arthur.elf95@gmail.com
🔗 LinkedIn
🐙 GitHub