# Simulator Guideline (2024-09-09)
## 0. Updated histories
- 2024/06/26
- Race 4 of S1 and S2 always has 28 horses.
- Race 5 of S1 and S2 always has 35 horses.
- 2024/09/09
- **New simulator approach**: Change from **Auto loop** to **Manual control**
- Update JRA race *(3rd Niigata 7th)* *(3rd Niigata 8th)* & NAR race *(Obihiro)*
- Update Horse incidents Index
## 1. INTRO SIMULATOR
### *1.1 HORSE RACING INTRO*
#### 1.1.1 REGIONS & RACECOURSES
- Hong Kong (HK):
+ Bet type: Win, Place, QUIN, QPL
+ Local: Happy Valley
+ Oversea: S1 (GB) & S2 (KOR)
- Japan (JP):
+ Bet type: Win, Place
+ JRA: Simulation Niigata
+ NAR: Obihiro
- Australia (AUS):
+ Bet type: Win, Place
+ Simulation BEX
#### 1.1.2 RACES
- Each racecourse includes **6 races**
- **Race 1** always have horses with incidents
- **HongKong** **Race 6** (*has 6 horses*) (**no QPL bet, no Paytable)**
#### 1.1.3 HORSES
- The number of horses will range from 6 to 35 horses/race
- Race with < 9 horses doesn't have horses'incident.
- The **horse number 1** of a race **always take place 1** in every race.
| Region | Venue | Max horses | Horse incident |
| ------ | ------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| HK | Happy Valley | 14 | Horse no. 2 will scratched with the type **WV-A** (refund).<p>Horse no. 3 will scratched with the type **DISQ** (no refund) |
| HK | S1 | 35 | Horse no.2 will scratched **b4 race** (refund). <p>Horse no.3 will scratched **after race** (no refund)<p>(*)The last horse in the race will be the **reserved** horse |
| HK | S2 | 35 | <p>Horse no.3 will scratched **after race** (no refund)<p>(*)The last horse in the race will be the **reserved** horse |
| JP | 03_NIIGATA_07 | 18 | Horse no.2 will scratched **S** (refund). <p>Horse no.3 will scratched with the type **ER** (Excluded from running) (no refund)<p> |
| JP | Obihiro | 12 | Horse no.2 will scratched with type **Cancel** (refund). <p>Horse no.3 will scratched with type **Exclusion** (no refund)<p> |
(*)The horse will be disabled from the start and cannot place bets on it.
### *1.2 METHOD*
#### 1.2.1 BY URL
```Test``` test-simulate.weh88.com
> **Note**: To avoid disruption, please make sure there's only **ONE** person takes control while you are testing
#### 1.2.3 BY WEBSOCKET

### *1.3 FEATURES*

- **(1) START**: test **single** or **multiple** racecourses by clicking **START**.
- HK Racecourses duration: 1hr 20mins/racecourse
- JP Racecourse duration: 1hr24mins/racecourse (**R1** has 6mins **Waiting for odd** - this to test Admin **Edit race function**)
When R6 is ended, the racecourse is over, you need to **CLEAN DATA** to restart that racecourse
> **Note**: You can't stop the racecourse once it starts.
- **DASHBOARD STATUS**
| HH:MM | Admin Status | Client Stage |
|:-----:| ---------------------------- | -------------------------------------------------------------------------------------------- |
| - | All races finished (default) |No races |
|00:00 |Waiting for odds | Information about races and horses is displayed but there are no odds, so can not place bet. |
| 00:02| Waiting for bet | Odds information is updated for all races. Place bets can be made. |
| 00:05 | Race {no} odds has changed | The odds have changed |
| 00:10 | Race {no} started | Race {no} started. This race is blocked, can not place bet |
| 00:12 | Race {no} finished | Race {no} getting result |
| 00:15 |Waiting for odds |[Next race] Odds information is updated for all races. Place bets can be made
- **(2) CLEAN DATA**:(wait 2-3s) this to clear all current racecourses data
> **Note**:
- Data can't be recovered once it's clean.
- **All racecourses (HK, JP) data** will be deleted even though the races are not finished.
## 2. INDEX
### Hong Kong
- Local racecourse **ONLY has scratched horses**, and specific incidents are releasesd after races
- Overseas racecourses **have scratched horses** & **reserved horses**.
The type of scratched horse cannot be determined according to CODE as local racecourses (DISQ, WV, WX etc...), it can only be known whether the bet will be refunded or not.
### Japan, Australia, UK
[Incident list](https://docs.google.com/spreadsheets/d/1oD2p9LppqQja9q-wK5wn9mHCuws_BOBfQbs24SOh3n4/edit?gid=0#gid=0)
