Yuri Fontella YuriFontella

Review do core do OpenLake

Este documento descreve como revisar o OpenLake. A unidade de análise é a funcionalidade atravessando todas as camadas, não o arquivo que está aberto.

Uma review serve para entender um fluxo real de ponta a ponta e resolver o que estiver errado ou frágil nele — defeito concreto, risco demonstrável, barreira à evolução. Não para produzir lista de boas práticas.

Escopo

CLAUDE.md — Guia de Redesign UI/UX

Contexto do Projeto

Este projeto é um MVP funcional sendo elevado a produto profissional. O trabalho é de UI/UX e completude do produto: modernizar, reorganizar, tornar intuitivo e visualmente profissional — e garantir que tudo o que o serviço oferece esteja de fato exposto e acessível ao usuário.

O agente tem liberdade criativa para propor novos conteúdos, reorganizações, ideias de layout e melhorias que façam sentido para o produto — mesmo que não tenham sido explicitamente pedidas. Boas ideias devem ser implementadas, não só sugeridas.

Stack: Nuxt 4 + Tailwind CSS

MEMORY.md — Memória do Projeto

Este arquivo é lido e atualizado pelo agente a cada sessão. ❌ Nunca acumular — substituir e consolidar entradas existentes. ❌ Nunca registrar o que já está no PLAN.md ou no AGENTS.md. ✅ Registrar apenas o que um desenvolvedor novo precisaria saber para não cometer erros.

Regras de Manutenção

PLAN.md — [Nome do Projeto]

Fonte da verdade do que deve ser construído. Ordenado por prioridade — do topo para baixo. O agente marca a TASK como concluída ao finalizar. Qualquer outra alteração é responsabilidade humana.

Contexto do Projeto

AGENTS.md — Contrato de Desenvolvimento

Este arquivo é lido pelo agente a cada sessão. ❌ O agente NUNCA deve modificar este arquivo.

1. CONFIGURAÇÃO DO PROJETO

Camada Gold — Análise Financeira

Tabelas analíticas geradas a partir do Bronze. Executadas diariamente via run/gold.py, após a conclusão de todos os jobs Bronze.

Arquitetura

Bronze (dados brutos da API Omie)

	Você deve atuar como engenheiro sênior e adaptar sua abordagem conforme a área do projeto.

	REGRAS GERAIS

	- Antes de escrever código, analise como o projeto já resolve problemas semelhantes e siga os padrões existentes.
	- Quando um requisito for ambíguo e puder alterar a implementação, pergunte antes de prosseguir.
	- Não faça suposições silenciosas. Se precisar assumir algo, deixe a suposição explícita.
	- Quando houver incerteza, deixe isso explícito. Não apresente hipóteses como fatos.

	Parcimônia (Navalha de Occam)

	version: "3.8"

	services:
	n8n_editor:
	image: n8nio/n8n:latest
	command: start
	networks:
	- traefik-public
	- backend
	- redis

	import asyncio
	import logging

	from pathlib import Path
	from contextlib import asynccontextmanager
	from enum import Enum

	from litestar import Litestar, get, post, Controller, Request, Response, Router, WebSocket, websocket, MediaType
	from litestar.types import ASGIApp, Scope, Receive, Send
	from litestar.datastructures import State

	from starlette.applications import Starlette
	from starlette.responses import JSONResponse, Response
	from starlette.requests import Request
	from starlette.routing import Route

	import hmac
	import hashlib
	import secrets
	import sqlite3