chore: establish project baseline

agent/.env.example

@@ -0,0 +1,41 @@
+# One of these per Agent installation (one per client machine). Copy to
+# agent/.env on that machine; never commit it. Get AGENT_ID/AGENT_TOKEN/
+# COMPANY_ID from central/scripts/register_agent.py, run once per installation.
+
+GTI_HUB_URL=https://hub.example.com
+AGENT_ID=
+AGENT_TOKEN=
+COMPANY_ID=
+COMPANY_UF=
+
+# The client's Firebird ERP database.
+FIREBIRD_DATABASE_PATH=
+FB_USER=
+FB_PASSWORD=
+FIREBIRD_CLIENT_LIBRARY=
+
+# Default MUST be 0. Writes only ever happen against exactly the database
+# named by AUTHORIZED_WRITE_DATABASE_PATH below (never inferred from
+# FIREBIRD_DATABASE_PATH alone, never from the ".FDB" extension).
+FIREBIRD_WRITES=0
+
+# Required to enable writes for THIS installation. Must be set to the exact
+# same absolute path as FIREBIRD_DATABASE_PATH above — this is the operator's
+# explicit, per-installation authorization. Leaving it unset means
+# FIREBIRD_WRITES=1 has no effect against a real client database (it falls
+# back to the developer-only disposable test database path and therefore
+# fails closed for anything else).
+AUTHORIZED_WRITE_DATABASE_PATH=
+
+# Required to enable writes for THIS installation. Must equal the schema
+# fingerprint this installation was verified/registered against; if the live
+# schema fingerprint (reported in heartbeats) ever differs, writes are
+# refused until an operator re-verifies and updates this value.
+EXPECTED_SCHEMA_FINGERPRINT=
+
+POLL_INTERVAL_SECONDS=10
+AGENT_VERSION=0.1.0
+
+# Optional overrides:
+# AGENT_STATE_DB=C:\GTI\Agent\agent_state.sqlite
+# AGENT_LOG_PATH=C:\GTI\Agent\logs\agent.log