MAMA CARE AI — Plataforma de Saúde da Mulher, IA e Inclusão Digital
====================================================================

REQUISITOS
- WampServer com PHP 8.1+ e MySQL/MariaDB.
- Extensões PDO MySQL, cURL e mbstring activadas.
- Navegador actualizado.

INSTALAÇÃO LOCAL
1. Extraia a pasta mama_care_ai para C:\wamp64\www\ (ou C:\wamp\www\).
2. Inicie Apache e MySQL no WampServer.
3. Abra http://localhost/phpmyadmin/ e importe sql/schema.sql.
4. Ajuste DB_USER/DB_PASS em config.php se necessário.
5. Abra http://localhost/mama_care_ai/install.php e crie o primeiro superadministrador (mínimo 10 caracteres).
6. Entre em http://localhost/mama_care_ai/login.php.
7. APAGUE install.php depois da criação do administrador.
8. Crie os perfis adequados no menu Utilizadores.

MÓDULOS INCLUÍDOS
- Dashboard com indicadores, registo de utentes e consentimento.
- Consultas, níveis de alerta e encaminhamento.
- Biblioteca educativa de saúde.
- Lembretes, relatórios agregados, gestão de utilizadores e auditoria.
- Assistente de saúde: regras de triagem educativa local sem custos; integração opcional com API de IA generativa via cURL.
- SMS: fila/histórico e modo simulado por padrão; adaptador opcional Africa's Talking.
- Endpoint USSD: /mama_care_ai/ussd.php, com menu textual para acesso por telemóveis básicos.
- Interface responsiva, menu lateral, cartões 3D e logotipo com marca d'água.

CONFIGURAR IA OPCIONAL
Por padrão AI_PROVIDER=rules, que não envia perguntas para serviços externos. Para activar modelo externo, configure no ambiente do Apache/PHP:
MAMA_AI_PROVIDER=openai
MAMA_AI_API_KEY=sua_chave
MAMA_AI_MODEL=gpt-4.1-mini
A integração usa o endpoint compatível com OpenAI Chat Completions. Confirme o modelo e as condições da sua conta. Não inclua dados pessoais ou identificáveis nas perguntas. Nunca publique a chave dentro de repositório público.

CONFIGURAR SMS OPCIONAL
Por padrão SMS_PROVIDER=simulate: regista a tentativa, mas NÃO envia SMS real.
Para activar Africa's Talking, configure no ambiente do Apache/PHP:
MAMA_SMS_PROVIDER=africastalking
AT_USERNAME=seu_username
AT_API_KEY=sua_chave
AT_SENDER_ID=seu_sender_id (opcional)
É necessário conta, saldo, aprovação do remetente e acesso de rede. Faça primeiro testes com números autorizados. O código de estado do fornecedor deve ser confirmado antes de produção.

USSD
O endpoint ussd.php devolve respostas CON/END em texto simples e pode ser configurado como callback no fornecedor USSD compatível (por exemplo, Africa's Talking). A implementação actual é um menu informativo demonstrativo; não faz diagnóstico nem permite recolher informação clínica sensível. Para operação real é preciso URL público HTTPS, conta/gateway com USSD habilitado, código curto aprovado, testes de operadora e política de privacidade.

PERFIS
- Superadministrador: utilizadores e auditoria.
- Profissional de saúde: registos clínicos e acompanhamento.
- Agente comunitário: registo autorizado, lembretes e inclusão.
- Utente: perfil reservado para futura área pessoal; não usar até implementar isolamento de registos por utente.
- Gestor/coordenador: relatórios agregados e operações permitidas.
- Serviço IA: reservado para integração técnica.

SEGURANÇA E LIMITES
Este é um MVP/protótipo técnico, não um sistema clínico certificado nem uma plataforma pronta para produção. A IA apresenta informação educativa e sinalização simples por palavras-chave; não é validada clinicamente, pode falhar e não deve tomar decisões médicas. Em emergência, a pessoa deve procurar os serviços locais de saúde. Antes de uso real: avaliação clínica e jurídica, HTTPS, backups cifrados, política de retenção, consentimento específico para SMS/IA, controlo de acesso por estabelecimento e por utente, protecção contra abuso, registo de incidentes, testes de segurança e revisão do adaptador do fornecedor. Não exponha o WAMP directamente à Internet e não introduza dados reais de saúde antes da validação.
