🏦 Mini-Project2: Full-Stack Banking System (Python & OOP)

---

🌍 Language Options | Opções de Idioma

This README is available in two languages:

• 🇺🇸 English (Primary)
• 🇧🇷 Português (Secondary)

---

🇺🇸 English Version

📌 Project Overview

This project is a full-stack banking system simulation developed in Python, applying Object-Oriented Programming (OOP) principles and a Command Line Interface (CLI).

The goal of this project is to practice software architecture, clean code organization, and business logic modeling, simulating real-world banking operations in a structured and scalable way.

---

🧱 Project Structure

The project is organized as follows:

Mini-Project2/
├── entidades/
│   ├── __init__.py
│   ├── cliente.py
│   └── conta.py
├── operacoes/
│   ├── __init__.py
│   └── banco.py
├── utilitarios/
│   ├── __init__.py
│   └── exceptions.py
└── mini_projeto2.py

---

🧠 Architecture Overview

• entidades/ Contains the data entities of the system, such as Client and Account.

• operacoes/ Contains the business logic and core operations, managed by the Bank class.

• utilitarios/ Includes utility components such as custom exception handling.

• mini_projeto2.py The application entry point, responsible for user interaction via the Command Line Interface (CLI).

---

▶️ How to Run the Project

1. Open the terminal or command prompt
2. Navigate to the project directory
3. Run the application:

python mini_projeto2.py

---

🎯 Concepts & Skills Applied

• Python Programming
• Object-Oriented Programming (OOP)
• Modular Project Structure
• Business Logic Implementation
• Exception Handling
• CLI-Based Application Design

---

🇧🇷 Versão em Português

📌 Visão Geral do Projeto

Este projeto é uma simulação de sistema bancário full-stack, desenvolvida em Python, aplicando conceitos de Programação Orientada a Objetos (POO) e utilizando uma Interface de Linha de Comando (CLI).

O objetivo é praticar arquitetura de software, organização de código limpo e modelagem de regras de negócio, simulando operações bancárias reais de forma estruturada e escalável.

---

🧱 Estrutura do Projeto

O projeto está organizado da seguinte forma:

Mini-Projeto2/
├── entidades/
│   ├── __init__.py
│   ├── cliente.py
│   └── conta.py
├── operacoes/
│   ├── __init__.py
│   └── banco.py
├── utilitarios/
│   ├── __init__.py
│   └── exceptions.py
└── mini_projeto2.py

---

🧠 Visão da Arquitetura

• entidades/ Contém as classes que representam as entidades de dados do sistema, como Cliente e Conta.

• operacoes/ Contém a lógica de negócio e as operações principais, centralizadas na classe Banco.

• utilitarios/ Contém utilitários do sistema, como exceções customizadas.

• mini_projeto2.py Ponto de entrada da aplicação, responsável pela interação com o usuário via linha de comando (CLI).

---

▶️ Como Executar o Projeto

1. Abra o terminal ou prompt de comando
2. Navegue até a pasta do projeto
3. Execute o comando:

python mini_projeto2.py

---

🎯 Conceitos & Habilidades Aplicadas

• Programação em Python
• Programação Orientada a Objetos (POO)
• Estruturação Modular de Projetos
• Implementação de Regras de Negócio
• Tratamento de Exceções
• Aplicações baseadas em CLI