Modulo 4.2: Estrutura do Projeto

📁 Organizacao de pastas

A estrutura segue padroes de projetos Python modernos com separacao clara de responsabilidades.

notebooklmx/
├── app/
│   ├── __init__.py
│   ├── main.py              # Entry point FastAPI
│   ├── config.py            # Configuracoes
│   ├── database.py          # SQLite setup
│   ├── routers/             # Endpoints
│   │   ├── notebooks.py
│   │   ├── sources.py
│   │   └── chat.py
│   ├── services/            # Logica de negocio
│   │   ├── pipeline.py      # Pipeline Universal
│   │   └── persona_utils.py # Governanca Cognitiva
│   ├── generators/          # Geradores de artefatos
│   │   ├── docx_gen.py
│   │   ├── audio_gen.py
│   │   └── video_gen.py
│   └── models/              # Schemas Pydantic
├── static/                  # Frontend
├── tests/
├── .env.example
├── requirements.txt
└── README.md

📋 Principais arquivos

main.py

Inicializacao FastAPI, CORS, routers, lifespan events

pipeline.py

Implementacao dos 9 passos do Pipeline Universal

persona_utils.py

Sistema de personas e preferencias

database.py

Conexao SQLite, modelos, queries de auditoria

🔧 Configuracoes

Variaveis de ambiente e configuracoes do sistema.

# .env
GEMINI_API_KEY=your_api_key
DATABASE_URL=sqlite:///./notebooklmx.db
LOG_LEVEL=INFO
MAX_TOKENS=8192
DEFAULT_PERSONA=professional
ENABLE_COST_TRACKING=true
STORAGE_PATH=./storage

📊 Dependencias

# requirements.txt
fastapi==0.109.0
uvicorn==0.27.0
google-generativeai==0.3.2
python-dotenv==1.0.0
pydantic==2.5.3
python-multipart==0.0.6
python-docx==1.1.0
gtts==2.5.0
moviepy==1.0.3
aiosqlite==0.19.0
structlog==24.1.0

🚀 Setup e instalacao

Passos para rodar

# 1. Clone o repositorio
git clone https://github.com/example/notebooklmx.git
cd notebooklmx

# 2. Crie ambiente virtual
python -m venv venv
source venv/bin/activate  # Linux/Mac
# ou: venv\Scripts\activate  # Windows

# 3. Instale dependencias
pip install -r requirements.txt

# 4. Configure variaveis
cp .env.example .env
# Edite .env com sua GEMINI_API_KEY

# 5. Execute
uvicorn app.main:app --reload

# Acesse: http://localhost:8000

🧪 Ambiente de desenvolvimento

Ferramentas Recomendadas

•VSCode + Python extension
•Black - formatacao
•Ruff - linting rapido
•pytest - testes

Hot Reload

# Desenvolvimento com auto-reload
uvicorn app.main:app \
  --reload \
  --reload-dir app \
  --host 0.0.0.0 \
  --port 8000

📝 Resumo do Modulo

✓Estrutura - Organizacao clara por responsabilidade

✓Configuracao - Variaveis de ambiente para flexibilidade

✓Dependencias - Stack minimo e focado

✓Setup - Ambiente pronto em minutos

← Modulo Anterior Proximo Modulo →