refactor(app): Updating the folders's structure and adding support language documentation.

Author: felipeclarindo

.env-sample

@@ -0,0 +1,5 @@
+DB_USER=user
+DB_PASSWORD=password
+DB_HOST=domain
+DB_PORT=port
+DB_SERVICE_NAME=service_name

.env.example

@@ -1,51 +1,78 @@
+🌍 [Leia em Português](README.pt-BR.md)
+
 # Crud
 
-Crud com métodos de inserção, atualização, captura, remoção de dados de um banco de dados oracle utilizando a biblioteca requests em python
+Crud for manipulations in oracle database with methods of inserting, updating, capturing and removing data. using the `requests` library in python.
+
+# Technologies Used
+
+- `requests` - Communication with api.
+- `pytest` - Testing.
+- `oracledb` - Connect with oracle database.
+- `python-dotenv` - Load environment variables.
+- `flask` - Development of api.
+- `flask_cors` - Api CORS configuration.
+
+# Features
 
-## Instalação
+- Manipulation of data from a database: Methods of inserting, updating, creating, and removing data using requests.
+- Simple and intuitive interface: Simple and entuitive command-line interface for handling a database.
+- Dynamic interface, being able to manipulate the table you want!
 
-1. **Clone o repositório:**
+## Steps to install and run
+
+1. Clone the Repository:
 
 ```bash
-git clone https://github.com/felipeclarindo/crud
+git clone https://github.com/felipeclarindo/crud-cli.git
 ```
 
-2. **Navegue até o diretorio do projeto:**
+2. Enter directory:
 
 ```bash
-cd crud
+cd crud-cli
 ```
 
-3. **Rode a API**
+3. Create `Virtual Environment`:
 
 ```bash
-    python ./database/api.py
+python -m venv .venv
 ```
 
-4. **Execute o Programa**
+4. Enable `Virtual Environment` by running the `.bat` file in `.venv/Scripts/activate.bat`.
+
+5. Install dependencies:
 
 ```bash
-    python ./main.py
+pip install - r requirements.txt
 ```
 
-# Funcionalidades
+6. Run api server:
+
+```bash
+python src/api/server.py
+```
+
+7. Run the application:
+
+```bash
+python src/main.py
+```
 
-- **Manipulação de dados de uma database**: Métodos de inserção, atualização, criação e remoção de dados utilizando requests.
-- **Interface simples e intuitiva**: Interface em linha de comando simples e entuitiva para manipulação de um banco de dados.
-- **Dinamico**: Interface dinamica, podendo manipular a tabela que desejar!
+8. Interact with the menu interface and perform the desired manipulation in the database.
 
-## Contribuição
+## Contribution
 
-Contribuições são bem-vindas! Se você tiver sugestões de melhorias, sinta-se à vontade para abrir uma issue ou enviar um pull request.
+Contributions are welcome! If you have suggestions for improvements, feel free to open an issue or submit a pull request.
 
-## Autor
+## Author
 
 **Felipe Clarindo**
 
