Impossible de charger la documentation : {str(e)}
", status_code=500 ) # --- ENDPOINTS API --- @app.get( "/api/v1/tasks", response_model=List[TaskResponse], dependencies=[Depends(verify_api_key)], summary="Récupérer toutes les tâches" ) def read_tasks( status: Optional[TaskStatus] = None, db: Session = Depends(get_session) ): """ Récupère la liste de toutes les tâches stockées. Permet de filtrer optionnellement par statut (A faire, En cours, Termine). """ try: statement = select(Task) if status: statement = statement.where(Task.status == status) # Tri automatique : d'abord les tâches "En cours", puis "À faire", et enfin les "Terminé". # En second critère, on trie par date de création décroissante. tasks = db.exec(statement).all() # Tri personnalisé côté serveur pour optimiser l'affichage du widget status_priority = {TaskStatus.IN_PROGRESS: 0, TaskStatus.TODO: 1, TaskStatus.DONE: 2} tasks.sort(key=lambda t: (status_priority.get(t.status, 9), t.created_at), reverse=False) return tasks except Exception as e: # Journaliser et renvoyer une erreur interne propre raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=f"Erreur lors de la récupération des tâches : {str(e)}" ) @app.get( "/api/v1/tasks/{task_id}", response_model=TaskResponse, dependencies=[Depends(verify_api_key)], summary="Récupérer les détails d'une tâche" ) def read_task(task_id: UUID, db: Session = Depends(get_session)): """ Récupère une tâche spécifique par son UUID. Renvoie une erreur 404 si la tâche n'existe pas. """ task = db.get(Task, task_id) if not task: raise HTTPException( status_code=status.HTTP_404_NOT_FOUND, detail="Tâche introuvable." ) return task @app.post( "/api/v1/tasks", response_model=TaskResponse, status_code=status.HTTP_201_CREATED, dependencies=[Depends(verify_api_key)], summary="Créer une nouvelle tâche" ) def create_task(task_create: TaskCreate, db: Session = Depends(get_session)): """ Crée une nouvelle tâche avec une date de création automatique et un UUID unique. """ try: new_task = Task.model_validate(task_create) db.add(new_task) db.commit() db.refresh(new_task) return new_task except Exception as e: db.rollback() raise HTTPException( status_code=status.HTTP_400_BAD_REQUEST, detail=f"Impossible de créer la tâche : {str(e)}" ) @app.put( "/api/v1/tasks/{task_id}", response_model=TaskResponse, dependencies=[Depends(verify_api_key)], summary="Mettre à jour une tâche existante" ) def update_task( task_id: UUID, task_update: TaskUpdate, db: Session = Depends(get_session) ): """ Met à jour partiellement ou totalement une tâche. Met automatiquement à jour le champ updated_at. """ task = db.get(Task, task_id) if not task: raise HTTPException( status_code=status.HTTP_404_NOT_FOUND, detail="Tâche introuvable pour mise à jour." ) try: # Extraction des champs soumis pour une mise à jour partielle update_data = task_update.model_dump(exclude_unset=True) for key, value in update_data.items(): setattr(task, key, value) # Mise à jour systématique de l'horodatage de modification task.updated_at = datetime.utcnow() db.add(task) db.commit() db.refresh(task) return task except Exception as e: db.rollback() raise HTTPException( status_code=status.HTTP_400_BAD_REQUEST, detail=f"Erreur lors de la mise à jour de la tâche : {str(e)}" ) @app.delete( "/api/v1/tasks/{task_id}", status_code=status.HTTP_204_NO_CONTENT, dependencies=[Depends(verify_api_key)], summary="Supprimer une tâche" ) def delete_task(task_id: UUID, db: Session = Depends(get_session)): """ Supprime définitivement une tâche par son UUID. """ task = db.get(Task, task_id) if not task: raise HTTPException( status_code=status.HTTP_404_NOT_FOUND, detail="Tâche introuvable pour suppression." ) try: db.delete(task) db.commit() return None except Exception as e: db.rollback() raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=f"Erreur lors de la suppression de la tâche : {str(e)}" )