feat: add credits logic

backend/app/models/participant.py

@@ -69,7 +69,15 @@ class Participant(Base):
         default=0,
         nullable=False,
         index=True,
-        comment="Current total points accumulated"
+        comment="Current total points accumulated (never decreases)"
+    )
+
+    # Pack Credits - separate from points, used to purchase packs
+    pack_credits = Column(
+        Integer,
+        default=0,
+        nullable=False,
+        comment="Credits for purchasing packs (1 point earned = 1 credit)"
     )
 
     # Pack Inventory (Phase 2 feature, prepared for future use)
@@ -125,7 +133,10 @@ class Participant(Base):
 
     def add_points(self, amount: int) -> None:
         """
-        Add points to the participant's total.
+        Add points to the participant's total AND pack credits.
+
+        Points are used for leaderboard ranking and never decrease.
+        Pack credits are also added (1:1 ratio) and can be spent on packs.
 
         Args:
             amount: Points to add (positive integer)
@@ -134,24 +145,27 @@ class Participant(Base):
             ValueError: If amount is negative
         """
         if amount < 0:
-            raise ValueError("Cannot add negative points. Use subtract_points() instead.")
+            raise ValueError("Cannot add negative points.")
         self.total_points += amount
+        self.pack_credits += amount
 
-    def subtract_points(self, amount: int) -> None:
+    def subtract_credits(self, amount: int) -> None:
         """
-        Subtract points from the participant's total.
+        Subtract pack credits (used for purchasing packs).
+
+        Note: This does NOT affect total_points, which never decrease.
 
         Args:
-            amount: Points to subtract (positive integer)
+            amount: Credits to subtract (positive integer)
 
         Raises:
-            ValueError: If amount is negative or would result in negative total
+            ValueError: If amount is negative or insufficient credits
         """
         if amount < 0:
-            raise ValueError("Cannot subtract negative points. Use add_points() instead.")
-        if self.total_points - amount < 0:
-            raise ValueError("Insufficient points. Cannot have negative total points.")
-        self.total_points -= amount
+            raise ValueError("Cannot subtract negative credits.")
+        if self.pack_credits < amount:
+            raise ValueError(f"Insufficient credits. Need {amount}, have {self.pack_credits}")
+        self.pack_credits -= amount
 
     def add_pack(self, pack_tier: str) -> None:
         """

backend/app/schemas/participant.py

@@ -104,7 +104,8 @@ class ParticipantResponse(ParticipantBase):
     Used in GET requests and as part of other responses.
     """
     id: int = Field(..., description="Unique participant ID")
-    total_points: int = Field(..., description="Current total points")
+    total_points: int = Field(..., description="Current total points (never decreases)")
+    pack_credits: int = Field(..., description="Credits available for purchasing packs")
     current_packs: dict = Field(
         ...,
         description="Pack counts for each tier (bronze, silver, gold, ultimate)"
@@ -122,6 +123,7 @@ class ParticipantResponse(ParticipantBase):
                 "avatar_url": "https://example.com/avatars/paul.jpg",
                 "is_groom": True,
                 "total_points": 350,
+                "pack_credits": 150,
                 "current_packs": {
                     "bronze": 2,
                     "silver": 1,
@@ -145,6 +147,7 @@ class ParticipantSummary(BaseModel):
     avatar_url: Optional[str] = None
     is_groom: bool
     total_points: int
+    pack_credits: int
 
     class Config:
         """Pydantic configuration."""
@@ -155,7 +158,8 @@ class ParticipantSummary(BaseModel):
                 "name": "Paul C.",
                 "avatar_url": "https://example.com/avatars/paul.jpg",
                 "is_groom": True,
-                "total_points": 350
+                "total_points": 350,
+                "pack_credits": 150
             }
         }
 
@@ -182,6 +186,7 @@ class ParticipantWithRank(ParticipantSummary):
                 "avatar_url": "https://example.com/avatars/paul.jpg",
                 "is_groom": True,
                 "total_points": 350,