-- [LinkedIn](https://www.linkedin.com/in/felipe-clarindo-934578289/)
-- [Instagram](https://www.instagram.com/lipethegoat)
+- [LinkedIn](https://www.linkedin.com/in/felipeclarindo)
+- [Instagram](https://www.instagram.com/lipethecoder)
 - [GitHub](https://github.com/felipeclarindo)
 
-## Licença
+## License
 
-Este projeto está licenciado sob a [GNU Affero License](https://www.gnu.org/licenses/agpl-3.0.html).
+This project is licensed under the [GNU Affero License](https://www.gnu.org/licenses/agpl-3.0.html).

README.md

@@ -0,0 +1,78 @@
+🌍 [Read in English](README.md)
+
+# Crud
+
+Crud para manipulações em banco de dados oracle com métodos de inserção, atualização, captura e remoção de dados. utilizando a biblioteca `requests` em python.
+
+# Tecnologias Utilizadas
+
+- `requests` - Comunicação com a api.
+- `pytest` - Realizaçaõ dos testes.
+- `oracledb` - Conectar com a database da oracle.
+- `python-dotenv` - Carregar variaveis de ambientes.
+- `flask` - Desenvolvimento da api.
+- `flask_cors` - Configuração do CORS da api.
+
+# Funcionalidades
+
+- Manipulação de dados de uma database: Métodos de inserção, atualização, criação e remoção de dados utilizando requests.
+- Interface simples e intuitiva: Interface em linha de comando simples e entuitiva para manipulação de um banco de dados.
+- Dinamico: Interface dinamica, podendo manipular a tabela que desejar!
+
+## Passos para instalação e execução
+
+1. Clone o repositório:
+
+```bash
+git clone https://github.com/felipeclarindo/crud-cli.git
+```
+
+2. Entre no diretório:
+
+```bash
+cd crud-cli
+```
+
+3. Crie o `Ambiente Virtual`:
+
+```bash
+python -m venv .venv
+```
+
+4. Ative o `Ambiente Virtual` executando o arquivo `.bat` em `.venv/Scripts/activate.bat`.
+
+5. Instale as dependências:
+
+```bash
+pip install -r requirements.txt
+```
+
+6. Execute o servidor da api:
+
+```bash
+python src/api/server.py
+```
+
+7. Execute a aplicação:
+
+```bash
+python src/main.py
+```
+
+8. Interaja com a interface do menu e realize a manipulação desejada no banco de dados.
+
+## Contribuição
+
+Contribuições são bem-vindas! Se você tiver sugestões de melhorias, sinta-se à vontade para abrir uma issue ou enviar um pull request.
+
+## Autor
+
+Felipe Clarindo
+
+- [LinkedIn](https://www.linkedin.com/in/felipe-clarindo-934578289/)
+- [Instagram](https://www.instagram.com/lipethegoat)
+- [GitHub](https://github.com/felipeclarindo)
+
+## Licença
+
+Este projeto está licenciado sob a [GNU Affero License](https://www.gnu.org/licenses/agpl-3.0.html).

README.pt-BR.md

@@ -0,0 +1,93 @@
+from flask import Flask, request, jsonify
+from flask_cors import CORS
+from database.models import Crud
+
+# Inicializando a aplicação
+app = Flask(__name__)
+CORS(app)  # Habilitando CORS
+
+# Rota principal com informações da API
+@app.route("/api", methods=["GET"])
+def index():
+    return jsonify({
+        "name": "Crud Api",
+        "endpoints": {
+            "/api/table": {
+                "methods": {
+                    "POST": "post new data",
+                    "PATCH": "update single field",
+                    "DELETE": "delete data",
+                    "GET": "get all data or data by id",
+                }
+            }
+        },
+        "libraries": ["flask", "flask_cors"],
+        "developer": "felipeclarindo",
+        "github": "https://github.com/felipeclarindo"
+    }), 200
+
+# Rota para inserção de dados
+@app.route("/api/table", methods=["POST"])
+def post():
+    data = request.json
+    if not data or not isinstance(data, dict):
+        return jsonify({"message": "Dados inválidos ou ausentes."}), 400
+    
+    crud = Crud()
+    response = crud.post(data)
+    return jsonify(response), (201 if response["status"] == "success" else 400)
+
+# Rota para pegar todos os dados
+@app.route("/api/table", methods=["GET"])
+def get_all():
+    table = request.json.get("table")
+    if not table:
+        return jsonify({"message": "Parâmetro 'table' é obrigatório."}), 400
+
+    crud = Crud()
+    response = crud.get(table)
+    return jsonify(response), (200 if response["status"] == "success" else 400)
+
+# Rota para pegar dados por ID específico
+@app.route("/api/table/<int:id>", methods=["GET"])
+def get_with_id(id: int):
+    table = request.json.get("table")
+    if not table:
+        return jsonify({"message": "Parâmetro 'table' é obrigatório."}), 400
+
+    crud = Crud()
+    response = crud.get_with_id(table, id)
+    return jsonify(response), (200 if response["status"] == "success" else 400)
+
+# Rota para atualização de um único campo de um dado
+@app.route("/api/table/<int:id>", methods=["PATCH"])
+def patch(id: int):
+    data = request.json
+    if not data:
+        return jsonify({"message": "Dados não encontrados."}), 400
+
+    table = data.get("table")
+    column = data.get("column")
+    value = data.get("value")
+
+    if not table or not column or not value:
+        return jsonify({"message": "Parâmetros obrigatórios ausentes."}), 400
+
+    crud = Crud()
+    response = crud.patch(table, id, column, value)
+    return jsonify(response), (200 if response["status"] == "success" else 400)
+
+# Rota para deletar dado pelo ID
+@app.route("/api/table/<int:id>", methods=["DELETE"])
+def delete(id: int):
+    table = request.json.get("table") if request.json else None
+    if not table:
+        return jsonify({"message": "Parâmetro 'table' é obrigatório."}), 400
+
+    crud = Crud()
+    response = crud.delete(table, id)
+    return jsonify(response), (200 if response["status"] == "success" else 400)
+
+
+if __name__ == "__main__":
+    app.run(debug=True, port=3000)

__init__.py renamed to api/__init__.py

@@ -0,0 +1,30 @@
+from dotenv import load_dotenv
+from time import sleep
+import oracledb
+import os
+
+# Carrega as variaveis de ambiente do arquivo .env
+load_dotenv()
+
+
+def connect():
+    try:
+        # Dados para conexão
+        username = os.getenv("DB_USER")
+        password = os.getenv("DB_PASSWORD")
+        host = os.getenv("DB_HOST")
+        port = os.getenv("DB_PORT")
+        service_name = os.getenv("DB_SERVICE_NAME")
+
+        # Criando conexão
+        dsn = f"{username}/{password}@{host}:{port}/{service_name}"
+        print(f"Conectando ao banco de dados em {host}:{port} como {username}...")
+        sleep(1)
+        connection = oracledb.connect(dsn)
+        if connection:
+            print("Conexão feita com sucesso!")
+            return connection
+    except Exception as e:
+        print(f"Falha na conexão: {e}.")
+    return None
+