👁 Image
Sufficit.Blazor 1.26.419.1521

Sufficit Blazor Server

Aplicação Blazor Server para gerenciamento de IVR (Interactive Voice Response) da plataforma Sufficit.

📋 Visão Geral

Esta aplicação fornece uma interface web moderna para configuração e gerenciamento de sistemas IVR, permitindo aos usuários criar, editar e testar menus de voz interativos de forma intuitiva.

🚀 Funcionalidades

• Interface Web Moderna: Interface responsiva baseada em Blazor Server
• Gerenciamento de IVR: Criação e edição de menus de voz interativos
• Teste em Tempo Real: Possibilidade de testar IVRs diretamente na interface
• Integração com APIs: Conexão com serviços Sufficit para dados e funcionalidades
• Autenticação Segura: Integração com sistema de identidade Sufficit

�️ Tecnologias Utilizadas

• .NET 9.0: Framework principal
• Blazor Server: Framework web para interfaces interativas
• MudBlazor: Componentes UI modernos
• Sufficit.Client: Biblioteca de cliente para APIs Sufficit
• SignalR: Comunicação em tempo real (opcional)

📋 Pré-requisitos

• .NET 9.0 SDK
• Acesso aos serviços Sufficit (APIs)
• Navegador web moderno com suporte a WebSockets

🚀 Deployment

Estrutura de Arquivos

sufficit-blazor/
├── config.json # Configuração de deployment
├── deploy.py # Script de deployment automatizado
├── server/publish/ # Artefatos compilados usados no deploy
├── helpers/ # Scripts auxiliares e configuração systemd
│ ├── sufficit-blazor-server.service
│ ├── prestart.sh
│ ├── install.sh
│ ├── update.sh
│ ├── syslog.conf
│ └── README.md
└── README.md # Este arquivo

Servidores Disponíveis

• eveo-apps - Servidor principal de aplicações
• apoint-apps - Servidor secundário de aplicações
• castrum-apps - Servidor terciário de aplicações

Porta de Serviço

• Porta: 26508
• Protocolo: HTTPS
• Health Check: https://localhost:26508/health

Como Fazer Deploy

1. Preparar Artefatos:

   # No diretório do projeto
    dotnet publish server/Sufficit.Blazor.Server.csproj --configuration Release --output server/publish
   

2. Executar Deployment:

   # Deploy para servidor específico
   python deploy.py eveo-apps
   # ou
   python deploy.py apoint-apps
   # ou
   python deploy.py castrum-apps
   

3. Verificar Status:

   # Verificar se o serviço está rodando
   systemctl status sufficit-blazor-server
   
   # Verificar logs
   tail -f /var/log/sufficit/blazor-server.log
   
   # Testar health check
    curl -k https://localhost:26508/health
   

Configuração do Serviço

O serviço é configurado automaticamente pelo script install.sh e inclui:

• SystemD Service: sufficit-blazor-server.service
• Diretório: /opt/sufficit-blazor-server/
• Usuário: dotnetuser
• Logs: /var/log/sufficit/blazor-server.log

Para hosts já provisionados, o deploy reaplica o install.sh quando detecta que a unit do systemd não está mais apontando para o helper implantado em /opt/sufficit-blazor-server/helpers/.

Certificado SSL

O certificado SSL é atualizado automaticamente pelo script prestart.sh:

• Fonte: /etc/letsencrypt/live/sufficit.com.br/certificate.pfx
• Destino: /opt/sufficit-blazor-server/certificate.pfx

� Desenvolvimento

Configuração Local

1. Clonar o repositório:

   git clone <repository-url>
   cd sufficit-blazor
   

2. Restaurar dependências:

   dotnet restore
   

3. Executar aplicação:

   # Para desenvolvimento
   dotnet run --project server/Sufficit.Blazor.Server.csproj
   
   # Para watch mode (hot reload)
   dotnet watch run --project server/Sufficit.Blazor.Server.csproj
   

4. Acessar aplicação:

   • URL: https://localhost:5001 (ou porta configurada)
   • Health Check: https://localhost:5001/health

Estrutura do Projeto

server/ # Projeto Blazor Server
├── Sufficit.Blazor.Server.csproj
├── Program.cs # Ponto de entrada da aplicação
├── Startup.cs # Configuração de serviços
├── appsettings.json # Configurações da aplicação
├── wwwroot/ # Arquivos estáticos (CSS, JS, imagens)
├── Pages/ # Páginas Razor
├── Components/ # Componentes reutilizáveis
├── Services/ # Serviços da aplicação
└── Data/ # Classes de dados e modelos

client/ # Projeto Blazor Client (se aplicável)
shared/ # Código compartilhado

📊 Monitoramento

Health Checks

A aplicação inclui vários health checks:

• Geral: /health - Status geral da aplicação
• Detalhado: /health/ready - Verificação de dependências
• UI: /health/ui - Interface web para monitoramento

Logs

• Arquivo: /var/log/sufficit/blazor-server.log
• Syslog Tag: [sufficit][blazor-server]
• Nível: Configurado via appsettings.json

Métricas

A aplicação expõe métricas via endpoint /metrics (se configurado).

� Segurança

• HTTPS Only: Toda comunicação é feita via HTTPS
• Autenticação: Integração com Sufficit Identity
• CORS: Configurado para domínios autorizados
• Rate Limiting: Proteção contra abuso da API

📞 Suporte

• Desenvolvimento: development@sufficit.com.br
• Produção: suporte@sufficit.com.br
• Documentação: Wiki Interna

📄 Licença

Todos os direitos reservados © 2025 Sufficit Soluções em Tecnologia da Informação

Example of using a Card and Button component:

<SufficitCard>
 <CardHeader>
 Welcome!
 </CardHeader>
 <CardBody>
 <p>This is a sample card component from the Sufficit.Blazor library.</p>
 <SufficitButton Color="ButtonColor.Primary" OnClick="@OnButtonClick">
 Click Me
 </SufficitButton>
 </CardBody>
</SufficitCard>

@code {
 private void OnButtonClick()
 {
 Console.WriteLine("Button was clicked!");
 }
}

🤝 Contributing

Contributions are greatly appreciated. Please follow the standard fork and pull request workflow.

📄 License

Distributed under the MIT License. See LICENSE for more information.

📧 Contact

Sufficit -

Project Link: https://github.com/sufficit/sufficit-blazor