docs: enrich docs/specs and remove placeholders
**Motivations:** - Make docs/specs implementation-ready without empty sections or placeholders. **Root causes:** - Multiple specs still contained non-actionable placeholders (N/A, “see above”, "..."), and inconsistent “no cache” wording. **Correctifs:** - Replace placeholders with explicit tables, structures, and typed examples. - Align “no cache / no memorization” statements where relevant. **Evolutions:** - Add a features doc entry to track the documentation enrichment effort. **Pages affectées:** - docs/specs/* - docs/features/docs-specs-enrichment.md - docs/leo.md - docs/plan-enrich-docs-specs.md
This commit is contained in:
@@ -62,7 +62,7 @@ function finalizeAuction(auction):
|
||||
| :--- | :--- | :--- |
|
||||
| `BID_PLACED` | Info | "Offre placée avec succès." |
|
||||
| `OUTBID` | Alerte | "Vous avez été surenchéri !" |
|
||||
| `AUCTION_WON` | Succès | "Vous avez remporté l'enchère ! Livraison en cours..." |
|
||||
| `AUCTION_WON` | Succès | "Vous avez remporté l'enchère ! Livraison en cours." |
|
||||
|
||||
# Annexes UX/UI
|
||||
|
||||
@@ -85,11 +85,11 @@ function finalizeAuction(auction):
|
||||
**Événements** : `HOVER_OFFER`.
|
||||
|
||||
#### Assets
|
||||
- **Musiques** : N/A
|
||||
- **Musiques** : `ui_market_hover.mp3` (jingle discret optionnel).
|
||||
- **Sons** : `hover_soft.mp3`.
|
||||
- **Graphiques** : Cadre Offre (Doré si rare).
|
||||
- **Images** : Icône Animal.
|
||||
- **Vidéos** : N/A
|
||||
- **Vidéos** : `offer_hover_glow.webm` (0.6s loop, optionnel).
|
||||
- **Animations** : Prix qui clignote si nouvelle enchère.
|
||||
- **Couleurs** : Vert (Abordable), Rouge (Trop cher).
|
||||
- **Textes** : "Lapin Rare - 500$".
|
||||
@@ -104,15 +104,15 @@ function finalizeAuction(auction):
|
||||
**Événements** : `PLACE_BID`.
|
||||
|
||||
#### Assets
|
||||
- **Musiques** : N/A
|
||||
- **Musiques** : `ui_market_bid.mp3` (jingle court).
|
||||
- **Sons** : `bid_placed.mp3` (bruit de marteau).
|
||||
- **Graphiques** : Icône Marteau.
|
||||
- **Images** : Portrait Animal HD.
|
||||
- **Vidéos** : N/A
|
||||
- **Vidéos** : `bid_counter_up.webm` (0.8s loop, optionnel).
|
||||
- **Animations** : Compteur prix qui monte.
|
||||
- **Couleurs** : Bouton Vert.
|
||||
- **Textes** : "Enchérir".
|
||||
- **Formes** : N/A
|
||||
- **Formes** : Boutons rapides (+10/+50/+100), champ numérique.
|
||||
|
||||
### Sablier de Validation (Attente)
|
||||
**Description UX** : L'enchère est remportée, le transfert est en cours (10 min).
|
||||
@@ -120,19 +120,19 @@ function finalizeAuction(auction):
|
||||
**Notification Push** : "Enchère remportée ! Animal livré." à la fin du timer.
|
||||
**Emplacement** : Carte Monde & HUD.
|
||||
**Intégration** : Statut "En cours".
|
||||
**Navigation** : N/A
|
||||
**Navigation** : Clic sur sablier dans HUD → ouvre le détail transaction (temps restant, statut, destination).
|
||||
**Événements** : `TIMER_START`.
|
||||
|
||||
#### Assets
|
||||
- **Musiques** : N/A
|
||||
- **Musiques** : `ui_timer_soft.mp3` (optionnel, très discret).
|
||||
- **Sons** : `tick_tock.mp3` (ambiance très discrète si focus).
|
||||
- **Graphiques** : Sablier animé.
|
||||
- **Images** : N/A
|
||||
- **Vidéos** : N/A
|
||||
- **Images** : `icon_hourglass.png`, `badge_pending.png`.
|
||||
- **Vidéos** : `hourglass_flow.webm` (1s loop, optionnel).
|
||||
- **Animations** : Sable qui coule.
|
||||
- **Couleurs** : Orange.
|
||||
- **Textes** : "Validation : MM:SS".
|
||||
- **Formes** : N/A
|
||||
- **Formes** : Badge rond (HUD), icône sur slot.
|
||||
|
||||
### Activité "Clic" (Gameplay)
|
||||
**Description UX** : Pendant les 10 min, le joueur peut cliquer sur le sablier pour "accélérer" (symboliquement) ou gagner un petit bonus (XP/Pièce) pour patienter.
|
||||
@@ -143,12 +143,12 @@ function finalizeAuction(auction):
|
||||
**Événements** : `CLICK_HOURGLASS`.
|
||||
|
||||
#### Assets
|
||||
- **Musiques** : N/A
|
||||
- **Musiques** : `ui_click_reward.mp3` (jingle court).
|
||||
- **Sons** : `sand_shake.mp3`. **Design ASMR** : Bruit de sable qui crisse ou petit choc mat.
|
||||
- **Graphiques** : Particules de sable.
|
||||
- **Images** : N/A
|
||||
- **Vidéos** : N/A
|
||||
- **Images** : `sand_particle.png`.
|
||||
- **Vidéos** : `hourglass_shake.webm` (0.5s non loop, optionnel).
|
||||
- **Animations** : Secousse.
|
||||
- **Couleurs** : Doré.
|
||||
- **Textes** : "+1 XP".
|
||||
- **Formes** : N/A
|
||||
- **Formes** : Bouton rond (tap cible), badge sablier (HUD).
|
||||
|
||||
Reference in New Issue
Block a user