M1: backend core + proposal engine

- FastAPI skeleton, SQLAlchemy models (§13), Alembic initial migration
- SchedulingProvider interface with google_calendar (free/busy read-only),
  partner_api (Appendix B client) and mock implementations
- Proposal engine: create → provider-routed delivery → owner actions
  (resolve/confirm+SMS/reject) → expiry + reminders (§9)
- Signed single-use action links, .ics METHOD:REQUEST attachment
- Partner outcome webhook with HMAC verification + polling fallback
- SmsProvider (console) with Bosnian templates (§5.5), EmailProvider (console/SMTP)
- Fake partner API server in tests/ — Appendix B reference implementation
- 43 tests: slot math, proposal lifecycle, action links, partner contract

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

README.md

@@ -0,0 +1,55 @@
+# Gogo Telefon
+
+Voice-first AI receptionist for small service businesses in Bosnia and Herzegovina.
+The agent answers forwarded calls (and web chat), speaks Bosnian, checks real
+availability and sends **booking proposals** to the salon owner — it never books
+appointments itself. See `docs/` and the product spec for details.
+
+## Architecture (short version)
+
+```
+caller → salon number (conditional forwarding) → GSM gateway → Asterisk
+       → ring group (staff softphones) → no answer → voice agent (Pipecat)
+       → tools HTTP → FastAPI backend → SchedulingProvider (Google Calendar | Partner API)
+       → proposal email / partner push → owner action → (optional) SMS to client
+```
+
+Everything self-hosted except LLM + TTS APIs (swappable interfaces).
+
+## Development
+
+```bash
+uv venv && uv pip install -e '.[dev]'
+docker compose up -d db        # Postgres 16 on localhost:5433 (or use your own)
+export GOGO_DATABASE_URL=postgresql+psycopg://gogo:gogo@localhost:5432/gogo
+.venv/bin/alembic upgrade head
+.venv/bin/uvicorn gogo.main:app --reload
+```
+
+Run tests (SQLite, no services needed):
+
+```bash
+.venv/bin/python -m pytest
+```
+
+The fake partner booking API used in tests (`tests/fake_partner.py`) doubles as
+the **reference implementation of Appendix B** for partner IT teams:
+
+```bash
+.venv/bin/uvicorn tests.fake_partner:app --port 9100
+```
+
+## Layout
+
+| Path | What |
+|---|---|
+| `gogo/scheduling/` | `SchedulingProvider` interface + `google_calendar`, `partner_api`, `mock` |
+| `gogo/proposals/` | proposal engine, action tokens, owner emails, .ics |
+| `gogo/sms/` | `SmsProvider` (console now, GSM gateway in M5) + Bosnian templates |
+| `gogo/api/` | action links, partner webhook, health |
+| `gogo/agent/` | LLM agent: prompt composition, tools, conversation loop (M2) |
+| `gogo/voice/` | Pipecat voice pipeline (M4) |
+| `gogo/telephony/` | Asterisk/GSM/forwarding codes (M4/M5) |
+| `tests/fake_partner.py` | Appendix B reference implementation |
+
+All code/comments in English; all client- and owner-facing text in Bosnian (Latin).