# VEGA77 CS Agent — Client documentation

This folder is the **system and operations documentation pack** served at **`https://docs.ikon168.com`**: production domains, architecture summary, channels, Telegram escalations, integration/go-live, DNS, deployment runbook, specs/register, end-to-end flow, and operational controls.

Developer-only material (automated tests, manual QA checklists, demo scripts) lives in the **source repository** under **`docs/operations/`**, not here.

For deeper architecture in the delivered tree, see **`docs/architecture/`**. A short summary is [SYSTEM-ARCHITECTURE.md](SYSTEM-ARCHITECTURE.md).

---

## Production domain

| | |
|---|---|
| **DNS** | Namecheap — `ikon168.com` |
| **CS Agent (HTTPS)** | `https://agent.ikon168.com` (also `https://ikon168.com`) |
| **Client docs (HTTPS)** | `https://docs.ikon168.com` — this pack (`index.html` + markdown) |
| **Customer portal** | `https://portal.ikon168.com` — static IKON168 portal with LiveChat widget |

Details: [00-Production-Domain-ikon168.md](00-Production-Domain-ikon168.md).

---

## Reading order

| # | Document | Contents |
|---|----------|----------|
| 0 | [00-Production-Domain-ikon168.md](00-Production-Domain-ikon168.md) | Hostnames for `ikon168.com`, DNS summary |
| 1 | [01-Introduction.md](01-Introduction.md) | Purpose, capabilities, languages, agent areas |
| 2 | [02-Channels-and-How-Customers-Use-It.md](02-Channels-and-How-Customers-Use-It.md) | LiveChat vs web demo |
| 3 | [03-Your-Team-Escalations-and-Telegram.md](03-Your-Team-Escalations-and-Telegram.md) | Telegram alerts, LiveChat handover |
| 4 | [04-Integration-and-Go-Live-Checklist.md](04-Integration-and-Go-Live-Checklist.md) | Prerequisites, configuration, HTTPS |
| 6 | [06-Operational-Controls.md](06-Operational-Controls.md) | Kill switch, monitoring, access control |
| 7 | [07-DNS-and-Domain-Namecheap.md](07-DNS-and-Domain-Namecheap.md) | DNS procedure, nameservers vs A records |
| 8 | [08-DNS-Values-and-Security.md](08-DNS-Values-and-Security.md) | Hostnames, record table, firewall, secrets |
| 9 | [09-Specs-Services-Links-Credentials.md](09-Specs-Services-Links-Credentials.md) | Register of services, links, env keys, secure credential handling |
| 10 | [10-End-to-End-Flow-and-Integration.md](10-End-to-End-Flow-and-Integration.md) | Customer → AI → Telegram → CS → LiveChat, BO usage |
| — | [PRODUCTION-READINESS.md](PRODUCTION-READINESS.md) | Production go-live checklist |
| — | [GCP-DEPLOY-RUNBOOK.md](GCP-DEPLOY-RUNBOOK.md) | GCP VM, Caddy, HTTPS deploy |
| — | [SYSTEM-ARCHITECTURE.md](SYSTEM-ARCHITECTURE.md) | Summary; full detail in repo `docs/architecture/` |

---

## Summary

The **VEGA77 CS Agent** answers routine questions using a knowledge-backed AI; escalations go to **Telegram** for staff awareness, and humans continue with customers in **LiveChat** (not via ordinary Telegram chat — use the controlled `/reply` command when enabled).