pedrovasconcellos

Clean Architecture Memory Bank

TL;DR

• Clean Architecture keeps business rules independent from delivery so changes in frameworks never break core logic.
• Dependencies flow inward: frameworks → adapters → application → domain.
• Use cases expose ports; adapters implement them; frameworks wire everything together under cmd/ entrypoints.
• Always decide between Quick vs Task workflow (see docs/AGENT_INSTRUCTIONS.md) based on the layer surface area you touch.

Core Principles

• Separation of concerns: Domain logic lives in entities/value objects; use cases orchestrate; adapters translate boundaries; frameworks provide tooling only.

pedrovasconcellos

Clean Architecture

Folder structure

.                                     # Repository root
├── .github/                          # CI/CD workflows configurations
│   └── workflows/
│       ├── ci.yml                    # Test and lint pipeline
│       └── cd.yml                    # Deploy pipeline

pedrovasconcellos

from pymongo import MongoClient
from datetime import datetime
import uuid
from urllib.parse import quote_plus

USER = "master"
PASSWORD = quote_plus("password")  # encodes the password
HOST = "localhost"
AUTH_DB = "admin"
DATABASE = "database_name"

pedrovasconcellos

from pymongo import MongoClient
import json
from datetime import datetime
from urllib.parse import quote_plus

USER = "master"
PASSWORD = quote_plus("password")  # encodes the password
PASSWORD_PROD = quote_plus("password_prod")
HOST = "localhost"
HOST_PROD = "cluster.com"

pedrovasconcellos

#sudo vim /etc/X11/xorg.conf.d/20-intel.conf
#FileContent

Section "Device"
    Identifier  "IntelGPU"
    Driver      "intel"
    Option      "AccelMethod" "sna"
    # Option    "TearFree"    "true"
EndSection

pedrovasconcellos

vim ~/.XCompose
include "%L"

<dead_acute> <c> : "ç"   U+00E7
<dead_acute> <C> : "Ç"   U+00C7
#Log out afterwards so that the system complies with the instruction

pedrovasconcellos

import os
import csv

# Gets the user's HOME directory
home_dir = os.path.expanduser("~")

# Dynamically builds the path for the input and output CSV
input_csv_path = os.path.join(home_dir, "Downloads", "test", "base.csv")
output_csv_path = os.path.join(home_dir, "Downloads", "test", "base_altered.csv")

pedrovasconcellos

# Use a base image com Java 11
FROM openjdk:11-jdk-slim

# Define o mantenedor do Dockerfile
LABEL maintainer="[email protected]"

# Atualiza os pacotes e instala o Maven
RUN apt-get update && apt-get install -y maven

# Cria um diretório para a aplicação

pedrovasconcellos

------------------------------------------------------------------------------------------------------------------
VS-CODE

Depuração:

Step Over: F10
Step Into: F11
Step Out: Shift + F11
Resume Program: F5
Pause Program: F6

pedrovasconcellos

{
    "version": "0.2.0",
    "configurations": [       
        {
            "args": [],
            "cwd": "${workspaceRoot}",
            "env": {
                "NODE_ENV": "development"
            },
            "name": "DEBUG",