self host planning poker

Poker de planejamento de auto-hospedeiro

Um aplicativo de poker de planejamento sem complicações para implantar em seu NAS.

O que é?

Este aplicativo se destina a uma alternativa simplificada e auto-hospedável ao planejamento do poker online.

Apresenta:

• Vários tipos de deck: Fibonacci, Fibonacci modificado, tamanhos de camiseta, poderes de 2 e voto de confiança (0 a 5)
• Modo espectador
• Layout responsivo
• Resumo da votação
• Traduções (inglês, francês, alemão, italiano e polonês. Contribuições são bem -vindas!)

Ele não possui recursos sofisticados, como gerenciamento de problemas, integração ou temporizadores da JIRA.

Capturas de tela

Implantação

A implantação do aplicativo é fácil, pois é independente em um único contêiner. Tudo o que você precisa é criar um volume para persistir as configurações de jogos (ID, nome e baralho).

Docker

docker run 
  -v planning-poker-data:/data 
  -p 8000:8000 
  axeleroy/self-host-planning-poker:latest

Docker-Compose

 version : " 3 "
services :
  planning-poker :
    image : axeleroy/self-host-planning-poker:latest
    ports :
      - 8000:8000
    volumes :
      - planning-poker-data:/data
volumes :
  planning-poker-data : {}

Variáveis ​​de ambiente

Variável	Significado	Exemplo
APP_ROOT (opcional)	Permite que você implante para outro caminho que não / . Consulte Exemplos de configuração para implantação em sub -paths para obter mais detalhes.	APP_ROOT=/poker/

Correndo atrás de um proxy reverso

Consulte a documentação do Socket.io para configurar seu proxy reverso para funcionar corretamente com o soquete.io.

Personalização

Consulte Personalizando o estilo e o ícone do aplicativo.

Envolver -se

Eu sou um desenvolvedor e quero ajudar

Você pode abrir solicitações de tração de tração no projeto ou com a marca de relações públicas. Não se esqueça de mencionar o problema que você deseja fechar

Eu sou um usuário e preciso de ajuda / encontrei um bug / tenho uma solicitação de recurso

Abra um problema e eu vou dar uma olhada nele.

Eu sou um usuário e quero contribuir com traduções

Existe um projeto de crowdin que permite adicionar traduções para o seu idioma. Se o seu idioma não estiver disponível, não hesite em entrar em contato comigo com o Crowdin.

Desenvolvimento

O aplicativo consiste em duas partes:

• Um back-end escrito em python com frasco, balão-socketio e peewee.
• um front-end escrito com angular e soquete.io.

Desenvolvimento de back-end

Você deve primeiro inicializar um ambiente virtual e instalar as dependências

 # Run the following commands in the flask/ folder
python3 -m venv env
source env/bin/activate
pip3 install -r requirements.txt

Em seguida, o lançamento do servidor de desenvolvimento é tão fácil quanto isso:

FLASK_DEBUG=1 python app.py

Executar testes de unidade

Depois de inicializar o ambiente virtual, execute este comando no flask/ diretório:

python -m unittest

Desenvolvimento front-end

Nota: Você pode querer testar o front-end em relação a um back-end. Você pode seguir as instruções na seção anterior para instalar e executá -la localmente ou usar o seguinte comando para executá -lo em um contêiner do docker:

docker run --rm -it 
  -v $( pwd ) /flask:/app 
  -p 5000:5000 
  python:3.11-slim 
  bash -c " cd /app; pip install -r requirements.txt; FLASK_DEBUG=1 gunicorn --worker-class eventlet -w 1 app:app --bind 0.0.0.0:5000 "

Primeiro, verifique se o Node.js (de preferência LTS) está instalado. Em seguida, instale dependências e inicie o servidor de desenvolvimento

 # Run the following commands in the angular/ folder
npm install
npm start

Imagem do Docker de construção

 # After checking out the project
docker build . -t axeleroy/self-host-planning-poker:custom
# Alternatively, if you don't want to checkout the project
docker build https://github.com/axeleroy/self-host-planning-poker -t axeleroy/self-host-planning-poker:custom