📖 Project Description
A Telegram bot is needed for managing and controlling employee (manager) tasks.
Goal:
— so that employees do not forget tasks
— so that I can see the status of completion
— so that the bot reminds and records progress by itself
🎯 Core Functionality (mandatory)
1. Task Creation
Only the admin (me) can create tasks.
Task fields:
- Title
- Description
- Responsible (selection from the user list)
- Deadline (date + time)
- Priority (low / medium / high)
2. Working with the Task (for the employee)
The employee receives the task in Telegram.
Inside the task, they see:
- title
- description
- deadline
- priority
Buttons:
- ✅ Took it to work
- 🔄 Update status
- 📝 Send comment
- ⏳ Postpone deadline
- ✔️ Complete task
3. Task Statuses
Fixed statuses:
- not started
- in progress
- completed
- overdue
4. Reminders
The bot automatically reminds the employee:
- 24 hours before the deadline
- 3 hours before
- at the moment of the deadline
If the task is not completed:
- marked as “overdue”
- notification sent to the employee
- notification sent to the admin
5. Postponing the Deadline
When postponing the deadline, the employee MUST:
All postponements must be saved in history.
6. Comments and Progress
The employee can:
- send a text comment
- send a photo / file (preferably, but not mandatory in MVP)
All comments are saved.
7. Completing the Task
When the employee clicks “complete”:
- the task receives the status “completed”
- the admin receives a notification
8. Viewing Tasks (admin)
I (admin) must see:
- all tasks
- tasks for each employee
- overdue tasks
- tasks for today
9. Daily Summary (admin)
Once a day, the bot sends:
- how many tasks are in progress
- how many are completed
- how many are overdue
- a list of problematic tasks
⚙️ Technical Requirements
- Telegram Bot API
- Language: Python (preferred) or Node.js
👤 Roles
Admin:
- creates tasks
- sees all tasks
- receives notifications
Employee:
- receives tasks
- updates status
- writes comments
- completes tasks
🔔 Notifications
The bot should send:
- new task to the employee
- reminders about the deadline
- notification about overdue
- notification to the admin about completion
- notification to the admin about overdue
📊 Action History
For each task, the history must be stored:
- creation
- status change
- deadline postponement
- comments
🚀 MVP (first version)
Must implement:
- task creation
- statuses
- deadline
- reminders
- comments
- completion
- task viewing by admin
- notifications
❗ Important
- the interface must be as simple as possible (buttons, without complex commands)
- all actions — through inline buttons
- minimum amount of manual input
- the code must be clean and extensible
💰 Additionally (as a plus)
It would be a plus if the developer:
- suggests UX improvements
- proposes architecture for scaling
- can further develop the project
📌 Conclusion
A simple, stable Telegram bot is needed that:
- reminds about tasks
- records completion
- shows me the real picture
The bot is deployed by you, tested, and then uploaded to my server (I do not provide access to the server)