feat(ads): server-driven ad-banner backend, wire & admin console (PR1)

Turn the gated-off mock banner into a real advertising subsystem (backend +
admin half; the UI rotation lands in PR2).

- internal/ads: campaigns (percent weight + validity window; a perpetual,
  undeletable default that fills the remainder up to 100%), 1..N bilingual
  messages (en+ru), global display timings; ActiveSet computes the
  window-filtered, default-remainder, GCD-reduced, language-resolved rotation
  feed. Smooth-weighted-round-robin math is unit-tested.
- migration 00006 (+ jetgen): ad_campaigns / ad_messages / ad_settings, seeded
  default campaign + house message + default timings.
- eligibility = !paid_account && hint_balance==0 && !no_banner role (new role;
  guests qualify). The resolved feed rides the profile.get response (no new RPC,
  works for guests, nothing distinct to filter); language by service_language.
- live update: a notify `banner` sub-kind (re-poll signal) published when an
  operator grants hints or grants/revokes no_banner, so the client shows/hides
  in place.
- admin console /_gm/banners (+ /_gm/banner-settings): campaign + message CRUD
  with reorder, default protection, clamped timings.
- wire: fbs BannerInfo/BannerCampaign on Profile; gateway transcode forwards it.
- docs: ARCHITECTURE §10, FUNCTIONAL (+ _ru), backend README, PRERELEASE tracker
  (incl. the deferred app.load aggregator note).

ui/src/gen/fbs/scrabblefb.ts

@@ -3,6 +3,8 @@
 export { AccountRef } from './scrabblefb/account-ref.js';
 export { Ack } from './scrabblefb/ack.js';
 export { AlphabetEntry } from './scrabblefb/alphabet-entry.js';
+export { BannerCampaign } from './scrabblefb/banner-campaign.js';
+export { BannerInfo } from './scrabblefb/banner-info.js';
 export { BlockList } from './scrabblefb/block-list.js';
 export { BlockStatus } from './scrabblefb/block-status.js';
 export { ChatList } from './scrabblefb/chat-list.js';

ui/src/gen/fbs/scrabblefb/banner-campaign.ts