+                "pack_credits": 150,
                 "rank": 1,
                 "points_today": 75
             }

backend/app/services/leaderboard_service.py

@@ -47,6 +47,7 @@ def get_leaderboard(db: Session, include_today_points: bool = False) -> List[Par
             avatar_url=participant.avatar_url,
             is_groom=participant.is_groom,
             total_points=participant.total_points,
+            pack_credits=participant.pack_credits,
             rank=rank,
             points_today=points_today
         )
@@ -153,6 +154,7 @@ def get_daily_leader(db: Session) -> ParticipantWithRank:
         avatar_url=participant.avatar_url,
         is_groom=participant.is_groom,
         total_points=participant.total_points,
+        pack_credits=participant.pack_credits,
         rank=get_participant_rank(db, participant.id),
         points_today=leader_data["points_today"]
     )

backend/app/services/pack_service.py

@@ -330,9 +330,10 @@ def _get_animation_effects(rarity: str) -> list[str]:
 
 def purchase_pack(db: Session, participant_id: int, tier: str) -> None:
     """
-    Purchase a pack using points.
+    Purchase a pack using pack credits.
 
-    Deducts points from participant and adds pack to inventory.
+    Deducts credits from participant and adds pack to inventory.
+    Note: This does NOT affect total_points, which never decrease.
 
     Args:
         db: Database session
@@ -340,11 +341,11 @@ def purchase_pack(db: Session, participant_id: int, tier: str) -> None:
         tier: Pack tier to purchase (bronze/silver/gold/ultimate)
 
     Raises:
-        ValueError: If participant not found, invalid tier, or insufficient points
+        ValueError: If participant not found, invalid tier, or insufficient credits
 
     Example:
         >>> purchase_pack(db, 1, "bronze")
-        >>> # Deducts 100 points and adds 1 bronze pack
+        >>> # Deducts 100 credits and adds 1 bronze pack
     """
     participant = db.query(Participant).filter(Participant.id == participant_id).first()
 
@@ -356,19 +357,19 @@ def purchase_pack(db: Session, participant_id: int, tier: str) -> None:
 
     cost = PACK_COSTS[tier]
 
-    # Check if participant has enough points
-    if participant.total_points < cost:
-        raise ValueError(f"Insufficient points. Need {cost} points, have {participant.total_points}")
+    # Check if participant has enough credits
+    if participant.pack_credits < cost:
+        raise ValueError(f"Insufficient credits. Need {cost} credits, have {participant.pack_credits}")
 
-    # Deduct points
-    participant.subtract_points(cost)
+    # Deduct credits (NOT points - points never decrease)
+    participant.subtract_credits(cost)
 
     # Add pack to inventory
     participant.add_pack(tier)
 
     db.commit()
 
-    logger.info(f"Participant {participant_id} purchased {tier} pack for {cost} points")
+    logger.info(f"Participant {participant_id} purchased {tier} pack for {cost} credits")
 
 
 def add_free_pack(db: Session, participant_id: int, tier: str, count: int = 1) -> None:

backend/scripts/add_pack_credits.py

@@ -0,0 +1,52 @@
+"""
+Add pack_credits column to participants table.
+
+This migration adds a new column to track credits used for purchasing packs,
+separate from the points used for leaderboard ranking.
+"""
+
+import sys
+import os
+
+# Add parent directory to path
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))
+
+from app.database import engine
+from sqlalchemy import text
+
+
+def add_pack_credits_column():
+    """Add pack_credits column to participants table."""
+    with engine.connect() as connection:
+        # Check if column already exists
+        result = connection.execute(text(
+            "PRAGMA table_info(participants)"
+        ))
+
+        columns = [row[1] for row in result]
+
+        if 'pack_credits' in columns:
+            print("[OK] Column 'pack_credits' already exists")
+            return
+
+        # Add the column with default value equal to total_points
+        # This gives existing participants credits based on their current points
+        connection.execute(text(
+            "ALTER TABLE participants ADD COLUMN pack_credits INTEGER DEFAULT 0 NOT NULL"
+        ))
+
+        # Set pack_credits to total_points for existing participants
+        connection.execute(text(
+            "UPDATE participants SET pack_credits = total_points"
+        ))
+
+        connection.commit()
+
+        print("[OK] Added column 'pack_credits' to participants table")
+        print("[OK] Initialized pack_credits = total_points for existing participants")
+
+
+if __name__ == "__main__":
+    print("Adding pack_credits column to participants table...")
+    add_pack_credits_column()
+    print("\nMigration completed successfully!")

