Pré-requisitos do Sistema
Esta página lista os pré-requisitos necessários para instalar e executar o PCH-SIG.
Configuração do Servidor
Servidor de Produção
| Recurso | Mínimo | Recomendado |
|---|---|---|
| CPU | 4 núcleos | 8 núcleos |
| RAM | 8 GB | 16 GB |
| Armazenamento | 100 GB SSD | 500 GB SSD |
| Rede | 100 Mbps | 1 Gbps |
Servidor de Desenvolvimento
| Recurso | Mínimo |
|---|---|
| CPU | 2 núcleos |
| RAM | 4 GB |
| Armazenamento | 50 GB |
Sistema Operacional
Suportado
| SO | Versão | Notas |
|---|---|---|
| Windows Server | 2019, 2022 | Via Docker Desktop ou Docker Toolbox |
| Windows | 10, 11 Pro | Via Docker Desktop |
| Ubuntu | 20.04, 22.04 LTS | Recomendado para produção |
| Debian | 11, 12 | Suportado |
| CentOS/RHEL | 8, 9 | Suportado |
Configuração Windows
Para Windows sem Hyper-V (como o servidor serveur-production):
- Docker Toolbox com VirtualBox
- VM Docker em 192.168.99.100
- Proxy de porta via
netsh interface portproxy
Software Necessário
Docker
| Componente | Versão mínima |
|---|---|
| Docker Engine | 20.10+ |
| Docker Compose | 2.0+ |
Para desenvolvimento
| Software | Versão | Uso |
|---|---|---|
| Node.js | 18.x LTS | Build do frontend |
| npm | 9.x+ | Gerenciador de pacotes |
| PHP | 8.3 | Backend Symfony |
| Composer | 2.x | Dependências PHP |
| Git | 2.x | Controle de versão |
Portas de Rede
Portas a abrir
| Porta | Serviço | Direção |
|---|---|---|
| 80 | HTTP (Frontend) | Entrada |
| 443 | HTTPS | Entrada |
| 3000 | Frontend dev | Entrada |
| 8000 | API Backend | Entrada |
| 5432 | PostgreSQL | Interno |
| 6379 | Redis | Interno |
Configuração de firewall Windows
# Abrir a porta 3000
netsh advfirewall firewall add rule name="PCH-SIG Frontend" dir=in action=allow protocol=tcp localport=3000
# Abrir a porta 8000
netsh advfirewall firewall add rule name="PCH-SIG API" dir=in action=allow protocol=tcp localport=8000
Banco de Dados
PostgreSQL
| Parâmetro | Valor |
|---|---|
| Versão | 15.x |
| Extensão PostGIS | 3.4 |
| Codificação | UTF-8 |
| Collation | fr_FR.UTF-8 |
Espaço em disco recomendado
| Dados | Espaço |
|---|---|
| Base inicial | 100 MB |
| 10.000 domicílios | 500 MB |
| 100.000 domicílios | 5 GB |
| Logs 1 ano | 10 GB |
Navegadores Suportados
Usuários finais
| Navegador | Versão mínima |
|---|---|
| Chrome | 90+ |
| Firefox | 90+ |
| Edge | 90+ |
| Safari | 14+ |
Funcionalidades necessárias
- JavaScript ativado
- Cookies ativados
- LocalStorage disponível
- WebSocket (para notificações em tempo real)
Conectividade
Acesso à Internet
| Uso | Necessário |
|---|---|
| Instalação inicial | Sim (download de imagens Docker) |
| Funcionamento normal | Não (aplicação local) |
| Atualizações | Sim |
| Integração KoBo | Sim |
Acesso à Rede Interna
| Serviço | Acesso |
|---|---|
| Servidor PostgreSQL | Do backend |
| Servidor Redis | Do backend |
| API Backend | Do frontend |
Verificação dos Pré-requisitos
Script de verificação (Linux)
#!/bin/bash
echo "=== Verificação dos pré-requisitos PCH-SIG ==="
# Docker
echo -n "Docker: "
docker --version 2>/dev/null || echo "NÃO INSTALADO"
# Docker Compose
echo -n "Docker Compose: "
docker compose version 2>/dev/null || echo "NÃO INSTALADO"
# Portas
echo -n "Porta 3000: "
netstat -tlnp | grep :3000 && echo "OCUPADA" || echo "LIVRE"
echo -n "Porta 8000: "
netstat -tlnp | grep :8000 && echo "OCUPADA" || echo "LIVRE"
# Espaço em disco
echo "Espaço em disco:"
df -h /
Verificação Windows (PowerShell)
# Docker
docker --version
# Portas
netstat -an | Select-String ":3000"
netstat -an | Select-String ":8000"
# Espaço em disco
Get-PSDrive C | Select-Object Used, Free
Próximos passos
Uma vez verificados os pré-requisitos: