https://github.com/cybercog/telegram-devpoker-bot
Planning Poker (Scrum Poker) for Agile software development teams. The bot allows you to introduce a consensus-based, gamified technique of task estimating into Telegram group chats.
https://github.com/cybercog/telegram-devpoker-bot
backlog backlog-refinement chat-bot chat-bots collaboration estimating grooming planning-poker planning-poker-game planning-tool scrum-poker software-development telegram telegram-bot telegram-bots
Last synced: 10 months ago
JSON representation
Planning Poker (Scrum Poker) for Agile software development teams. The bot allows you to introduce a consensus-based, gamified technique of task estimating into Telegram group chats.
- Host: GitHub
- URL: https://github.com/cybercog/telegram-devpoker-bot
- Owner: cybercog
- License: mit
- Created: 2022-08-13T16:31:13.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2022-09-16T06:45:01.000Z (over 3 years ago)
- Last Synced: 2023-08-05T00:11:58.480Z (almost 3 years ago)
- Topics: backlog, backlog-refinement, chat-bot, chat-bots, collaboration, estimating, grooming, planning-poker, planning-poker-game, planning-tool, scrum-poker, software-development, telegram, telegram-bot, telegram-bots
- Language: Python
- Homepage:
- Size: 45.9 KB
- Stars: 4
- Watchers: 3
- Forks: 3
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Telegram DevPoker Bot
Planning Poker (Scrum Poker) for Agile software development teams.
The bot allows you to introduce a consensus-based, gamified technique of task estimating into Telegram group chats.
## Usage
> ⚠️ Work in progress. Public bot may be offline until the first stable release.
Add [@devpoker_bot](https://t.me/devpoker_bot?startgroup=true) to the group chat.
To start **Planning Poker** use `/poker` command.
Add any description after the command to provide context.
Example:
```
/poker https://issue.tracker/TASK-123
```
Example with multiline description:
```
/poker https://issue.tracker/TASK-123
Design DevPoker bot keyboard layout
```
Only initiator can open cards or restart game at any moment.
### Discussion phase
Discussion phase votes:
* 👍 — Ready to estimate
* ⁉️ — I have a questions or something to add
* ✂️ — Split task into subtasks
* ☠️️ — Cancel task (already done or not actual)
* ♾️ — Impossible to estimate or task cannot be completed
* ☕️ — I need a break
### Estimation phase
Currently, there is only one sequence of numbers:
```
0.5, 1, 2, 3, 4, 5
6, 7, 8, 9, 10, 12
18, 24, 30, 36
```
Special cases:
* ❓ — Unsure how to estimate (out of context, never solved such tasks)
## Self-hosted usage
Bot works on Python 3.6.
Run `run.sh` script with bot api token to start the Docker container.
You need to obtain own bot token from https://t.me/BotFather, then run:
```shell
DEVPOKER_BOT_API_TOKEN=11111424242:some-token ./run.sh
```
This command will create image and container `devpoker-bot`.
Bot uses SQLite database at host in `~/.devpoker_bot/devpoker_bot.db`.
## Credits
This project is inspired by the [tg-planning-poker](https://github.com/reclosedev/tg-planning-poker).
## License
- `Telegram DevPoker Bot` is open-sourced software licensed under the [MIT license](LICENSE) by [Anton Komarev].
## About CyberCog
[CyberCog] is a Social Unity of enthusiasts.
Research the best solutions in product & software development is our passion.
- [Follow us on Twitter](https://twitter.com/cybercog)
[Anton Komarev]: https://komarev.com
[CyberCog]: https://cybercog.su