1

STRESS_TEST_README.md

@@ -0,0 +1,80 @@
+# Local Register Stress Test (3 minutes)
+
+This setup only targets localhost (`127.0.0.1`), for your own backend verification.
+
+## 1. Install dependency
+
+```powershell
+python -m pip install -U locust
+```
+
+## 2. Default target and route
+
+Current script defaults:
+- host: `http://127.0.0.1`
+- register route: `/api/user/register`
+
+If your local backend uses different host/port:
+
+```powershell
+$env:TARGET_HOST="http://127.0.0.1:8080"
+```
+
+If route differs:
+
+```powershell
+$env:REGISTER_PATH="/api/user/register"
+```
+
+## 3. Run large-scale register test (3 minutes)
+
+```powershell
+locust -f locustfile.py --headless --users 300 --spawn-rate 60 --run-time 3m --csv register_stress_report
+```
+#########################
+python -m locust -f locustfile.py --headless --users 300 --spawn-rate 60 --run-time 3m --csv register_stress_report
+
+
+Notes:
+- `--users 300`: concurrent virtual users.
+- `--spawn-rate 60`: user ramp-up per second.
+- `--run-time 3m`: test duration.
+
+## 4. Payload fields (adjust only when needed)
+
+By default each request sends unique username + password:
+
+```json
+{
+  "username": "load_user_...",
+  "password": "123456",
+  "confirmPassword": "123456"
+}
+```
+
+If your API field names are different, set env vars:
+
+```powershell
+$env:USERNAME_FIELD="userName"
+$env:PASSWORD_FIELD="passwd"
+$env:CONFIRM_PASSWORD_FIELD="confirmPwd"
+```
+
+Optional extra fields:
+
+```powershell
+$env:INCLUDE_EMAIL="1"
+$env:INCLUDE_NICKNAME="1"
+```
+
+## 5. Result files and metrics
+
+After run:
+- `register_stress_report_stats.csv`
+- `register_stress_report_failures.csv`
+- `register_stress_report_exceptions.csv`
+
+Focus on:
+- requests/s
+- p95 and p99 latency
+- failure ratio