feature/SCRUM-42 Validação de Contexto

[guilhermesilveiras]

Resumo

Implementa a validação de contexto antes da geração de relatórios de IA.

Agora, ao solicitar a geração de relatório, o sistema monta um snapshot temporário do contexto atual da empresa, compara com o último contexto salvo e decide se deve gerar um novo relatório ou reaproveitar um relatório existente.

Alterações

• Adicionado ContextValidationService.
• Comparação do contexto atual com o último contexto salvo usando hash determinístico.
• Reaproveitamento do relatório existente quando o contexto não mudou.
• Persistência de novo contexto apenas quando há mudança relevante.
• Integração da validação no fluxo de ReportService.generate_report.
• Adicionados testes unitários para validação de contexto e reaproveitamento de relatório.

Validação

• python -m py_compile executado com sucesso nos arquivos alterados.
• pytest não foi executado porque o ambiente local não possui pytest instalado.

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
main.py	59	0	100%
core
config.py	13	0	100%
exceptions.py	80	2	97%	142–143
session.py	12	0	100%
supabase_client.py	3	0	100%
models
__init__.py	10	0	100%
assessment.py	21	0	100%
business_context.py	15	0	100%
chat_message.py	15	0	100%
enterprise.py	28	0	100%
menu.py	23	0	100%
notification.py	16	0	100%
photo.py	11	0	100%
report.py	20	0	100%
reservation.py	15	0	100%
user.py	20	0	100%
routers
assessments.py	26	0	100%
business_context.py	25	0	100%
chat.py	17	0	100%
enterprises.py	29	0	100%
menus.py	26	0	100%
notifications.py	27	0	100%
photos.py	97	67	30%	32, 38–40, 44, 50–52, 57, 68–70, 75–76, 81, 83–85, 90–91, 93–94, 96, 105, 107, 112–113, 115–117, 122, 124–125, 127, 137–139, 144–145, 150–158, 163–164, 166–167, 169, 178, 180–182, 184, 186–188, 197–199, 204–205, 207
reports.py	19	0	100%
transcriptions.py	11	0	100%
users.py	88	57	35%	27, 47–49, 53, 65–67, 72, 74–76, 81–82, 85, 87, 89, 98, 100–101, 103, 110–113, 126–128, 133–134, 142–143, 147, 149–150, 152–153, 155–157, 162–163, 166, 168, 170, 179, 183–184, 186–187, 189, 195, 197–198, 203–205
schemas
__init__.py	0	0	100%
assessments.py	19	0	100%
business_contexts.py	16	0	100%
chat.py	18	0	100%
enterprises.py	51	0	100%
menus.py	28	0	100%
notification.py	19	0	100%
reports.py	24	0	100%
transcriptions.py	11	0	100%
services
__init__.py	0	0	100%
assessment_service.py	83	52	37%	24, 51–53, 57, 60–61, 64–66, 71–73, 78–81, 86, 93–96, 104, 106–109, 113, 115–118, 122, 124–128, 132–133, 135–137, 140–143, 146–148, 153–154
business_context_builder_service.py	39	27	30%	20–22, 24, 26–35, 39–40, 45–47, 51–53, 62, 67–68, 71, 75
business_context_service.py	54	4	92%	76–78, 80
chat_context_service.py	41	0	100%
chat_service.py	44	0	100%
context_validation_service.py	32	0	100%
enterprise_service.py	78	0	100%
geocoding_service.py	39	0	100%
menu_service.py	52	0	100%
notification.py	27	0	100%
report_service.py	57	1	98%	82
transcription_service.py	90	0	100%
TOTAL	1548	210	86%