GTS WebChat docsby GTS Team

WebChat › Docs › Source of truth

Source of truth

Source: docs/source-of-truth.md · AI DEV

This file is the only canonical WebChat deploy/link reference.

Canonical local source:

/home/avikad/dev/py/WebChat/docs/source-of-truth.md

Canonical public page:

/docs/source-of-truth.html

The domain can change later. Treat public URLs as PUBLIC_BASE + path, where PUBLIC_BASE is the current deployment domain.

Official public base:

https://gts-team.dev

Official pChat/WebChat app:

https://gts-team.dev/app/webchat/chat.html

Official public relay API base:

https://gts-team.dev

The browser app should use the same origin as its default public relay. Local checkout/dev pages keep using http://127.0.0.1:5110.

Public users should not need relay settings. The default connection flow is: open the official app, enter email, verify the email code, then use the same origin public relay automatically.

Current Public Paths

  • Landing page: /webchat.html
  • Current WebChat app: /app/webchat/chat.html
  • Docs index: /docs/index.html
  • Source of truth: /docs/source-of-truth.html
  • AI session guide: /docs/ai-session-quickstart.html
  • API docs: /docs/api-for-ai-and-devs.html
  • Undeployed Features & Roadmap: /docs/missing-features.html
  • Public relay API: /api/v1/...

Current Local Source Locations

  • WebChat source repo: /home/avikad/dev/py/WebChat
  • WebChat GUI source: /home/avikad/dev/py/WebChat/web/app/webchat/chat.html
  • WebChat docs source: /home/avikad/dev/py/WebChat/docs/
  • Landing/deploy repo: /home/avikad/dev/py/gts-team-landing
  • Landing page source: /home/avikad/dev/py/gts-team-landing/webchat.html
  • Landing CSS: /home/avikad/dev/py/gts-team-landing/gts-team.css
  • Rendered public docs output: /home/avikad/dev/py/gts-team-landing/docs/
  • Docs renderer: /home/avikad/dev/py/gts-team-landing/render_docs.py
  • Deploy script: /home/avikad/dev/py/gts-team-landing/push_webchat.sh
  • Internal WebChat links should be relative paths, not hard-coded domains.
  • App links must use /app/webchat/chat.html.
  • Docs links must use /docs/... or page-relative docs links.
  • The public app should call the relay on the same origin with /api/v1/....
  • Self-host/private relay links should point to /docs/private-relay.html or /docs/private-server-install.html.
  • Missing-features page should be labeled Undeployed Features & Roadmap.

Do not add new WebChat links to these retired locations:

  • https://phonerelay.dev/app/chat.html
  • /app/chat.html
  • pchat.html
  • webchat.gts-team.dev

Historical mentions are allowed only inside this source-of-truth page or in explicit migration notes.

Deploy

Preferred deploy command:

cd /home/avikad/dev/py/gts-team-landing
./push_webchat.sh

For a future domain change, set:

GTS_PUBLIC_BASE=https://new-domain.example ./push_webchat.sh

The script syncs the WebChat app into the landing tree, renders docs, deploys the landing/app/docs/relay source, restarts the public backend processes, and verifies the public app plus /api/v1/pchat/auth/request-code.

rg -n "phonerelay\\.dev/app/chat\\.html|/app/chat\\.html|pchat\\.html|webchat\\.gts-team\\.dev" \
  /home/avikad/dev/py/WebChat \
  /home/avikad/dev/py/gts-team-landing

Any match outside this file should be removed, replaced with the current relative path, or documented as an intentional non-WebChat product link.