Files
benevoles/backend/app/api/positions.py
T
AdamThomasandClaude Sonnet 5 f58ec00e30 Créneaux types : paramétrage + génération auto des créneaux
Le paramétrage des créneaux se fait dans « Règles & édition » : la coordination
définit des créneaux types (DayPart). À la création d'un poste, un créneau à
besoin 0/0 est généré pour chaque jour de l'édition et chaque créneau type ;
les coordinateurs ajustent ensuite min/idéal.

Back-end :
- DayPart CRUD (GET/POST/PATCH/DELETE /editions/{id}/day-parts). Code figé
  après création (slugifié depuis le libellé si absent), unique par édition.
- Shift.day_part_id (nullable, SET NULL) + migration 0004.
- create_position génère les créneaux ; POST .../positions/{pid}/generate-shifts
  recrée les manquants (idempotent, ne touche pas aux besoins déjà réglés).
- 13 tests (day-parts, génération, extension d'édition, ajout de type).

Front-end :
- api/hooks/mock : dayParts CRUD + positions.generateShifts.
- ConfigRules : panneau « Créneaux types » (libellé + horaires éditables,
  ajout, suppression).
- ConfigGrid : bouton « Générer les créneaux » sur l'en-tête du poste.
- GrillePage : case « à définir » (gris, glyphe ·) quand min=idéal=0, avec
  entrée de légende.

155 tests back OK ; typecheck + lint + build + smoke front OK.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017uUsRg7XzopkCPWimwg9ZM
2026-09-10 20:57:51 +02:00

119 lines
3.8 KiB
Python

"""CRUD des postes."""
import uuid
from fastapi import APIRouter, Depends, Response, status
from sqlmodel import Session, select
from app.api._common import owned_or_404
from app.api._shiftgen import generate_missing_shifts
from app.api.deps import get_edition
from app.api.schemas import (
GenerateShiftsResult,
PositionCreate,
PositionRead,
PositionUpdate,
)
from app.auth.deps import (
current_account_in_edition,
ensure_can_write_position,
require_coordinator,
require_staff,
)
from app.db import get_session
from app.models import Account, Edition, Position
router = APIRouter(
prefix="/editions/{edition_id}/positions", tags=["positions"]
)
@router.post("", response_model=PositionRead, status_code=status.HTTP_201_CREATED)
def create_position(
payload: PositionCreate,
edition: Edition = Depends(get_edition),
_guard: Account = Depends(require_coordinator),
session: Session = Depends(get_session),
) -> Position:
position = Position(edition_id=edition.id, **payload.model_dump())
session.add(position)
session.flush()
# Un créneau à besoin 0/0 par jour et par créneau type de l'édition.
generate_missing_shifts(session, edition, position)
session.commit()
session.refresh(position)
return position
@router.get("", response_model=list[PositionRead])
def list_positions(
edition: Edition = Depends(get_edition),
_guard: Account = Depends(require_staff),
session: Session = Depends(get_session),
) -> list[Position]:
return list(
session.exec(
select(Position)
.where(Position.edition_id == edition.id)
.order_by(Position.name)
)
)
@router.get("/{position_id}", response_model=PositionRead)
def get_position(
position_id: uuid.UUID,
edition: Edition = Depends(get_edition),
_guard: Account = Depends(require_staff),
session: Session = Depends(get_session),
) -> Position:
return owned_or_404(session.get(Position, position_id), edition.id)
@router.patch("/{position_id}", response_model=PositionRead)
def update_position(
position_id: uuid.UUID,
payload: PositionUpdate,
edition: Edition = Depends(get_edition),
account: Account = Depends(current_account_in_edition),
session: Session = Depends(get_session),
) -> Position:
position = owned_or_404(session.get(Position, position_id), edition.id)
ensure_can_write_position(account, position)
for field, value in payload.model_dump(exclude_unset=True).items():
setattr(position, field, value)
session.commit()
session.refresh(position)
return position
@router.post(
"/{position_id}/generate-shifts", response_model=GenerateShiftsResult
)
def generate_shifts(
position_id: uuid.UUID,
edition: Edition = Depends(get_edition),
account: Account = Depends(current_account_in_edition),
session: Session = Depends(get_session),
) -> GenerateShiftsResult:
"""(Re)génère les créneaux manquants du poste après un ajout de créneau
type ou une extension des dates de l'édition. N'écrase rien d'existant."""
position = owned_or_404(session.get(Position, position_id), edition.id)
ensure_can_write_position(account, position)
created = generate_missing_shifts(session, edition, position)
session.commit()
return GenerateShiftsResult(created=created)
@router.delete("/{position_id}", status_code=status.HTTP_204_NO_CONTENT)
def delete_position(
position_id: uuid.UUID,
edition: Edition = Depends(get_edition),
_guard: Account = Depends(require_coordinator),
session: Session = Depends(get_session),
) -> Response:
position = owned_or_404(session.get(Position, position_id), edition.id)
session.delete(position)
session.commit()
return Response(status_code=status.HTTP_204_NO_CONTENT)