58 lines
2.0 KiB
Plaintext
58 lines
2.0 KiB
Plaintext
ARRR GST Operator Agent 1.6.0
|
|
================================
|
|
|
|
Primary deployment: self-installing Windows EXE.
|
|
|
|
The Windows setup EXE is built from gst_operator_agent.py using:
|
|
|
|
powershell -ExecutionPolicy Bypass -File .\build_gst_operator_agent_exe.ps1
|
|
|
|
Generated file:
|
|
|
|
dist\ARRR_GST_Operator_Agent_Setup_1.6.0.exe
|
|
|
|
Operator workstation installation
|
|
---------------------------------
|
|
1. Download ARRR_GST_Operator_Agent_Setup_1.6.0.exe from ARRR ERP.
|
|
2. Double-click the EXE.
|
|
3. The EXE copies itself to:
|
|
|
|
%LOCALAPPDATA%\ARRR\GSTOperatorAgent\ARRR_GST_Operator_Agent.exe
|
|
|
|
4. It writes config.json for https://office.arrrassociates.com.
|
|
5. It registers the current-user Windows protocol:
|
|
|
|
arrrgst://
|
|
|
|
6. It creates a normal Windows Installed Apps uninstall registration.
|
|
7. Return to GST Return Reconciliation and start the GST download.
|
|
|
|
No administrator rights are required.
|
|
Python is not required on operator workstations.
|
|
No localhost web server or trusted local certificate is used.
|
|
|
|
Runtime flow
|
|
------------
|
|
ARRR ERP issues a short-lived signed GST operator token.
|
|
Windows opens arrrgst://start?token=...
|
|
The installed EXE redeems the token over HTTPS.
|
|
GST Portal username/password are retrieved from ERP Credential Vault only after token redemption.
|
|
The visible Chrome/Edge GST browser is opened by the operator agent.
|
|
The operator completes CAPTCHA/OTP.
|
|
The agent downloads the selected GST return JSON/ZIP files and uploads the verified package back to ARRR ERP for client storage.
|
|
|
|
Source/repair fallback
|
|
----------------------
|
|
The ERP still exposes a source ZIP for development/repair. The legacy PowerShell source installer remains supported and preserves the previous behavior, but the EXE is the normal workstation installation method from version 1.6.0 onward.
|
|
|
|
Commands
|
|
--------
|
|
Self-test:
|
|
ARRR_GST_Operator_Agent.exe --self-test
|
|
|
|
Repair/install explicitly:
|
|
ARRR_GST_Operator_Agent.exe --install --erp-base-url https://office.arrrassociates.com
|
|
|
|
Uninstall:
|
|
ARRR_GST_Operator_Agent.exe --uninstall
|