UNICEF HOPE

O HOPE (Humanitarian cash Operations and Programme Ecosystem) é a plataforma do UNICEF para a prestação de assistência monetária. Abrange o cadastro de beneficiários e domicílios com remoção de duplicatas, a seleção de beneficiários e os ciclos de programa, as listas de pagamento e sua entrega por meio de prestadores de serviços financeiros, a verificação e conciliação de pagamentos, e a gestão de reclamações e feedback.

O HOPE é licenciado sob AGPL-3.0. Execução gratuita — não é cobrado.

O que é instalado

Frontend: um servidor web na frente do HOPE que também serve seus arquivos estáticos.
Backend: o aplicativo HOPE.
Processos em segundo plano: três processos (um worker, um worker de tarefas periódicas e um agendador) que executam as tarefas em segundo plano do HOPE.
Init: uma etapa única que verifica se o Elasticsearch tem os plugins de que o HOPE precisa, prepara o banco de dados, cria a conta de administrador e carrega a lista de países e os códigos de país, e depois para.
Banco de dados: um banco de dados PostgreSQL com a extensão PostGIS.
Redis: a fila e o cache dos processos em segundo plano.
Elasticsearch: o mecanismo de busca do HOPE. Uma etapa única adiciona os plugins de busca de que o HOPE precisa antes que ele inicie.

O HOPE é servido em um único endereço web: o endereço principal da instalação. Você pode acessá-lo pelo endereço IP do servidor ou atribuir a ele um domínio.

Antes de instalar

O HOPE é publicado somente para servidores x86-64 (amd64). Instale-o em um servidor x86-64. Em um servidor ARM (arm64), ele roda em emulação, o que é visivelmente lento, e o assistente não impede isso: a Adequação do servidor mostra um aviso Arquitetura: arm64, mas deixa você continuar.
Se você usar um servidor Elasticsearch que já executa, ele precisa ter os plugins analysis-phonetic e analysis-icu instalados em todos os nós. Para instalá-los, execute elasticsearch-plugin install analysis-phonetic analysis-icu em cada nó e depois reinicie o Elasticsearch. Antes de o HOPE preparar o banco de dados, a instalação verifica esses plugins. Se algum estiver faltando, a implantação falha e o erro indica o plugin ausente. O Elasticsearch incluído já tem os dois.
O Elasticsearch usa mais memória do que qualquer outra parte da instalação. O Deployment size (tamanho da implantação) define o heap dele. Se você adicionar um -Xmx maior em Elasticsearch JVM options (opções da JVM do Elasticsearch), mantenha-o abaixo do limite do contêiner do Elasticsearch: 2 GiB em small, 4 GiB em medium.

Escolha um Deployment size:

small: 2 processos web, 2 processos em segundo plano mais 1 para tarefas periódicas, e um heap de Elasticsearch de 1 GiB. Os contêineres ficam limitados a cerca de 8 GiB de memória no total.
medium: 4 processos web, 4 processos em segundo plano mais 2 para tarefas periódicas, um heap de Elasticsearch de 2 GiB e mais memória para o banco de dados, para cadastros de beneficiários maiores, listas de pagamento maiores e mais usuários simultâneos. Cerca de 14,5 GiB no total.

Você pode alterar o tamanho mais tarde com Redimensionar. Os novos números de processos e limites de memória passam a valer quando a instalação reinicia.

A verificação Adequação do servidor do assistente indica se o seu servidor é grande o suficiente para o tamanho escolhido.

Opções

Campo	O que faz
Deployment size	`small` ou `medium`, como descrito acima.
Public domain (domínio público)	O nome de host que o HOPE usa nos links de e-mails e exportações, como `hope.example.org`. Deixe em branco para usar o IP do servidor.
Administrator username (nome de usuário do administrador)	A conta de administrador criada na primeira inicialização. Por padrão, `admin`. Uma atualização posterior não o altera.
Administrator email (e-mail do administrador)	O endereço de e-mail dessa conta. Por padrão, `admin@example.org`.
Maximum upload size (tamanho máximo de upload)	O maior arquivo que as pessoas podem enviar, como `50m` ou `200m`. Aumente-o para importações grandes de beneficiários e arquivos de conciliação. Por padrão, `50m`.

Avançado contém Allowed hosts (hosts permitidos; por padrão *; restrinja ao seu domínio depois de associar um), Elasticsearch JVM options e as configurações de e-mail de saída: SMTP host (host SMTP; deixe em branco para não enviar e-mails), SMTP port (porta SMTP), SMTP username (nome de usuário SMTP), SMTP password (senha SMTP) e From address (endereço do remetente). A SMTP password é selada e nunca mais é exibida. Se, em vez disso, você associar uma conexão Outbound email relay (relay de e-mail de saída), ela preenche todos esses campos para você. O banco de dados sempre se chama hopedb. No servidor de banco de dados incluído, o usuário dele é sempre hope. Você também pode usar um servidor PostgreSQL, Redis ou Elasticsearch que já executa em vez dos incluídos. Consulte serviços externos.

O primeiro administrador é a conta informada em Administrator username e Administrator email, que você digita no assistente. A plataforma gera a senha dela.

Quando você clica em Criar, o portal mostra a senha uma única vez, em Credenciais de primeiro acesso. Copie-a para o seu gerenciador de senhas antes de sair da página.

Abra o endereço da instalação e entre com esse nome de usuário e essa senha. Para trocar a senha mais tarde, altere-a dentro do HOPE.

A senha do banco de dados e a chave secreta do aplicativo também são geradas pela plataforma e seladas. Você nunca precisa digitá-las.

Conexões

O HOPE pode disponibilizar a outra instalação no mesmo servidor:

Cash transfer programme data (read-only) (dados de programas de transferência monetária, somente leitura): acesso somente leitura ao banco de dados do HOPE, para ferramentas de relatórios como o Metabase. As contas de usuário, os dados de login, as sessões e os tokens ficam de fora.

Pode usar, a partir de outra instalação:

Outbound email relay: permite que o HOPE envie as notificações de reclamações e de pagamentos. Opcional.

Consulte conexões.

Saiba mais

Documentação do HOPE