mbmaciel

# Requisitos para Relacionamentos com Orgaos Publicos

Este documento consolida os requisitos necessarios para a aplicacao LYS se relacionar com orgaos publicos, plataformas governamentais e entidades de controle. O foco e orientar produto, desenvolvimento, QA, implantacao e operacao na configuracao de integracoes, envio/consulta de dados, auditoria e conformidade.

Documento complementar:

- `docs/refinamento-fase-final-integracoes-governo.md`
- `docs/referencia-aplicacao.md`
- `docs/referencia-banco-dados.md`

mbmaciel

Resumo des recursos desenvolvidos no módulo de parceiros/conveniados:

Cadastro ampliado de parceiros/conveniados com nome fantasia, categoria, percentual de desconto, descrição do benefício, endereço completo, telefone, WhatsApp, site, logo, status, datas de vigência, observações, código interno, código público e CAPT/código da loja.

Novas rotas administrativas para gestão completa de convênios:
GET /convenios, POST /convenios, GET /convenios/:id, PUT /convenios/:id, DELETE /convenios/:id, além do alias REST /partners.

Listagem pública de convênios por tenant:
GET /convenios/public?tenant_id=...

mbmaciel

Multi-dominios por Tenant

Objetivo
Permitir que a aplicacao autenticada resolva a entidade pelo dominio acessado antes do login, exibindo nome, logotipo e cores do tenant na tela inicial.

Exemplos:

https://sitraslo.plenocrm.com.br deve abrir o login com logotipo, nome e tema do sindicato SITRASLO.
https://app.plenocrm.com.br deve continuar como dominio padrao do PlenoCRM, usado pelo usuario MASTER.
Se o usuario acessar um subdominio inexistente, como https://qualquercoisa.plenocrm.com.br, o sistema deve se comportar como https://app.plenocrm.com.br.

mbmaciel

 Experiencia Mobile/PWA - ROADMAP mobile

Item exclusivo para consolidar os recursos ja implementados ate o momento no ROADMAP mobile, incluindo entregas feitas antes do inicio formal deste roadmap.

### Base PWA e instalacao

- Manifesto PWA configurado com nome, nome curto, descricao, idioma `pt-BR`, modo `standalone`, orientacao `portrait-primary`, cores de tema/fundo e categorias.
- Metadados mobile/iOS/Android configurados no HTML, incluindo `viewport-fit=cover`, `apple-mobile-web-app-capable`, status bar e icones.
- Icones PWA disponiveis para favicon, 192x192, 512x512, maskable icon e splash/iconografia de instalacao.
- Service worker registrado no frontend.

mbmaciel

### CLINIC WISE

## Visão geral

O sistema ajuda a clínica a organizar sua rotina diária em um só lugar: agenda, pacientes, profissionais, consultas, financeiro, relatórios, notificações e configurações da clínica.

Cada usuário acessa apenas os recursos adequados ao seu perfil. Administradores têm uma visão completa da operação, profissionais acompanham agenda e atendimentos, e pacientes podem consultar informações relacionadas às suas consultas.

## Acesso e perfis de usuário

mbmaciel

### Ajuste mensal de descontos em folha

- Modulo financeiro de conferencia mensal em `/financeiro/descontos-folha`.
- Criacao/listagem de competencias mensais por tenant.
- Importacao do arquivo Excel da prefeitura, com parser para o layout Uniodonto:
  - aba principal `Plan1`.
  - coluna B como matricula funcional.
  - coluna C como nome do associado/dependente.
  - coluna D como tipo do registro.
  - coluna F como valor do desconto.

mbmaciel

## Integração Asaas BaaS — Status: ✅ Completo

A integração com o Asaas BaaS (Banking as a Service) está **totalmente implementada** conforme o documento `docs/INTEGRACAO-FINANCEIRA-BAAS.md`. Todos os checklists do documento foram concluídos.

### Arquitetura

```
PlenoCRM (Master API Key)
  └── POST /v3/accounts (cria subconta por sindicato)
        └── Subconta Sindicato (apiKey + walletId próprios)

mbmaciel

## 6. Recursos Implementados & Manual de Instruções

A arquitetura e os três pilares operacionais de faturamento e conveniados foram totalmente implementados e validados. Abaixo estão as instruções detalhadas de como usar os novos recursos no PlenoCRM.

### 6.1 Configuração de Credenciais Asaas (Pilar 1)
Cada entidade/sindicato (tenant) gerencia suas próprias chaves e ambiente do Asaas:
1. **Acesso**: Navegue até o painel de **Administração do Sindicato** > seção **Módulos**.
2. **Formulário de Configuração**: No módulo financeiro, clique em **Configurar**. Um modal de configurações do Asaas se abrirá.
3. **Preenchimento de Campos**:
   - **Ambiente**: Escolha entre `Sandbox` (ambiente de homologação/testes) e `Produção` (ambiente real).

mbmaciel

# Recursos Desenvolvidos - PlenoCRM MVP

> Inventario consolidado dos recursos ja implementados no CRM Sindical MVP.
>
> Atualizado em: 07/07/2026
>
> Observacao: a pasta `docs/` esta mantida apenas localmente e ignorada pelo Git, conforme decisao anterior do projeto.

## Sumario

mbmaciel

# Arquitetura e tecnologias utilizadas

Data: 2026-05-22

## Visão geral

O Self Care City é uma aplicação full-stack composta por:

- Aplicativo cliente em Expo/React Native, com suporte mobile e web.
- API backend em Node.js/Express.