Shambala

O que o Shambala oferece

Tudo que um Centro Espírita precisa para organizar seus atendimentos com tranquilidade.

🙏

Filas de Atendimento

Passe, Reiki, Acolhimento Fraterno e Atendimento Mediúnico — tudo organizado em tempo real na tela dos atendentes.

📺

Tela de Chamada

Monitor exibe o número chamado automaticamente, via Wi-Fi. Sem controle remoto, sem falhas.

📅

Planos de Tratamento

O médium define quantas sessões serão necessárias. O sistema agenda automaticamente nas semanas seguintes.

👥

Cadastro de Pessoas

Ficha completa com contatos, laços familiares, médium responsável e histórico de atendimentos.

💰

Financeiro

Receitas, despesas, mensalidades e suporte a PIX. Controle simples e transparente das finanças do Centro.

📚

Biblioteca

Acervo com busca por ISBN, empréstimos, vendas e integração automática com a base OpenLibrary.

🛒

Doações

Gestão de cestas básicas com rastreamento de entrega e histórico por família beneficiada.

📊

Relatórios

Estatísticas por dia, por médium, por período e por pessoa. Informação clara para tomada de decisão.

✡

Como o Shambala nasceu

Tudo começou com um problema simples: nos dias de trabalho do Centro Espírita Shambala, em Volta Redonda, o número de pessoas atendidas cresceu tanto que a organização manual — feita numa planilha de Excel e um display com controle remoto — passou a travar o atendimento logo na entrada.

A solução veio de dentro de casa. Computadores antigos que seriam descartados viraram servidor. Um Raspberry Pi esquecido numa gaveta ganhou um monitor e passou a exibir as senhas chamadas em tempo real, sem controle remoto, sem falhas. Qualquer computador com navegador na rede local virou posto de recepção.

O sistema foi crescendo junto com as necessidades do Centro. Depois do controle de filas vieram as agendas de atendimento mediúnico, com sessões programadas automaticamente semana a semana. Depois o financeiro, a biblioteca e o controle de doações — módulos que ainda estão em fase de implantação, mas já em uso.

O Shambala é distribuído gratuitamente, com código aberto, para que qualquer Centro Espírita possa instalar, usar e contribuir. A ideia é simples: se funcionou aqui, pode funcionar em muitos outros lugares.

♻️ Roda em computadores antigos

🌐 Acesso por qualquer navegador na rede

🆓 Gratuito e de código aberto

🤝 Comunidade aberta a contribuições

Como instalar

Siga os passos abaixo. Em menos de 15 minutos o sistema estará funcionando na rede do seu Centro.

✅ O que você precisa antes de começar

Computador ou Raspberry Pi com Debian ou variantes
Acesso à internet para baixar o sistema
✅ Após instalado, funciona 100% sem internet
Senha de root do sistema
Rede Wi-Fi ou cabo local

Entre como root e instale as dependências

Abra o terminal, entre como root e instale Python e PostgreSQL:

su - apt update && apt install -y python3 python3-venv python3-pip postgresql postgresql-client git

📌 O comando su - pede a senha de root. Você permanece como root até digitar exit. Os próximos comandos administrativos rodam nessa mesma sessão.

Criar o banco de dados

Configure o PostgreSQL com o usuário e banco do sistema:

su -s /bin/bash postgres -c "psql -c \"CREATE USER shambala WITH PASSWORD 'troque_esta_senha';\""
su -s /bin/bash postgres -c "psql -c \"CREATE DATABASE shambala OWNER shambala;\""
su -s /bin/bash postgres -c "psql -d shambala -c \"CREATE EXTENSION IF NOT EXISTS unaccent;\""

⚠️ Troque troque_esta_senha por uma senha de sua escolha e anote — você vai precisar dela no passo 4.

Baixar o Shambala

Saia do root, vá para sua pasta pessoal e baixe o sistema:

exit

cd ~
git clone https://github.com/cmartinelli-hub/shambala.git
cd shambala
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

Configurar o sistema

Copie o arquivo de configuração e informe a senha criada no passo 2:

cp .env.example .env
nano .env

📝 No arquivo que abrir, localize a linha SHAMBALA_DB_PASS= e coloque a senha que você criou. Salve com Ctrl+O e feche com Ctrl+X.

Instalar como serviço

Entre como root novamente para instalar o serviço — ele faz o sistema iniciar automaticamente sempre que o computador ligar:

su - bash /home/SEUUSUARIO/shambala/instalar.sh

📌 Troque SEUUSUARIO pelo seu nome de usuário no sistema. Após a instalação, digite exit para sair do root.

Acessar o sistema

Abra o navegador em qualquer computador da rede e acesse:

http://<IP-DO-SERVIDOR>:8000

🔐 O login inicial é usuário: admin e senha: admin. Troque a senha imediatamente após o primeiro acesso.

📺 A tela de chamada para o auditório é acessada em: http://<IP-DO-SERVIDOR>:8000/chamada — pressione F11 para tela cheia.