frontend/src/components/packs/PackCard.tsx

@@ -11,14 +11,14 @@ interface PackCardProps {
   tier: PackTier;
   count: number;
   canOpen: boolean;
-  userPoints: number;
+  userCredits: number;
   onOpen: () => void;
   onPurchase: () => void;
 }
 
-export const PackCard: React.FC<PackCardProps> = ({ tier, count, canOpen, userPoints, onOpen, onPurchase }) => {
+export const PackCard: React.FC<PackCardProps> = ({ tier, count, canOpen, userCredits, onOpen, onPurchase }) => {
   const config = PACK_CONFIG[tier];
-  const canPurchase = userPoints >= config.cost;
+  const canPurchase = userCredits >= config.cost;
 
   return (
     <motion.div
@@ -71,7 +71,7 @@ export const PackCard: React.FC<PackCardProps> = ({ tier, count, canOpen, userPo
 
           {/* Cost/Action */}
           <div className="text-text-tertiary text-xs sm:text-sm mb-3 sm:mb-4">
-            <span className="font-semibold">{config.cost} pts</span>
+            <span className="font-semibold">{config.cost} crédits</span>
           </div>
 
           {/* Buttons */}
@@ -82,19 +82,19 @@ export const PackCard: React.FC<PackCardProps> = ({ tier, count, canOpen, userPo
               </button>
             ) : canPurchase ? (
               <button className="btn-secondary w-full" onClick={(e) => { e.stopPropagation(); onPurchase(); }}>
-                ACHETER ({config.cost} pts)
+                ACHETER ({config.cost} crédits)
               </button>
             ) : (
               <button
                 className="btn-secondary w-full opacity-40 cursor-not-allowed"
                 disabled
               >
-                ACHETER ({config.cost} pts)
+                ACHETER ({config.cost} crédits)
               </button>
             )}
             {canPurchase && !canOpen && (
               <div className="text-xs text-fifa-green">
-                ✓ {userPoints} pts disponibles
+                ✓ {userCredits} crédits disponibles
               </div>
             )}
           </div>

frontend/src/pages/PacksPage.tsx

@@ -19,20 +19,22 @@ export const PacksPage = () => {
   const [selectedTier, setSelectedTier] = useState<PackTier | null>(null);
   const [openResult, setOpenResult] = useState<PackOpenResult | null>(null);
   const [showModal, setShowModal] = useState(false);
+  const [userCredits, setUserCredits] = useState<number>(0);
   const [userPoints, setUserPoints] = useState<number>(0);
   const hasShownWelcome = useRef(false);
 
-  // Fetch user points
+  // Fetch user credits and points
   useEffect(() => {
-    const fetchPoints = async () => {
+    const fetchProfile = async () => {
       try {
         const profile = await getMyProfile();
+        setUserCredits(profile.pack_credits);
         setUserPoints(profile.total_points);
       } catch (err) {
-        console.error('Failed to fetch user points:', err);
+        console.error('Failed to fetch user profile:', err);
       }
     };
-    fetchPoints();
+    fetchProfile();
   }, [inventory]); // Refresh when inventory changes
 
   // Show welcome pack notification on first load if user has exactly 1 silver pack
@@ -87,6 +89,25 @@ export const PacksPage = () => {
         <p className="text-text-secondary text-lg">
           Ouvre tes packs pour obtenir des récompenses exclusives !
         </p>
+        {/* Display Credits and Points */}
+        <div className="mt-6 flex justify-center gap-6">
+          <div className="inline-flex items-center gap-2 px-6 py-3 rounded-xl border" style={{
+            background: 'rgba(26, 41, 66, 0.75)',
+            borderColor: 'rgba(255, 255, 255, 0.1)',
+            backdropFilter: 'blur(10px)',
+          }}>
+            <span className="text-text-secondary text-sm uppercase tracking-wide">Crédits:</span>
+            <span className="font-numbers text-2xl font-bold text-fifa-gold">{userCredits}</span>
+          </div>
+          <div className="inline-flex items-center gap-2 px-6 py-3 rounded-xl border" style={{
+            background: 'rgba(26, 41, 66, 0.75)',
+            borderColor: 'rgba(255, 255, 255, 0.1)',
+            backdropFilter: 'blur(10px)',
+          }}>
+            <span className="text-text-secondary text-sm uppercase tracking-wide">Points:</span>
+            <span className="font-numbers text-2xl font-bold text-fifa-green">{userPoints}</span>
+          </div>
+        </div>
       </div>
 
       {/* Error Display */}
@@ -156,7 +177,7 @@ export const PacksPage = () => {
           tier="bronze"
           count={inventory?.bronze || 0}
           canOpen={(inventory?.bronze || 0) > 0 && !isOpening}
-          userPoints={userPoints}
+          userCredits={userCredits}
           onOpen={() => handleOpenPack('bronze')}
           onPurchase={() => handlePurchasePack('bronze')}
         />
@@ -164,7 +185,7 @@ export const PacksPage = () => {
           tier="silver"
           count={inventory?.silver || 0}
           canOpen={(inventory?.silver || 0) > 0 && !isOpening}
-          userPoints={userPoints}
+          userCredits={userCredits}
           onOpen={() => handleOpenPack('silver')}
           onPurchase={() => handlePurchasePack('silver')}
         />
@@ -172,7 +193,7 @@ export const PacksPage = () => {
           tier="gold"
           count={inventory?.gold || 0}
           canOpen={(inventory?.gold || 0) > 0 && !isOpening}
-          userPoints={userPoints}
+          userCredits={userCredits}
           onOpen={() => handleOpenPack('gold')}
           onPurchase={() => handlePurchasePack('gold')}
         />
@@ -180,7 +201,7 @@ export const PacksPage = () => {
           tier="ultimate"
           count={inventory?.ultimate || 0}
           canOpen={(inventory?.ultimate || 0) > 0 && !isOpening}
-          userPoints={userPoints}
+          userCredits={userCredits}
           onOpen={() => handleOpenPack('ultimate')}
           onPurchase={() => handlePurchasePack('ultimate')}
         />
@@ -200,7 +221,8 @@ export const PacksPage = () => {
           </h3>
           <ul className="text-text-secondary text-left space-y-2">
             <li>🎁 <strong>Packs gratuits :</strong> 2x par jour (9h et 18h)</li>
-            <li>⭐ <strong>Acheter avec des points :</strong> Bronze (100), Silver (200), Gold (300), Ultimate (500)</li>
+            <li>⭐ <strong>Acheter avec des crédits :</strong> Bronze (100), Silver (200), Gold (300), Ultimate (500)</li>
+            <li>💰 <strong>Crédits :</strong> Gagne 1 crédit par point marqué. Les points restent, les crédits s'utilisent !</li>
             <li>🏆 <strong>Récompenses :</strong> Shots, immunités, pouvoirs spéciaux et plus !</li>
           </ul>
         </div>

frontend/src/types/participant.ts

@@ -10,6 +10,7 @@ export interface Participant {
   avatar_url: string | null;
   is_groom: boolean;
   total_points: number;
+  pack_credits: number;
   current_packs: PackInventory;
   created_at: string;
   updated_at: string;
@@ -28,6 +29,7 @@ export interface ParticipantSummary {
   avatar_url: string | null;
   is_groom: boolean;
   total_points: number;
+  pack_credits: number;
 }
 
 export interface ParticipantWithRank extends ParticipantSummary {