Stage 9: Telegram integration (connector side-service, Mini App, out-of-app push)

New platform/telegram connector (own container, bot token only there):
- go-telegram/bot long-poll loop: /start deep-links + Mini App launch button.
- gRPC API pkg/proto/telegram/v1 (Telegram service): ValidateInitData, Notify
  (renders a localized message + deep-link button), SendToUser/SendToGameChannel
  (admin, wired in Stage 10). Generic methods are platform-agnostic (external_id).
- Bot API base override for Telegram's test environment; Dockerfile + compose
  (VPN sidecar, no public ingress); README.

Gateway:
- initData validation relocated from the gateway into the connector; the gateway
  calls ValidateInitData over gRPC (GATEWAY_CONNECTOR_ADDR), drops the bot token,
  and deletes internal/auth.
- Out-of-app push: runPushPump routes events whose recipient has no live in-app
  stream to connector.Notify, gated by /internal/push-target + the in-app-only
  flag (race-free de-dup); HasSubscribers added to the push hub.

Backend:
- Migration 00007 accounts.notifications_in_app_only (default true) + jetgen.
- ProvisionTelegram seeds a new account's language/display name from the launch
  fields; IdentityExternalID reverse lookup; /internal/push-target handler.

UI:
- Telegram Mini App launch: detect initData, apply themeParams, authTelegram,
  route the deep-link start_param (g/i/f); /telegram/ guard redirects outside
  Telegram. Vite relative base + telegram-web-app.js. In-app-only profile toggle;
  share-to-Telegram link for a friend code. Vitest + Playwright coverage.

Wire/docs/CI: fbs Profile/UpdateProfileRequest gain notifications_in_app_only
(Go + TS); go.work uses ./platform/telegram; go-unit.yaml covers it; PLAN,
ARCHITECTURE, FUNCTIONAL (+ru), UI_DESIGN, READMEs updated.

backend/internal/postgres/jet/backend/model/accounts.go

@@ -13,16 +13,17 @@ import (
 )
 
 type Accounts struct {
-	AccountID           uuid.UUID `sql:"primary_key"`
-	DisplayName         string
-	PreferredLanguage   string
-	TimeZone            string
-	BlockChat           bool
-	BlockFriendRequests bool
-	CreatedAt           time.Time
-	UpdatedAt           time.Time
-	AwayStart           time.Time
-	AwayEnd             time.Time
-	HintBalance         int32
-	IsGuest             bool
+	AccountID              uuid.UUID `sql:"primary_key"`
+	DisplayName            string
+	PreferredLanguage      string
+	TimeZone               string
+	BlockChat              bool
+	BlockFriendRequests    bool
+	CreatedAt              time.Time
+	UpdatedAt              time.Time
+	AwayStart              time.Time
+	AwayEnd                time.Time
+	HintBalance            int32
+	IsGuest                bool
+	NotificationsInAppOnly bool
 }

backend/internal/postgres/jet/backend/table/accounts.go

