HADOS Technical Architecture: Stack, Data, and Auth

interface HabboUser {
  id: string;           // Firestore document ID (= Auth UID for self-registered users)
  username: string;     // Habbo Hotel in-game username
  email: string;        // Email address (dummy suffix for manually-created players)
  points: number;       // Current tournament score (floating-point supported)
  previousRank: number; // Rank before the last score update
  currentRank: number;  // Rank after the last score update
  avatarUrl: string;    // Full habbo.es imaging API URL
  createdAt: string;    // ISO 8601 timestamp
  role: 'global_admin' | 'dado_admin' | 'intermediario' | 'jugador';
  dadoId?: string;      // ID of the Dado this player belongs to (absent for global_admin)
}

interface Dado {
  id: string;
  name: string;              // Display name of the Dado (e.g. "Dado VIP")
  code?: string;             // Optional join code (reserved for future use)
  adminId?: string;          // Auth UID of the assigned dado_admin
  adminEmail?: string;       // Email of the assigned dado_admin
  adminName?: string;        // Habbo username of the assigned dado_admin
  createdAt: string;         // ISO 8601 creation timestamp
  startDate?: string;        // Tournament start date (YYYY-MM-DD)
  endDate?: string;          // Tournament end date (YYYY-MM-DD)
  rules?: string[];          // Array of rule strings (one per line)
  schedule?: string[];       // Array of schedule strings (one per line)
  totalPrize?: string;       // Prize pool description (e.g. "3000 USDT")
  qualifyingCount?: number;  // Number of players that qualify for finals
}

const qUsers = query(
  collection(db, 'users'),
  where('dadoId', '==', targetDadoId)
);

const unsubUsers = onSnapshot(qUsers, (snapshot) => {
  const list: HabboUser[] = [];
  snapshot.forEach((docSnap) => {
    list.push({ id: docSnap.id, ...docSnap.data() } as HabboUser);
  });
  list.sort((a, b) => b.points - a.points);
  setUsers(list);
});

const updateRanksAndSave = async (updatedUsers: HabboUser[]) => {
  const sorted = [...updatedUsers].sort((a, b) => b.points - a.points);
  const batch = writeBatch(db);

  sorted.forEach((user, index) => {
    const newRank = index + 1;
    const userRef = doc(db, 'users', user.id);
    batch.update(userRef, {
      points: user.points,
      previousRank: user.currentRank || user.previousRank,
      currentRank: newRank
    });
  });

  await batch.commit();
};

onAuthStateChanged(auth, async (user) => {
  setCurrentUser(user);
  if (user) {
    // Attach a real-time listener to the user's Firestore profile document
    const userProfileRef = doc(db, 'users', user.uid);
    onSnapshot(userProfileRef, async (docSnap) => {
      if (docSnap.exists()) {
        setUserProfile({ ...docSnap.data() as HabboUser, id: docSnap.id });
      } else {
        // Auto-create a recovery profile if the Firestore doc is missing
        await setDoc(userProfileRef, recoveryProfileData);
      }
      setAuthLoading(false);
    });
  } else {
    setUserProfile(null);
    setAuthLoading(false);
  }
});

https://www.habbo.es/habbo-imaging/avatarimage?user={username}&direction=3&head_direction=3&gesture=std&size=m

https://www.habbo.es/habbo-imaging/avatarimage?user={username}&direction=3&head_direction=3&gesture=std&size=m&headonly=1