gogo-telefon/docs/HARDWARE_TESTING.md

M5 — Live hardware test plan (joint session with the founder)

Everything below is already written and unit-tested against mocks; this runbook verifies it against real hardware: GSM gateway + SIM + operator forwarding. Estimated time: 2–3 hours with hardware on site.

0. Shopping/prep checklist (founder)

• GSM gateway, GoIP/Yeastar class, with SIP registration and an HTTP SMS API (§17.3). 4/8 ports depending on pilot count.
• 1 SIM card per pilot salon (verify operator terms for gateway use, §17.4).
• Salon's own number reachable for forwarding tests.
• Server reachable from the gateway (LAN or VPN), ports 5060/UDP + RTP range.

1. Gateway → Asterisk registration

1. In the super-admin panel → Brojevi/SIM: add the SIM's number, set its gateway port (line) and operator; assign it to the pilot salon.
2. Regenerate Asterisk config and reload:

   python -m gogo.telephony.asterisk --out ./asterisk/conf \
       --backend http://<backend>:8000 --voice <voice-host>:9092
   docker compose --profile voice restart asterisk
   

   The config now contains a [gw-line-<port>] endpoint. The SIP password is deterministic; print it with:

   python -c "from gogo.telephony.asterisk import gateway_line_password as p; print(p('<msisdn>'))"
   

3. On the gateway, configure line : SIP server = Asterisk host, username gw-line-<port>, the password from above, register.
4. Verify: asterisk -rx 'pjsip show endpoints' → gw-line-<port> Avail.

2. Inbound call path (§5.1)

• Call the SIM's number directly from a mobile → gateway → Asterisk → ring group rings → no answer → agent answers. Full conversation books a request; check dashboard (Zahtjevi, Pozivi + audio), email, metering.
• Answer on a worker softphone → outcome javilo se osoblje, no minutes.
• Hang up while ringing → missed-call SMS arrives on the caller's phone.

3. Outbound SMS via gateway HTTP API (§5.5)

1. Set in .env: GOGO_SMS_PROVIDER=gsm_gateway, GOGO_GSM_GATEWAY_URL=http://<gateway-ip>, GOGO_GSM_GATEWAY_USER/PASSWORD.
2. Restart backend; from a request in the dashboard press Potvrdi + SMS.

• Confirmation SMS arrives on the client phone, sms_log.status = sent.
• Unplug the gateway → send again → sms_log.status = failed with error, request flow otherwise unaffected (SMS failure never blocks §9).
• If the gateway is not GoIP-compatible, adapt _build_request / _check_response in gogo/sms/gateway.py (isolated on purpose).

4. Operator conditional forwarding (§5.1, §17.4)

On the salon's own phone, per operator (codes shown in dashboard → Telefonija):

• m:tel: activate no-answer forwarding (**61*<gogo-number>**<sec>#), call the salon number from a third phone, don't answer → call arrives on SIM.
• Repeat for busy (**67*...) and unreachable (**62*...).
• ##002# deactivates everything; *#61# shows status.
• Verify the same set on BH Telecom and HT Eronet SIMs; note any operator quirks in gogo/telephony/forwarding.py (per-operator function exists).

5. End-to-end acceptance (Definition of Done §16 + GSM leg)

• Client calls salon number → no answer → forwarded → agent conversation → proposal email/partner push → owner clicks Riješeno → done, no SMS.
• Second run: owner clicks Potvrdi termin N + SMS → client receives SMS via the salon's own SIM.
• Out-of-hours call → agent answers immediately with the closed-greeting.

6. Rollback

Forwarding off: ##002# on the salon phone. Gateway line disable: super-admin → Brojevi/SIM → status blocked + config regen. The salon's own number keeps working untouched throughout — Gogo only ever received forwarded calls.