@@ -0,0 +1,75 @@
+// automatically generated by the FlatBuffers compiler, do not modify
+
+import * as flatbuffers from 'flatbuffers';
+
+export class BannerCampaign {
+  bb: flatbuffers.ByteBuffer|null = null;
+  bb_pos = 0;
+  __init(i:number, bb:flatbuffers.ByteBuffer):BannerCampaign {
+  this.bb_pos = i;
+  this.bb = bb;
+  return this;
+}
+
+static getRootAsBannerCampaign(bb:flatbuffers.ByteBuffer, obj?:BannerCampaign):BannerCampaign {
+  return (obj || new BannerCampaign()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+}
+
+static getSizePrefixedRootAsBannerCampaign(bb:flatbuffers.ByteBuffer, obj?:BannerCampaign):BannerCampaign {
+  bb.setPosition(bb.position() + flatbuffers.SIZE_PREFIX_LENGTH);
+  return (obj || new BannerCampaign()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+}
+
+weight():number {
+  const offset = this.bb!.__offset(this.bb_pos, 4);
+  return offset ? this.bb!.readInt32(this.bb_pos + offset) : 0;
+}
+
+messages(index: number):string
+messages(index: number,optionalEncoding:flatbuffers.Encoding):string|Uint8Array
+messages(index: number,optionalEncoding?:any):string|Uint8Array|null {
+  const offset = this.bb!.__offset(this.bb_pos, 6);
+  return offset ? this.bb!.__string(this.bb!.__vector(this.bb_pos + offset) + index * 4, optionalEncoding) : null;
+}
+
+messagesLength():number {
+  const offset = this.bb!.__offset(this.bb_pos, 6);
+  return offset ? this.bb!.__vector_len(this.bb_pos + offset) : 0;
+}
+
+static startBannerCampaign(builder:flatbuffers.Builder) {
+  builder.startObject(2);
+}
+
+static addWeight(builder:flatbuffers.Builder, weight:number) {
+  builder.addFieldInt32(0, weight, 0);
+}
+
+static addMessages(builder:flatbuffers.Builder, messagesOffset:flatbuffers.Offset) {
+  builder.addFieldOffset(1, messagesOffset, 0);
+}
+
+static createMessagesVector(builder:flatbuffers.Builder, data:flatbuffers.Offset[]):flatbuffers.Offset {
+  builder.startVector(4, data.length, 4);
+  for (let i = data.length - 1; i >= 0; i--) {
+    builder.addOffset(data[i]!);
+  }
+  return builder.endVector();
+}
+
+static startMessagesVector(builder:flatbuffers.Builder, numElems:number) {
+  builder.startVector(4, numElems, 4);
+}
+
+static endBannerCampaign(builder:flatbuffers.Builder):flatbuffers.Offset {
+  const offset = builder.endObject();
+  return offset;
+}
+
+static createBannerCampaign(builder:flatbuffers.Builder, weight:number, messagesOffset:flatbuffers.Offset):flatbuffers.Offset {
+  BannerCampaign.startBannerCampaign(builder);
+  BannerCampaign.addWeight(builder, weight);
+  BannerCampaign.addMessages(builder, messagesOffset);
+  return BannerCampaign.endBannerCampaign(builder);
+}
+}

ui/src/gen/fbs/scrabblefb/banner-info.ts

@@ -0,0 +1,126 @@
+// automatically generated by the FlatBuffers compiler, do not modify
+
+import * as flatbuffers from 'flatbuffers';
+
+import { BannerCampaign } from '../scrabblefb/banner-campaign.js';
+
+
+export class BannerInfo {
+  bb: flatbuffers.ByteBuffer|null = null;
+  bb_pos = 0;
+  __init(i:number, bb:flatbuffers.ByteBuffer):BannerInfo {
+  this.bb_pos = i;
+  this.bb = bb;
+  return this;
+}
+
+static getRootAsBannerInfo(bb:flatbuffers.ByteBuffer, obj?:BannerInfo):BannerInfo {
+  return (obj || new BannerInfo()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+}
+
+static getSizePrefixedRootAsBannerInfo(bb:flatbuffers.ByteBuffer, obj?:BannerInfo):BannerInfo {
+  bb.setPosition(bb.position() + flatbuffers.SIZE_PREFIX_LENGTH);
+  return (obj || new BannerInfo()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+}
+
+campaigns(index: number, obj?:BannerCampaign):BannerCampaign|null {
+  const offset = this.bb!.__offset(this.bb_pos, 4);
+  return offset ? (obj || new BannerCampaign()).__init(this.bb!.__indirect(this.bb!.__vector(this.bb_pos + offset) + index * 4), this.bb!) : null;
+}
+
+campaignsLength():number {
+  const offset = this.bb!.__offset(this.bb_pos, 4);
+  return offset ? this.bb!.__vector_len(this.bb_pos + offset) : 0;
+}
+
+holdMs():number {
+  const offset = this.bb!.__offset(this.bb_pos, 6);
+  return offset ? this.bb!.readInt32(this.bb_pos + offset) : 0;
+}
+
+edgePauseMs():number {
+  const offset = this.bb!.__offset(this.bb_pos, 8);
+  return offset ? this.bb!.readInt32(this.bb_pos + offset) : 0;
+}
+
+scrollPxPerSec():number {
+  const offset = this.bb!.__offset(this.bb_pos, 10);
+  return offset ? this.bb!.readInt32(this.bb_pos + offset) : 0;
+}
+
+fadeOutMs():number {
+  const offset = this.bb!.__offset(this.bb_pos, 12);
+  return offset ? this.bb!.readInt32(this.bb_pos + offset) : 0;
+}
+
+gapMs():number {
+  const offset = this.bb!.__offset(this.bb_pos, 14);
+  return offset ? this.bb!.readInt32(this.bb_pos + offset) : 0;
+}
+
+fadeInMs():number {
+  const offset = this.bb!.__offset(this.bb_pos, 16);
+  return offset ? this.bb!.readInt32(this.bb_pos + offset) : 0;
+}
+
+static startBannerInfo(builder:flatbuffers.Builder) {
+  builder.startObject(7);
+}
+
+static addCampaigns(builder:flatbuffers.Builder, campaignsOffset:flatbuffers.Offset) {
+  builder.addFieldOffset(0, campaignsOffset, 0);
+}
+
+static createCampaignsVector(builder:flatbuffers.Builder, data:flatbuffers.Offset[]):flatbuffers.Offset {
+  builder.startVector(4, data.length, 4);
+  for (let i = data.length - 1; i >= 0; i--) {
+    builder.addOffset(data[i]!);
+  }
+  return builder.endVector();
+}
+
+static startCampaignsVector(builder:flatbuffers.Builder, numElems:number) {
+  builder.startVector(4, numElems, 4);
+}
+
+static addHoldMs(builder:flatbuffers.Builder, holdMs:number) {
+  builder.addFieldInt32(1, holdMs, 0);
+}
+
+static addEdgePauseMs(builder:flatbuffers.Builder, edgePauseMs:number) {
+  builder.addFieldInt32(2, edgePauseMs, 0);
+}
+
+static addScrollPxPerSec(builder:flatbuffers.Builder, scrollPxPerSec:number) {
+  builder.addFieldInt32(3, scrollPxPerSec, 0);
+}
+
+static addFadeOutMs(builder:flatbuffers.Builder, fadeOutMs:number) {
+  builder.addFieldInt32(4, fadeOutMs, 0);
+}
+
+static addGapMs(builder:flatbuffers.Builder, gapMs:number) {
+  builder.addFieldInt32(5, gapMs, 0);
+}
+
+static addFadeInMs(builder:flatbuffers.Builder, fadeInMs:number) {
+  builder.addFieldInt32(6, fadeInMs, 0);
+}
+
+static endBannerInfo(builder:flatbuffers.Builder):flatbuffers.Offset {
+  const offset = builder.endObject();
+  return offset;
+}
+
+static createBannerInfo(builder:flatbuffers.Builder, campaignsOffset:flatbuffers.Offset, holdMs:number, edgePauseMs:number, scrollPxPerSec:number, fadeOutMs:number, gapMs:number, fadeInMs:number):flatbuffers.Offset {
+  BannerInfo.startBannerInfo(builder);
+  BannerInfo.addCampaigns(builder, campaignsOffset);
+  BannerInfo.addHoldMs(builder, holdMs);
+  BannerInfo.addEdgePauseMs(builder, edgePauseMs);
+  BannerInfo.addScrollPxPerSec(builder, scrollPxPerSec);
+  BannerInfo.addFadeOutMs(builder, fadeOutMs);
+  BannerInfo.addGapMs(builder, gapMs);
+  BannerInfo.addFadeInMs(builder, fadeInMs);
+  return BannerInfo.endBannerInfo(builder);
+}
+}

ui/src/gen/fbs/scrabblefb/profile.ts

@@ -2,6 +2,9 @@
 
 import * as flatbuffers from 'flatbuffers';
 
+import { BannerInfo } from '../scrabblefb/banner-info.js';
+
+
 export class Profile {
   bb: flatbuffers.ByteBuffer|null = null;
   bb_pos = 0;
@@ -87,8 +90,13 @@ notificationsInAppOnly():boolean {
   return offset ? !!this.bb!.readInt8(this.bb_pos + offset) : true;
 }
 
+banner(obj?:BannerInfo):BannerInfo|null {
+  const offset = this.bb!.__offset(this.bb_pos, 26);
+  return offset ? (obj || new BannerInfo()).__init(this.bb!.__indirect(this.bb_pos + offset), this.bb!) : null;
+}
+
 static startProfile(builder:flatbuffers.Builder) {
-  builder.startObject(11);
+  builder.startObject(12);
 }
 
 static addUserId(builder:flatbuffers.Builder, userIdOffset:flatbuffers.Offset) {
@@ -135,24 +143,13 @@ static addNotificationsInAppOnly(builder:flatbuffers.Builder, notificationsInApp
   builder.addFieldInt8(10, +notificationsInAppOnly, +true);
 }
 
+static addBanner(builder:flatbuffers.Builder, bannerOffset:flatbuffers.Offset) {
+  builder.addFieldOffset(11, bannerOffset, 0);
+}
+
 static endProfile(builder:flatbuffers.Builder):flatbuffers.Offset {
   const offset = builder.endObject();
   return offset;
 }
 
-static createProfile(builder:flatbuffers.Builder, userIdOffset:flatbuffers.Offset, displayNameOffset:flatbuffers.Offset, preferredLanguageOffset:flatbuffers.Offset, timeZoneOffset:flatbuffers.Offset, hintBalance:number, blockChat:boolean, blockFriendRequests:boolean, isGuest:boolean, awayStartOffset:flatbuffers.Offset, awayEndOffset:flatbuffers.Offset, notificationsInAppOnly:boolean):flatbuffers.Offset {
-  Profile.startProfile(builder);
-  Profile.addUserId(builder, userIdOffset);
-  Profile.addDisplayName(builder, displayNameOffset);
-  Profile.addPreferredLanguage(builder, preferredLanguageOffset);
-  Profile.addTimeZone(builder, timeZoneOffset);
-  Profile.addHintBalance(builder, hintBalance);
-  Profile.addBlockChat(builder, blockChat);
-  Profile.addBlockFriendRequests(builder, blockFriendRequests);
-  Profile.addIsGuest(builder, isGuest);
-  Profile.addAwayStart(builder, awayStartOffset);
-  Profile.addAwayEnd(builder, awayEndOffset);
-  Profile.addNotificationsInAppOnly(builder, notificationsInAppOnly);
-  return Profile.endProfile(builder);
-}
 }