marcogll/talia_bot
1
0
Fork 0
mirror of https://github.com/marcogll/talia_bot.git synced 2026-01-14 04:55:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: Add comprehensive comments and update README

Browse Source 
This commit adds detailed inline comments and docstrings to all modules within the `app/modules/` directory to improve code clarity, readability, and maintainability.

It also updates the `README.md` file to include `create_tag.py` and `print.py` in the "Módulos Funcionales" section, ensuring the documentation is synchronized with the codebase.
This commit is contained in:
google-labs-jules[bot]
2025-12-18 05:37:21 +00:00
parent 02dba09599
commit 7079348d00
9 changed files with 149 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
app/modules/aprobaciones.py
View File

@@ -1,8 +1,20 @@
# app/modules/aprobaciones.py
"""
This module manages the approval workflow for requests made by the team.
It provides functions to view pending requests and to handle the approval or
rejection of those requests. The primary user for this module is the "owner"
role, who has the authority to approve or deny requests.
"""
from telegram import InlineKeyboardButton, InlineKeyboardMarkup
def get_approval_menu(request_id):
"""Returns an inline keyboard for approving or rejecting a request."""
"""
Creates and returns an inline keyboard with "Approve" and "Reject" buttons.
Each button is associated with a specific request_id through the
callback_data, allowing the bot to identify which request is being acted upon.
"""
keyboard = [
[
InlineKeyboardButton("✅ Aprobar", callback_data=f'approve:{request_id}'),
@@ -13,10 +25,13 @@ def get_approval_menu(request_id):
def view_pending():
"""
Shows the owner a list of pending requests with approval buttons.
For now, it returns a hardcoded list of proposals.
Shows the owner a list of pending requests that require their attention.
Currently, this function uses a hardcoded list of proposals for demonstration.
In a production environment, this would fetch data from a database or another
persistent storage mechanism where pending requests are tracked.
"""
# TODO: Fetch pending requests from a database or webhook events
# TODO: Fetch pending requests dynamically from a database or webhook events.
proposals = [
{"id": "prop_001", "desc": "Grabación de proyecto", "duration": 4, "user": "Equipo A"},
{"id": "prop_002", "desc": "Taller de guion", "duration": 2, "user": "Equipo B"},
@@ -25,7 +40,7 @@ def view_pending():
if not proposals:
return "No hay solicitudes pendientes.", None
# For simplicity, we'll just show the first pending proposal
# For demonstration purposes, we'll just show the first pending proposal.
proposal = proposals[0]
text = (
@@ -35,21 +50,28 @@ def view_pending():
f"⏳ *Duración:* {proposal['duration']} horas"
)
# Attach the approval menu to the message.
reply_markup = get_approval_menu(proposal['id'])
return text, reply_markup
def handle_approval_action(callback_data):
"""
Handles the owner's approval or rejection of a request.
Handles the owner's response (approve or reject) to a request.
This function is triggered when the owner clicks one of the buttons created
by get_approval_menu. It parses the callback_data to determine the action
and the request ID.
"""
action, request_id = callback_data.split(':')
if action == 'approve':
# TODO: Update the status of the request to 'approved'
# TODO: Implement logic to update the request's status to 'approved'.
# This could involve updating a database and notifying the requester.
return f"✅ La solicitud *{request_id}* ha sido aprobada."
elif action == 'reject':
# TODO: Update the status of the request to 'rejected'
# TODO: Implement logic to update the request's status to 'rejected'.
# This could involve updating a database and notifying the requester.
return f"❌ La solicitud *{request_id}* ha sido rechazada."
return "Acción desconocida.", None