Plataforma acadêmica para simular e gerenciar uma infraestrutura de recarga de veículos elétricos com controle energético, energia solar, billing, analytics e previsão consultiva de demanda.
O projeto é um monólito modular com FastAPI, React e PostgreSQL. O
SPEC.md é a fonte de verdade dos requisitos; este README e a
arquitetura vigente descrevem o estado implementado.
Os documentos PHASE_* e da Sprint 3 são registros históricos e não devem ser
usados isoladamente como manual operacional.
A documentação consolidada da solução final, com equipe, arquitetura,
integração, resultados, sustentabilidade, aderência conceitual à GoodWe,
diagramas, capturas e matriz de rastreabilidade está no
README da Sprint 4. Os resultados foram obtidos com
telemetria reproduzida e equipamentos simulados; não há alegação de conexão
física com hardware GoodWe.
Para validar automaticamente a demonstração completa a partir de uma instalação limpa, use:
make mvp-smokeEsse comando cria um projeto Docker Compose isolado, aplica as migrations,
carrega o seed, prepara o modelo de ML, inicia backend e frontend, executa o
Golden Path pela API pública e remove os containers e volumes temporários. Ele
não altera o volume postgres_data do ambiente de desenvolvimento. Requisitos,
portas alternativas e solução de problemas estão no
guia vigente da demo.
O dashboard não permanece disponível após make mvp-smoke. Para abrir as
telas com os dados da demonstração, use a
reprodução em banco de demo limpo.
Use o roteiro manual da
entrega da Sprint 3 somente quando precisar manter
as telas abertas para apresentação ou capturar evidências. Ele é preservado
como material histórico, mas recebeu uma indicação clara de quais instruções
continuam válidas.
Pré-requisitos: Docker com Docker Compose. Para iniciar o ambiente persistente:
cp .env.example .env
docker compose up --buildServiços disponíveis:
- frontend: http://localhost:5173;
- API/health: http://localhost:8000/api/v1/health;
- OpenAPI: http://localhost:8000/docs;
- PostgreSQL:
localhost:5432.
O frontend usa VITE_API_URL, por padrão
http://localhost:8000/api/v1. As rotas /admin e /user exigem contas com o
papel correspondente. O ambiente comum não cria contas automaticamente; para
dados demonstrativos, siga o guia da demo em vez de executar apenas
docker compose up.
Para aplicar migrations manualmente:
docker compose run --rm backend alembic upgrade headRequer Python 3.12, Node.js 22+ e PostgreSQL 16.
cd backend
python3.12 -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
alembic upgrade head
uvicorn app.main:app --reloadEm outro terminal:
cd frontend
npm ci
npm run devmake install # primeira execução local
make checkmake check executa lint, tipos e testes do backend, além de lint, tipos,
testes e build do frontend. make mvp-smoke acrescenta a validação integrada
em PostgreSQL 16. Não confunda resultados datados nos documentos de fase com
uma execução atual; somente comandos executados no checkout presente confirmam
o estado atual.
O MVP implementa autenticação e autorização, veículos, estações, carregadores,
sessões, simulação automática e ticks manuais, alocação Equal Share com limites
físicos e prioridade solar, leituras energéticas, billing, dashboards,
indicadores ESG, alertas e previsão consultiva de demanda. Todas as rotas
públicas pertencem a /api/v1.
A previsão de ML não controla a alocação de potência. A simulação, billing e
energia solar são demonstrativos; não há integração com hardware, pagamento
real, OCPP ou Modbus. Consulte a
arquitetura vigente para responsabilidades, fluxo e
limites.
Para gerar uma previsão, a estação precisa ter ao menos uma leitura de demanda
e uma leitura solar até o instante simulado, além do artefato do modelo treinado.
Se ainda não houver histórico para o mesmo dia da semana e hora, a média histórica
usa 0, conforme o preparo do dataset; a previsão continua consultiva.
A classificação completa está em docs/README.md.
SPEC.md: requisitos e regras de negócio, fonte de verdade;BRIEFING.md: contexto do produto, subordinado ao SPEC;docs/ARCHITECTURE.md: arquitetura implementada;docs/MVP_DELIVERY_SMOKE_TEST.md: preparo, execução e diagnóstico da demo atual;docs/CONTRIBUTING.md: fluxo de desenvolvimento;docs/ML_EVALUATION.md: método e limites da avaliação de ML.docs/sprint4/README.md: entrega final consolidada, resultados, evidências e aderência à Sprint 4.
docs/PHASE_1.mdadocs/PHASE_9.md: decisões, aceites e resultados de cada fase no momento em que foram registrados;docs/SPRINT_3_PLAN.md: plano anterior à entrega;docs/sprint-3/README.md: material e roteiro manual da Sprint 3;docs/sprint-3/EVIDENCE.md: evidências datadas;- documento da Sprint 3 em PDF, fonte Markdown e vídeo pitch.
Os registros históricos são mantidos para rastreabilidade. Quando divergirem
do código ou da documentação vigente, prevalece a ordem definida em
AGENTS.md: SPEC.md > BRIEFING.md > README.md > implementação
existente.