Skip to content

About

Plataforma inteligente para simulação e gestão de recargas de veículos elétricos, com controle de demanda, energia solar, billing, analytics, ESG e Machine Learning.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

ChargeGrid Intelligence

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.

Entrega final — Sprint 4

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.

Caminho recomendado

Para validar automaticamente a demonstração completa a partir de uma instalação limpa, use:

make mvp-smoke

Esse 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.

Execução de desenvolvimento

Pré-requisitos: Docker com Docker Compose. Para iniciar o ambiente persistente:

cp .env.example .env
docker compose up --build

Serviços disponíveis:

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 head

Execução sem Docker

Requer 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 --reload

Em outro terminal:

cd frontend
npm ci
npm run dev

Validação

make install  # primeira execução local
make check

make 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.

Estado funcional 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.

Mapa da documentação

A classificação completa está em docs/README.md.

Vigente

Histórico e evidências

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.

About

Plataforma inteligente para simulação e gestão de recargas de veículos elétricos, com controle de demanda, energia solar, billing, analytics, ESG e Machine Learning.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Contributors

Languages