@@ -17,18 +17,19 @@ type accountsTable struct {
 	postgres.Table
 
 	// Columns
-	AccountID           postgres.ColumnString
-	DisplayName         postgres.ColumnString
-	PreferredLanguage   postgres.ColumnString
-	TimeZone            postgres.ColumnString
-	BlockChat           postgres.ColumnBool
-	BlockFriendRequests postgres.ColumnBool
-	CreatedAt           postgres.ColumnTimestampz
-	UpdatedAt           postgres.ColumnTimestampz
-	AwayStart           postgres.ColumnTime
-	AwayEnd             postgres.ColumnTime
-	HintBalance         postgres.ColumnInteger
-	IsGuest             postgres.ColumnBool
+	AccountID              postgres.ColumnString
+	DisplayName            postgres.ColumnString
+	PreferredLanguage      postgres.ColumnString
+	TimeZone               postgres.ColumnString
+	BlockChat              postgres.ColumnBool
+	BlockFriendRequests    postgres.ColumnBool
+	CreatedAt              postgres.ColumnTimestampz
+	UpdatedAt              postgres.ColumnTimestampz
+	AwayStart              postgres.ColumnTime
+	AwayEnd                postgres.ColumnTime
+	HintBalance            postgres.ColumnInteger
+	IsGuest                postgres.ColumnBool
+	NotificationsInAppOnly postgres.ColumnBool
 
 	AllColumns     postgres.ColumnList
 	MutableColumns postgres.ColumnList
@@ -70,39 +71,41 @@ func newAccountsTable(schemaName, tableName, alias string) *AccountsTable {
 
 func newAccountsTableImpl(schemaName, tableName, alias string) accountsTable {
 	var (
-		AccountIDColumn           = postgres.StringColumn("account_id")
-		DisplayNameColumn         = postgres.StringColumn("display_name")
-		PreferredLanguageColumn   = postgres.StringColumn("preferred_language")
-		TimeZoneColumn            = postgres.StringColumn("time_zone")
-		BlockChatColumn           = postgres.BoolColumn("block_chat")
-		BlockFriendRequestsColumn = postgres.BoolColumn("block_friend_requests")
-		CreatedAtColumn           = postgres.TimestampzColumn("created_at")
-		UpdatedAtColumn           = postgres.TimestampzColumn("updated_at")
-		AwayStartColumn           = postgres.TimeColumn("away_start")
-		AwayEndColumn             = postgres.TimeColumn("away_end")
-		HintBalanceColumn         = postgres.IntegerColumn("hint_balance")
-		IsGuestColumn             = postgres.BoolColumn("is_guest")
-		allColumns                = postgres.ColumnList{AccountIDColumn, DisplayNameColumn, PreferredLanguageColumn, TimeZoneColumn, BlockChatColumn, BlockFriendRequestsColumn, CreatedAtColumn, UpdatedAtColumn, AwayStartColumn, AwayEndColumn, HintBalanceColumn, IsGuestColumn}
-		mutableColumns            = postgres.ColumnList{DisplayNameColumn, PreferredLanguageColumn, TimeZoneColumn, BlockChatColumn, BlockFriendRequestsColumn, CreatedAtColumn, UpdatedAtColumn, AwayStartColumn, AwayEndColumn, HintBalanceColumn, IsGuestColumn}
-		defaultColumns            = postgres.ColumnList{DisplayNameColumn, PreferredLanguageColumn, TimeZoneColumn, BlockChatColumn, BlockFriendRequestsColumn, CreatedAtColumn, UpdatedAtColumn, AwayStartColumn, AwayEndColumn, HintBalanceColumn, IsGuestColumn}
+		AccountIDColumn              = postgres.StringColumn("account_id")
+		DisplayNameColumn            = postgres.StringColumn("display_name")
+		PreferredLanguageColumn      = postgres.StringColumn("preferred_language")
+		TimeZoneColumn               = postgres.StringColumn("time_zone")
+		BlockChatColumn              = postgres.BoolColumn("block_chat")
+		BlockFriendRequestsColumn    = postgres.BoolColumn("block_friend_requests")
+		CreatedAtColumn              = postgres.TimestampzColumn("created_at")
+		UpdatedAtColumn              = postgres.TimestampzColumn("updated_at")
+		AwayStartColumn              = postgres.TimeColumn("away_start")
+		AwayEndColumn                = postgres.TimeColumn("away_end")
+		HintBalanceColumn            = postgres.IntegerColumn("hint_balance")
+		IsGuestColumn                = postgres.BoolColumn("is_guest")
+		NotificationsInAppOnlyColumn = postgres.BoolColumn("notifications_in_app_only")
+		allColumns                   = postgres.ColumnList{AccountIDColumn, DisplayNameColumn, PreferredLanguageColumn, TimeZoneColumn, BlockChatColumn, BlockFriendRequestsColumn, CreatedAtColumn, UpdatedAtColumn, AwayStartColumn, AwayEndColumn, HintBalanceColumn, IsGuestColumn, NotificationsInAppOnlyColumn}
+		mutableColumns               = postgres.ColumnList{DisplayNameColumn, PreferredLanguageColumn, TimeZoneColumn, BlockChatColumn, BlockFriendRequestsColumn, CreatedAtColumn, UpdatedAtColumn, AwayStartColumn, AwayEndColumn, HintBalanceColumn, IsGuestColumn, NotificationsInAppOnlyColumn}
+		defaultColumns               = postgres.ColumnList{DisplayNameColumn, PreferredLanguageColumn, TimeZoneColumn, BlockChatColumn, BlockFriendRequestsColumn, CreatedAtColumn, UpdatedAtColumn, AwayStartColumn, AwayEndColumn, HintBalanceColumn, IsGuestColumn, NotificationsInAppOnlyColumn}
 	)
 
 	return accountsTable{
 		Table: postgres.NewTable(schemaName, tableName, alias, allColumns...),
 
 		//Columns
-		AccountID:           AccountIDColumn,
-		DisplayName:         DisplayNameColumn,
-		PreferredLanguage:   PreferredLanguageColumn,
-		TimeZone:            TimeZoneColumn,
-		BlockChat:           BlockChatColumn,
-		BlockFriendRequests: BlockFriendRequestsColumn,
-		CreatedAt:           CreatedAtColumn,
-		UpdatedAt:           UpdatedAtColumn,
-		AwayStart:           AwayStartColumn,
-		AwayEnd:             AwayEndColumn,
-		HintBalance:         HintBalanceColumn,
-		IsGuest:             IsGuestColumn,
+		AccountID:              AccountIDColumn,
+		DisplayName:            DisplayNameColumn,
+		PreferredLanguage:      PreferredLanguageColumn,
+		TimeZone:               TimeZoneColumn,
+		BlockChat:              BlockChatColumn,
+		BlockFriendRequests:    BlockFriendRequestsColumn,
+		CreatedAt:              CreatedAtColumn,
+		UpdatedAt:              UpdatedAtColumn,
+		AwayStart:              AwayStartColumn,
+		AwayEnd:                AwayEndColumn,
+		HintBalance:            HintBalanceColumn,
+		IsGuest:                IsGuestColumn,
+		NotificationsInAppOnly: NotificationsInAppOnlyColumn,
 
 		AllColumns:     allColumns,
 		MutableColumns: mutableColumns,

backend/internal/postgres/migrations/00007_telegram_notifications.sql

@@ -0,0 +1,17 @@
+-- +goose Up
+-- Stage 9 Telegram integration: a per-account toggle that confines notifications
+-- to the in-app live stream. When notifications_in_app_only is true (the default),
+-- the platform side-service (Telegram) sends no out-of-app push; turning it off
+-- opts into out-of-app push, which the gateway delivers only while the account has
+-- no live in-app stream, so the in-app and platform channels never duplicate. Adds
+-- a column, so the generated jet code is regenerated (cmd/jetgen).
+SET search_path = backend, pg_catalog;
+
+ALTER TABLE accounts
+    ADD COLUMN notifications_in_app_only boolean NOT NULL DEFAULT true;
+
+-- +goose Down
+SET search_path = backend, pg_catalog;
+
+ALTER TABLE accounts
+    DROP COLUMN notifications_in_app_only;