AddTaskScreen

​

Screen Overview

​

Purpose

• Display of team information and members
• Task list for the current user
• Task creation with detailed properties
• Task editing and status updates
• Task deletion with confirmation
• Team member management and search

​

Constructor

const AddTaskScreen({required this.team, super.key})

​

State Management

​

State Variables

​

Firebase Services

• FirebaseFirestore (_firestore): Database operations for tasks, teams, and users
• FirebaseAuth (_auth): Authentication to get current user
• Logger (logger): Global logger instance for debugging

​

Key Functionality

​

Task Operations

​

Fetching Tasks

Future<void> _fetchTasks()

• teamId equals the current team’s ID
• responsibleId equals the current user’s ID

​

Adding Tasks

Future<void> _addTask()

1. Shows modal dialog with task creation form
2. Passes team data and team members
3. Refreshes task list on completion

​

Updating Tasks

void _updateTask(
  String taskId,
  String currentName,
  String currentDescription,
  DateTime? startDate,
  DateTime? endDate,
  String? currentStatus,
)

• Task title
• Description
• Start date (date picker)
• End date (date picker)
• Status (3 options)

​

Deleting Tasks

Future<void> _deleteTask(String taskId)

Future<void> _showDeleteTaskWarning(String taskId)

• Trash icon in circular avatar
• Warning message about permanent deletion
• Aceptar/Cancelar buttons

​

Team Member Operations

​

Fetching Team Members

Future<void> _fetchTeamMembers()

1. Gets team document from Firestore
2. Extracts member IDs array
3. Fetches user details for each member
4. Updates teamMembers state

​

Adding Members

void _addMember()

void _addMemberToTeam(String userId)

​

Viewing Assigned Members

void _showAssignedMembersDialog(String? assignedMemberId)

​

UI Components

​

App Bar

• Large back button (yellow chevron, #FFEE93, 45px)
• No title

​

Team Header

Center(
  child: Text(
    '${widget.team['name']}',
    style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
  ),
)

​

Members List

ListView.builder(
  shrinkWrap: true,
  physics: const NeverScrollableScrollPhysics(),
  itemCount: teamMembers.length,
  // ...
)

• Member avatar (NetworkImage or placeholder)
• Member name

​

Tasks List

Expanded(
  child: tasks.isNotEmpty
    ? ListView.builder(...)
    : const Center(child: Text('No hay tareas')),
)

• Task name (title)
• Task description (subtitle)
• Edit button (pencil icon)
• Delete button (trash icon in pink circle)
• Divider between tasks

​

Floating Action Buttons

• Black background
• White icon
• Circular shape (100px border radius)

​

Dialogs

​

Task Creation Dialog

• Task name input
• Description input
• Member selection
• Start/end date pickers
• Status selection

​

Task Edit Dialog

1. Título - TextField with gray background (#F0EEEE)
2. Descripción - TextField with gray background
3. Fecha de inicio - Date picker with calendar icon
4. Fecha de fin - Date picker with calendar icon
5. Estado - Three status buttons

• Actualizar (green #C8E2B3): Saves changes to Firestore
• Cancelar (gray #C6C6C6): Closes dialog without saving

​

Delete Confirmation Dialog

AlertDialog(
  shape: RoundedRectangleBorder(
    borderRadius: BorderRadius.circular(20.0),
  ),
  // ...
)

• Circular trash icon avatar (#FF9393)
• Title: “¿Desea eliminar la tarea?”
• Warning: “Recuerda que la tarea eliminada no se podrá recuperar.”
• Aceptar/Cancelar buttons

​

Add Member Dialog

• Green circular icon (#E5F4DD background, #7FC47F icon)
• Search field with real-time Firestore query
• Results list with name and email
• Aceptar/Cancelar buttons

void _searchUsers(String query)

• Searches users by name
• Uses isGreaterThanOrEqualTo and isLessThanOrEqualTo for prefix matching
• Updates searchResults state

​

Date Formatting

import 'package:intl/intl.dart';

DateFormat('yyyy-MM-dd').format(updatedStartDate)

​

Code Structure

​

Main Widget

• AddTaskScreen (StatefulWidget): Widget definition with team parameter
• AddTaskScreenState (State): State management and business logic

​

Helper Widget

• AddMemberDialog (StatefulWidget): Separate widget for member search
• AddMemberDialogState (State): Search state management

​

Method Organization

1. Initialization: initState(), fetching methods
2. Task CRUD: _fetchTasks(), _addTask(), _updateTask(), _deleteTask()
3. Member CRUD: _fetchTeamMembers(), _addMember(), _addMemberToTeam()
4. UI helpers: showAssignedMembers(), _showAssignedMembersDialog(), _showDeleteTaskWarning()
5. Build methods: build()

​

Layout Structure

Scaffold
├── AppBar
│   └── IconButton (back)
├── Body: Padding
│   └── Column
│       ├── Text (team name, centered)
│       ├── Text ("Tareas del equipo", centered)
│       ├── Text ("Miembros")
│       ├── ListView.builder (members)
│       ├── Divider
│       ├── Text ("Tareas")
│       └── Expanded
│           └── ListView.builder (tasks) | "No hay tareas"
└── FloatingActionButton (Row)
    ├── FAB (add member)
    └── FAB (add task)

​

Error Handling

try {
  // Firestore operation
} catch (e) {
  logger.e('Error message: $e');
}

​

Widget Lifecycle

​

Navigation

​

Performance Considerations