Shift Planner

Planification de quarts optimises pour maximiser les revenus gig.

Calcul objectif --> heures necessaires

def hours_to_target(weekly_target: float, avg_hourly_rate: float, expense_pct: float = 0.15) -> dict:
    net_hourly = avg_hourly_rate * (1 - expense_pct)
    hours_needed = weekly_target / net_hourly
    return {
        'heures_necessaires': round(hours_needed, 1),
        'taux_net_estime': round(net_hourly, 2),
        'shifts_de_5h': round(hours_needed / 5, 1),
        'shifts_de_8h': round(hours_needed / 8, 1),
    }

# Ex: objectif 1500$/sem, taux brut 32$/h
# --> 54.3h brutes, 10.9 shifts de 5h

Valeurs par creneau (Grand Montreal)

# Revenu estime par heure selon jour et heure
# (jour_semaine: 0=Lun, 6=Dim)
SLOT_REVENUE = {
    (4, 17, 23): 38,  # Vendredi soir
    (5,  0,  4): 44,  # Nuit samedi -- sorties
    (5, 10, 16): 29,  # Samedi journee
    (5, 17, 23): 40,  # Samedi soir
    (6,  0,  3): 37,  # Nuit dimanche
    (6, 10, 16): 26,  # Dimanche brunch/journee
    (3, 17, 23): 31,  # Jeudi soir
    (0, 17, 22): 28,  # Lundi soir
    (1, 17, 22): 27,  # Mardi soir
    (2, 17, 22): 28,  # Mercredi soir
    (0,  6,  9): 30,  # Lundi rush matinal
    (1,  6,  9): 30,  # Mardi rush matinal
    (2,  6,  9): 30,  # Mercredi rush matinal
    (3,  6,  9): 31,  # Jeudi rush matinal
    (4,  6,  9): 33,  # Vendredi rush matinal
}

def optimize_week(target: float, max_hours: int = 50) -> list:
    slots = sorted(SLOT_REVENUE.items(), key=lambda x: -x[1])
    plan, total_rev, total_hrs = [], 0, 0
    day_names = ['Lun', 'Mar', 'Mer', 'Jeu', 'Ven', 'Sam', 'Dim']

    for (day, start, end), rate in slots:
        if total_hrs >= max_hours or total_rev >= target:
            break
        avail = end - start
        hours = min(avail, max_hours - total_hrs)
        rev = hours * rate
        plan.append({
            'jour': day_names[day],
            'debut': f"{start:02d}h",
            'fin': f"{start+hours:02d}h",
            'heures': hours,
            'revenu_estime': rev,
            'taux': rate,
        })
        total_rev += rev
        total_hrs += hours

    return plan, round(total_rev, 2), total_hrs