UserTaskScreen

​

Overview

​

Purpose

• View all tasks assigned to them across all teams
• Filter tasks by status (No Iniciado, En desarrollo, Finalizado)
• Update their display name
• See task details and progress

​

Constructor

const UserTasksScreen({super.key, required this.userId});

​

Key Components

​

State Variables

​

Key Methods

​

initState()

@override
void initState() {
  super.initState();
  final User? user = FirebaseAuth.instance.currentUser;
  userName = user?.displayName ?? 'Usuario sin nombre';
  userEmail = user?.email ?? '[email protected]';
}

​

updateUserName()

void updateUserName(String newName) async {
  User? user = FirebaseAuth.instance.currentUser;

  if (user != null) {
    await user.updateDisplayName(newName);
    await user.reload();
    setState(() {
      userName = newName;
    });
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text('Nombre actualizado a: $newName')),
    );
  }
}

​

showUpdateNameDialog()

void showUpdateNameDialog() {
  TextEditingController nameController = TextEditingController();

  showDialog(
    context: context,
    builder: (context) => AlertDialog(
      shape: RoundedRectangleBorder(
        borderRadius: BorderRadius.circular(20),
      ),
      title: const Center(
        child: Text(
          'Actualizar Nombre',
          style: TextStyle(
            fontWeight: FontWeight.bold,
            fontSize: 20,
          ),
        ),
      ),
      content: TextField(
        controller: nameController,
        decoration: InputDecoration(
          hintText: 'Introduce tu nombre',
          filled: true,
          fillColor: Colors.grey[200],
          border: OutlineInputBorder(
            borderRadius: BorderRadius.circular(15),
            borderSide: BorderSide.none,
          ),
        ),
      ),
      actions: [
        TextButton(
          onPressed: () => Navigator.pop(context),
          child: const Text('Cancelar'),
        ),
        ElevatedButton(
          onPressed: () {
            updateUserName(nameController.text);
            Navigator.pop(context);
          },
          child: const Text('Guardar'),
        ),
      ],
    ),
  );
}

​

UI Structure

​

AppBar

• Title: “Mis Tareas” (My Tasks)
• Back Button: Returns to previous screen
• Edit Name Action: IconButton to show name update dialog

​

Status Filter

• No Iniciado (Not Started) - Red chip
• En desarrollo (In Progress) - Orange chip
• Finalizado (Completed) - Green chip

​

Task List

• Shows tasks assigned to the user with selected status
• Real-time updates via Firestore snapshots
• Empty state message when no tasks match filter

​

Firestore Query

Stream<QuerySnapshot> tasksStream = FirebaseFirestore.instance
    .collection('tasks')
    .where('responsibleId', isEqualTo: widget.userId)
    .where('status', isEqualTo: selectedStatus)
    .snapshots();

​

Query Conditions

1. responsibleId: Matches the provided userId parameter
2. status: Matches the currently selected status filter

​

Task Status Values

​

Data Flow

​

Task Display

• Title: Task name
• Subtitle: Task description
• Status Icon: Visual indicator based on status
  • Red pending icon for “No Iniciado”
  • Orange clock for “En desarrollo”
  • Green check for “Finalizado”

​

Navigation

• TaskScreen AppBar action button (assignment icon)
• Shows tasks for the current logged-in user

​

Best Practices

1. Use Streams: Real-time updates via StreamBuilder
2. Index Queries: Ensure Firestore has composite index for userId + status
3. Handle Empty States: Show meaningful message when no tasks
4. Validate Name: Check non-empty before updating display name
5. User Feedback: Show SnackBar confirmations for actions

​

Performance Considerations

​

Firestore Indexing

Collection: tasks
Fields indexed:
  - responsibleId (Ascending)
  - status (Ascending)

​

Query Efficiency

• Filters applied at database level
• Only matching documents returned
• Real-time listener updates automatically
• Consider pagination for large task lists

​

Error Handling

• User Not Found: Falls back to default names
• Stream Errors: Handled by StreamBuilder
• Update Failures: Display error SnackBar
• Empty Name: Validate before updating

​

Related Components