xync-db 0.5.5.dev31__tar.gz → 0.5.5.dev64__tar.gz

{xync_db-0.5.5.dev31 → xync_db-0.5.5.dev64}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: xync-db
-Version: 0.5.5.dev31
+Version: 0.5.5.dev64
 Summary: Xync DB schema: Tortoise ORM models, enums, pydantic DTOs.
 Author-email: Mike Artemiev <mixartemev@gmail.com>
 License: LicenseRef-EULA

{xync_db-0.5.5.dev31 → xync_db-0.5.5.dev64}/src/xync_db/enums.py

@@ -176,12 +176,9 @@ class AgentStatus(IntEnum):
 
 
 class SynonymType(IntEnum):
-    name = 1
     ppo = 2
-    from_party = 3
-    to_party = 4
-    slip_req = 5
-    slip_send = 6
+    from_party = 3  # с чьего лица платит покупатель: sell — какое мейкер требует, buy — с какого шлёт сам
+    slip = 5  # sell-объява: какой чек мейкер требует, buy: какой шлёт (бывш. slip_req/slip_send)
     abuser = 7
     scale = 8
     slavic = 9
@@ -203,15 +200,14 @@ class Boundary(IntEnum):
 
 
 class SbpStrict(IntEnum):
-    no = 0
     sbp = 1
     card = 2
 
 
-class Party(IntEnum):
+class FromParty(IntEnum):
     fst = 0
     fam = 1
-    lk = 2  # lk-photo/video/comment
+    lk = 2
     trd = 3
 
 
@@ -222,17 +218,35 @@ class Slip(IntEnum):
     pdf_mail = 3
 
 
-class NameType(IntEnum):
-    no_slavic = 0
-    slavic = 1
-    fake = 2
-
-
 class AbuserType(IntEnum):
-    no = 0
     rating = 1  # рейтинг: жмет "Оплачено" сразу, "Отмена" по апелляции
     fake = 2  # реклама
     cash = 3  # типа кэш обменник, но хз
+    long = 4  # ждать дольше 15 мин (оплату/отпуск)
+    add_vrf = 5  # сверх чека — видео из лк/выписка и т.п.
+    fee = 6  # доплата/комиссия сверх суммы ордера
+    rate = 7  # цена объявления не совпадает с реальным (сделка будет по другому курсу)
+
+
+class CredType(
+    IntEnum
+):  # требование к реквизитам (искл: foreign — предупреждение мейкера-продавца о своей зарубежной карте)
+    no_llc = 1  # не ИП/юрлицо: «с ип не работаю»
+    rus_num = 2  # только российские, обычно номер телефона: «только на номера рф»
+    foreign = 3  # продавец просит платёж на зарубежную (не российскую) карту/номер: «перевод на зарубежную карту»
+
+
+class GeminiModel(IntEnum):  # модель Gemini (`GeminiReq`); имя в API, порядок силы и квоты — `cond_ai.MODELS`
+    lite_3_5 = 5
+    lite_3_1 = 6
+
+
+class GeminiRes(IntEnum):  # исход запроса к Gemini (`GeminiReq`)
+    ok = 0
+    minute = 1  # прочие 429 (…PerMinute…, отказ без квоты): ключ на минуту мимо этой модели
+    day = 2  # 429 …PerDay…: ключ выбыл по этой модели до сброса квоты (`GeminiKey.pick`)
+    bad_key = 4  # 401/403/API_KEY_INVALID: ключ выбыл по всем моделям на сутки
+    fail = 5  # прочие сбои (таймаут; 5xx — перегружена модель: условие — к следующей)
 
 
 class ExStatus(IntEnum):

{xync_db-0.5.5.dev31 → xync_db-0.5.5.dev64}/src/xync_db/migrations/CLAUDE.md

@@ -93,7 +93,7 @@ Loads PM logo files from `seed/xync_files.sql` if < 100 files exist. These are T
 ## models/0004_all_seed.py — Full Seed
 
 Orchestrates the seed scripts in order:
-1. `a_actor_seed` — Exchanges, currencies (56 base), coins, XyncPay PM, origin user (id=0)
+1. `a_actor_seed` — Exchanges, currencies (56 base), coins, XyncPay PM, e-wallets yoomoney/cupis/pyypl/alipay (Bank + Pm typ=emoney + RUB pmcur), origin user (id=0)
 2. `a_tg_seed` — Telegram DCs, app config, PM name mappings (`pm_rep`)
 3. `a_country_seed` — **all** countries + their currencies from the bundled `seed/countries.json`
    (generated from mledoze/countries), single source, BEFORE the exchange seeders. Sets `ccn3`

{xync_db-0.5.5.dev31 → xync_db-0.5.5.dev64}/src/xync_db/migrations/models/0001_initial.py

@@ -10,7 +10,7 @@ from tortoise.fields.db_defaults import Now
 from tortoise.migrations import operations as ops
 from tortoise.migrations.constraints import CheckConstraint
 from x_auth.enums import Lang, PeerType, Role
-from x_model.field import DatetimeSecField, UInt1Field, UInt2Field, UInt4Field, UInt8Field, UniqBinaryField
+from x_model.field import DatetimeSecField, UInt1Field, UInt2Field, UInt4Field, UInt8Field, UInt16Field, UniqBinaryField
 
 from xync_db.enums import (
     AbuserType,
@@ -19,14 +19,17 @@ from xync_db.enums import (
     AgentStatus,
     Boundary,
     CoinType,
+    CredType,
     DepType,
     ExAction,
     ExStatus,
     ExType,
     FileType,
+    FromParty,
+    GeminiModel,
+    GeminiRes,
     HotStatus,
     OrderStatus,
-    Party,
     PersonStatus,
     PmType,
     SbpStrict,
@@ -70,12 +73,97 @@ class Migration(migrations.Migration):
                 ("id", fields.IntField(generated=True, primary_key=True, unique=True, db_index=True)),
                 ("created_at", DatetimeSecField(db_default=Now(), auto_now=False, auto_now_add=True)),
                 ("updated_at", DatetimeSecField(db_default=Now(), auto_now=True, auto_now_add=False)),
-                ("raw_txt", fields.CharField(unique=True, max_length=4095)),
+                ("raw_txt", fields.CharField(db_index=True, max_length=4095)),
                 ("last_ver", fields.CharField(null=True, max_length=4095)),
             ],
             options={"table": "cond", "app": "models", "pk_attr": "id"},
             bases=["Model", "TsTrait"],
         ),
+        ops.CreateModel(
+            name="CondPrompt",
+            fields=[
+                ("id", fields.IntField(generated=True, primary_key=True, unique=True, db_index=True)),
+                ("txt", fields.TextField(unique=False)),
+                ("is_jev", fields.BooleanField(db_default=False)),
+                (
+                    "cond",
+                    fields.ForeignKeyField(
+                        "models.Cond",
+                        source_field="cond_id",
+                        null=True,
+                        db_constraint=True,
+                        to_field="id",
+                        related_name="prompts",
+                        on_delete=OnDelete.SET_NULL,
+                    ),
+                ),
+                ("remark", fields.TextField(null=True, unique=False)),
+                ("note", fields.TextField(null=True, unique=False)),
+                ("created_at", DatetimeSecField(db_default=Now(), auto_now=False, auto_now_add=True)),
+            ],
+            options={
+                "table": "cond_prompt",
+                "app": "models",
+                "pk_attr": "id",
+                "table_description": "Версия промпта разбора условий (`xync_service.common.cond_ai`): системного промпта Gemini или вопросов JEV",
+            },
+            bases=["Model"],
+        ),
+        ops.CreateModel(
+            name="GeminiKey",
+            fields=[
+                ("id", fields.IntField(generated=True, primary_key=True, unique=True, db_index=True)),
+                ("key", fields.CharField(unique=True, max_length=63)),
+            ],
+            options={
+                "table": "gemini_key",
+                "app": "models",
+                "pk_attr": "id",
+                "table_description": "Ключ Gemini API free tier (разбор условий, `xync_service.common.cond_ai`). Квота своя на каждую модель, расход и",
+            },
+            bases=["Model"],
+        ),
+        ops.CreateModel(
+            name="GeminiReq",
+            fields=[
+                ("id", fields.IntField(generated=True, primary_key=True, unique=True, db_index=True)),
+                (
+                    "key",
+                    fields.ForeignKeyField(
+                        "models.GeminiKey",
+                        source_field="key_id",
+                        db_constraint=True,
+                        to_field="id",
+                        related_name="reqs",
+                        on_delete=OnDelete.CASCADE,
+                    ),
+                ),
+                (
+                    "model",
+                    fields.IntEnumField(
+                        description="lite_3_5: 5\nlite_3_1: 6",
+                        enum_type=GeminiModel,
+                        generated=False,
+                    ),
+                ),
+                (
+                    "res",
+                    fields.IntEnumField(
+                        description="ok: 0\nminute: 1\nday: 2\nbad_key: 4\nfail: 5",
+                        enum_type=GeminiRes,
+                        generated=False,
+                    ),
+                ),
+                ("created_at", DatetimeSecField(db_default=Now(), auto_now=False, auto_now_add=True)),
+            ],
+            options={
+                "table": "gemini_req",
+                "app": "models",
+                "pk_attr": "id",
+                "table_description": "Запрос к Gemini (`cond_ai._generate`) — история за сутки (старше удаляет `CondAi` на входе): по ней",
+            },
+            bases=["Model"],
+        ),
         ops.CreateModel(
             name="CondSim",
             fields=[
@@ -621,27 +709,21 @@ class Migration(migrations.Migration):
                         on_delete=OnDelete.CASCADE,
                     ),
                 ),
-                (
-                    "to_party",
-                    fields.IntEnumField(
-                        null=True, description="fst: 0\nfam: 1\nlk: 2\ntrd: 3", enum_type=Party, generated=False
-                    ),
-                ),
                 (
                     "from_party",
                     fields.IntEnumField(
-                        null=True, description="fst: 0\nfam: 1\nlk: 2\ntrd: 3", enum_type=Party, generated=False
+                        null=True, description="fst: 0\nfam: 1\nlk: 2\ntrd: 3", enum_type=FromParty, generated=False
                     ),
                 ),
-                ("ppo", UInt1Field(null=True)),
                 (
-                    "slip_req",
+                    "to_party",
                     fields.IntEnumField(
-                        null=True, description="no: 0\nscreen: 1\npdf: 2\npdf_mail: 3", enum_type=Slip, generated=False
+                        null=True, description="fst: 0\nfam: 1\nlk: 2\ntrd: 3", enum_type=FromParty, generated=False
                     ),
                 ),
+                ("ppo", UInt1Field(null=True)),
                 (
-                    "slip_send",
+                    "slip",
                     fields.IntEnumField(
                         null=True, description="no: 0\nscreen: 1\npdf: 2\npdf_mail: 3", enum_type=Slip, generated=False
                     ),
@@ -649,27 +731,28 @@ class Migration(migrations.Migration):
                 (
                     "abuser",
                     fields.IntEnumField(
-                        description="no: 0\nrating: 1\nfake: 2\ncash: 3",
-                        db_default=AbuserType.no,
+                        null=True,
+                        description="rating: 1\nfake: 2\ncash: 3\nlong: 4\nadd_vrf: 5\nfee: 6\nrate: 7",
                         enum_type=AbuserType,
                         generated=False,
                     ),
                 ),
                 ("slavic", fields.BooleanField(null=True)),
+                (
+                    "cred",
+                    fields.IntEnumField(
+                        null=True, description="no_llc: 1\nrus_num: 2\nforeign: 3", enum_type=CredType, generated=False
+                    ),
+                ),
                 ("mtl_like", fields.BooleanField(null=True)),
                 ("scale", fields.SmallIntField(null=True)),
                 ("bank_side", fields.BooleanField(null=True)),
                 (
                     "sbp_strict",
-                    fields.IntEnumField(
-                        description="no: 0\nsbp: 1\ncard: 2",
-                        db_default=SbpStrict.no,
-                        enum_type=SbpStrict,
-                        generated=False,
-                    ),
+                    fields.IntEnumField(null=True, description="sbp: 1\ncard: 2", enum_type=SbpStrict, generated=False),
                 ),
                 ("contact", fields.CharField(null=True, max_length=127)),
-                ("done", fields.BooleanField(db_index=True, db_default=False)),
+                ("is_intermediary", fields.BooleanField(null=True)),
                 (
                     "banks",
                     fields.ManyToManyField(
@@ -930,7 +1013,7 @@ class Migration(migrations.Migration):
                     "typ",
                     fields.IntEnumField(
                         db_index=True,
-                        description="name: 1\nppo: 2\nfrom_party: 3\nto_party: 4\nslip_req: 5\nslip_send: 6\nabuser: 7\nscale: 8\nslavic: 9\nmtl_like: 10\nbank: 11\nbank_side: 12\nsbp_strict: 13\ncontact: 14",
+                        description="ppo: 2\nfrom_party: 3\nslip: 5\nabuser: 7\nscale: 8\nslavic: 9\nmtl_like: 10\nbank: 11\nbank_side: 12\nsbp_strict: 13\ncontact: 14",
                         enum_type=SynonymType,
                         generated=False,
                     ),
@@ -1361,7 +1444,7 @@ class Migration(migrations.Migration):
             name="Actor",
             fields=[
                 ("id", fields.IntField(generated=True, primary_key=True, unique=True, db_index=True)),
-                ("exid", UInt8Field()),
+                ("exid", UInt16Field()),
                 ("name", fields.CharField(max_length=63)),
                 (
                     "ex",
@@ -1379,6 +1462,7 @@ class Migration(migrations.Migration):
                     fields.ForeignKeyField(
                         "models.Person",
                         source_field="person_id",
+                        null=True,
                         db_constraint=True,
                         to_field="id",
                         related_name="actors",

{xync_db-0.5.5.dev31 → xync_db-0.5.5.dev64}/src/xync_db/migrations/models/0002_triggers.py

@@ -18,20 +18,15 @@ Channels emitted:
     w3addr_wanted / w3addr_filled -- web3 address handshake (0009)
 
 Guards (RAISE, без NOTIFY): tx_before (баланс/иммутабельность/монотонность), tx_no_delete,
-ad_exid_ex_uniq (0008, exid уникален per-exchange). Utility: _user_balance(uid, cid), _tx_pack(...).
-
-`actor_new` trigger: link the auto-created anonymous person + stamp its `note` (D-035).
-
-The BEFORE-INSERT `actor_new()` created an anonymous person for a person-less actor but never wrote
-`NEW.person_id` back, so such an actor would land with `person_id = NULL` — a latent bug on the
-taker/raw-insert path (dormant today because every `Actor.create` site passes a person). We:
-
-  (a) assign the freshly created person back to the actor (`NEW.person_id := p_id`), and
-  (b) stamp `note = "{ex_id}:{exid}"` — the per-actor identity key that `Ex.person_save` and
-      `Agent.upsert` resolve bootstrap persons by, and that `0010_person_note_unique` makes UNIQUE.
-
-The `status = -1` (USER_DEF) branch is unchanged: an agent person pre-created by `Agent.upsert`
-triggers the `actor_person_needs_def_user` NOTIFY so an admin is asked whose agent it is.
+ad_exid_ex_uniq (0008, exid уникален per-exchange), ad_cond_side_uniq/cond_txt_side_uniq (unique
+(cond.raw_txt, ad.pair_side.is_sell)). GC: ad_cond_gc/cond_new_gc — условие без объяв удаляется (cond_gc).
+Utility: _user_balance(uid, cid), _tx_pack(...).
+
+`actor_new` trigger: only the `status = -1` (USER_DEF) branch — an agent person pre-created by
+`Agent.upsert` triggers the `actor_person_needs_def_user` NOTIFY so an admin is asked whose agent it is.
+Persons of actors are created ONLY in Python (`Ex.person_save` / `Agent.upsert`, which stamp
+`note = "{ex_id}:{exid}"`, D-035); the former auto-person branch was a duplicate path (every
+`Actor.create` site passes a person). A person-less actor is a maker masked by the exchange (D-042).
 """
 
 from typing import ClassVar
@@ -43,17 +38,12 @@ from tortoise.migrations.operations import RunSQL
 TRIGGERS_SQL = """
 -- before new Actor
 CREATE OR REPLACE FUNCTION actor_new() returns trigger as $actor_new_trg$
-DECLARE
-    p_id INT;
 BEGIN
-    -- actor без person_id (зашли тейкером либо парсим объявы) → создаём анонимную персону,
-    -- клеймим её note = "{ex_id}:{exid}" (ключ актора, D-035) и ПРИВЯЗЫВАЕМ её к актору.
-    IF NEW.person_id IS NULL THEN
-        INSERT INTO person (status, note) VALUES (0, NEW.ex_id || ':' || NEW.exid) RETURNING id INTO p_id;
-        NEW.person_id := p_id;
+    -- персону актору заводит ТОЛЬКО Python (Ex.person_save / Agent.upsert, note = "{ex_id}:{exid}", D-035);
+    -- актор без person_id — замаскированный биржей мейкер (D-042), персону ему не выдумываем.
     -- агентской персоне уже проставлен status=-1 (USER_DEF) в Agent.upsert → зовём админа
     -- определить юзера (actor_person_needs_def_user).
-    ELSIF (SELECT status FROM person WHERE id = NEW.person_id) = -1 THEN
+    IF (SELECT status FROM person WHERE id = NEW.person_id) = -1 THEN
         PERFORM pg_notify('actor_person_needs_def_user', row_to_json(NEW)::varchar);
     END IF;
     RETURN NEW;
@@ -369,6 +359,98 @@ $ad_exid_ex_uniq_trg$ LANGUAGE plpgsql;
 CREATE OR REPLACE TRIGGER ad_exid_ex_uniq BEFORE INSERT OR UPDATE ON "ad" FOR EACH ROW EXECUTE FUNCTION ad_exid_ex_uniq();
 """
 
+# Cond: unique (raw_txt, ads.pair_side.is_sell) — разбор условия (from_party/to_party) зависит от стороны объяв, поэтому
+# тот же текст у buy и sell объяв — два условия, а у условия объявы только одной стороны. Tortoise uniq через join не
+# выразит → BEFORE-RAISE на записи объявы (cond_id/сторона) и на смене текста условия (кодом не меняется: сменился
+# текст объявы — она к условию нового текста, `Cond.side_get`; гард — от ручного SQL). Одновременные
+# записи одного текста идут по очереди (advisory-lock на текст до конца транзакции): иначе обе проверки прошли бы.
+COND_SIDE_UNIQ_SQL = """
+CREATE OR REPLACE FUNCTION ad_cond_side_uniq() returns trigger as $ad_cond_side_uniq_trg$
+DECLARE
+    txt VARCHAR;
+    side BOOL;
+    conflict_cond INT;
+    conflict_ad INT;
+BEGIN
+    IF NEW.cond_id IS NULL THEN
+        RETURN NEW;
+    END IF;
+    SELECT raw_txt INTO txt FROM cond WHERE id = NEW.cond_id;
+    PERFORM pg_advisory_xact_lock(hashtext(txt));
+    SELECT is_sell INTO side FROM pair_side WHERE id = NEW.pair_side_id;
+    -- конфликт: объявы этой стороны — при другом условии этого текста, либо объявы другой стороны — при этом
+    SELECT a.cond_id, a.id INTO conflict_cond, conflict_ad
+    FROM ad a JOIN pair_side ps ON ps.id = a.pair_side_id JOIN cond c ON c.id = a.cond_id
+    WHERE c.raw_txt = txt AND a.id != NEW.id
+      AND ((ps.is_sell = side AND a.cond_id != NEW.cond_id) OR (ps.is_sell != side AND a.cond_id = NEW.cond_id))
+    LIMIT 1;
+    IF conflict_ad IS NOT NULL THEN
+        RAISE EXCEPTION 'ad#% (is_sell=%) -> cond#%: (cond.raw_txt, ad.pair_side.is_sell) must be unique, conflicts with ad#% of cond#%',
+            NEW.id, side, NEW.cond_id, conflict_ad, conflict_cond;
+    END IF;
+    RETURN NEW;
+END
+$ad_cond_side_uniq_trg$ LANGUAGE plpgsql;
+CREATE OR REPLACE TRIGGER ad_cond_side_uniq BEFORE INSERT OR UPDATE OF cond_id, pair_side_id ON "ad"
+    FOR EACH ROW EXECUTE FUNCTION ad_cond_side_uniq();
+
+CREATE OR REPLACE FUNCTION cond_txt_side_uniq() returns trigger as $cond_txt_side_uniq_trg$
+DECLARE
+    conflict_cond INT;
+BEGIN
+    PERFORM pg_advisory_xact_lock(hashtext(NEW.raw_txt));
+    -- конфликт: другое условие нового текста, чьи объявы той же стороны, что и объявы этого
+    SELECT o.cond_id INTO conflict_cond
+    FROM ad o JOIN pair_side ops ON ops.id = o.pair_side_id JOIN cond c ON c.id = o.cond_id
+    WHERE c.raw_txt = NEW.raw_txt AND c.id != NEW.id AND ops.is_sell IN (
+        SELECT ps.is_sell FROM ad a JOIN pair_side ps ON ps.id = a.pair_side_id WHERE a.cond_id = NEW.id
+    )
+    LIMIT 1;
+    IF conflict_cond IS NOT NULL THEN
+        RAISE EXCEPTION 'cond#% raw_txt: (cond.raw_txt, ad.pair_side.is_sell) must be unique, conflicts with cond#%',
+            NEW.id, conflict_cond;
+    END IF;
+    RETURN NEW;
+END
+$cond_txt_side_uniq_trg$ LANGUAGE plpgsql;
+CREATE OR REPLACE TRIGGER cond_txt_side_uniq BEFORE UPDATE OF raw_txt ON "cond"
+    FOR EACH ROW EXECUTE FUNCTION cond_txt_side_uniq();
+"""
+
+# Cond живёт, пока у него есть объявы. Осиротело (объява перецеплена на другое условие — мейкер сменил текст, — или
+# удалена) — удаляем сразу; новое (`Cond.side_get`), к которому до конца ЕГО транзакции не прицепилась объява, —
+# на коммите (DEFERRED): поэтому условие создаётся только в одной транзакции с записью объявы. Тот же advisory-lock на
+# текст, что у ad_cond_side_uniq: иначе параллельная запись объявы в это условие прошла бы мимо NOT EXISTS, а удаление
+# условия унесло бы её каскадом (ad.cond_id ON DELETE CASCADE).
+COND_GC_SQL = """
+CREATE OR REPLACE FUNCTION cond_gc() returns trigger as $cond_gc_trg$
+DECLARE
+    cid INT;
+    txt VARCHAR;
+BEGIN
+    IF TG_TABLE_NAME = 'cond' THEN
+        cid := NEW.id;
+    ELSIF TG_OP = 'DELETE' OR OLD.cond_id IS DISTINCT FROM NEW.cond_id THEN
+        cid := OLD.cond_id;
+    ELSE
+        RETURN NULL;
+    END IF;
+    SELECT raw_txt INTO txt FROM cond WHERE id = cid;
+    IF txt IS NULL THEN
+        RETURN NULL;
+    END IF;
+    PERFORM pg_advisory_xact_lock(hashtext(txt));
+    DELETE FROM cond c WHERE c.id = cid AND NOT EXISTS (SELECT 1 FROM ad a WHERE a.cond_id = cid);
+    RETURN NULL;
+END
+$cond_gc_trg$ LANGUAGE plpgsql;
+CREATE OR REPLACE TRIGGER ad_cond_gc AFTER UPDATE OF cond_id OR DELETE ON "ad"
+    FOR EACH ROW WHEN (OLD.cond_id IS NOT NULL) EXECUTE FUNCTION cond_gc();
+DROP TRIGGER IF EXISTS cond_new_gc ON "cond";  -- CONSTRAINT TRIGGER не поддерживает OR REPLACE
+CREATE CONSTRAINT TRIGGER cond_new_gc AFTER INSERT ON "cond" DEFERRABLE INITIALLY DEFERRED
+    FOR EACH ROW EXECUTE FUNCTION cond_gc();
+"""
+
 # web3-хендшейк адресов (0009): net_addr_ins (вставка пустого val → зовём получателя завести адрес,
 # канал `w3addr_wanted`) и net_addr_upd (val NULL→real → сообщаем отправителям pending-W3Send, канал
 # `w3addr_filled`). (`ALTER net_addr.val DROP NOT NULL` уехал в 0001 — теперь val создаётся nullable.)
@@ -411,5 +493,7 @@ class Migration(BaseMigration):
         RunSQL(CREDEX_ORPHAN_SQL),
         RunSQL(AGENT_AUTH_SQL),
         RunSQL(AD_EXID_EX_UNIQ_SQL),
+        RunSQL(COND_SIDE_UNIQ_SQL),
+        RunSQL(COND_GC_SQL),
         RunSQL(NET_ADDR_TRIGGERS_SQL),
     ]

{xync_db-0.5.5.dev31 → xync_db-0.5.5.dev64}/src/xync_db/migrations/models/0003_seed.py

@@ -6,7 +6,7 @@
 
 Порядок (зависимости):
   1. files       — PM-логотипы из `seed/xync_files.sql` (если файлов < 100)
-  2. a_actor_seed — биржи, 56 базовых валют, монеты, XyncPay PM, origin user (id=0)
+  2. a_actor_seed — биржи, 56 базовых валют, монеты, XyncPay PM, эл. кошельки ЮMoney/ЦУПИС/Pyypl/Alipay (Bank+Pm+RUB), origin user
   3. a_tg_seed    — Telegram DC/App, нормализация имён PM (`pm_rep`)
   4. a_country_seed — ВСЕ страны + их валюты из mledoze (`seed/countries.json`), ДО биржевых
   5. a_bin_seed    — BIN-диапазоны + банки из binlist/data (`seed/ranges.csv`), ПОСЛЕ стран (линк по alpha-2)

{xync_db-0.5.5.dev31 → xync_db-0.5.5.dev64}/src/xync_db/migrations/models/seed/a_actor_seed.py

@@ -2,7 +2,7 @@ from tortoise import BaseDBAsyncClient
 from x_auth.models import Username
 
 from xync_db.enums import ExAction, ExStatus, ExType, PmType, UserStatus
-from xync_db.models import Coin, CoinEx, Cur, CurEx, Ex, ExStat, Pm, User
+from xync_db.models import Bank, Coin, CoinEx, Cur, CurEx, Ex, ExStat, Pm, PmCur, User
 
 
 async def actor_seed(db: BaseDBAsyncClient) -> str:
@@ -284,6 +284,18 @@ async def actor_seed(db: BaseDBAsyncClient) -> str:
 
     xyncpay, _ = await Pm.update_or_create(dict(ok=True, qr=True, fee=0, typ=PmType.emoney), id=0, norm="xyncpay")
 
+    # эл. кошельки: в p2p-условиях RUB их называют наравне с банками → свой Bank (Pm с банком попадает в список
+    # банков разбора условий, `CondAi._pms`) + PmCur RUB; ЦУПИС биржи не отдают — Pm заводим сами. Pyypl/Alipay
+    # не рублёвые — df_cur им не ставим (Alipay — CNY в `refine_pms`)
+    rub = await Cur.get(ticker="RUB")
+    wallets = ("yoomoney", None, rub), ("cupis", "цупис", rub), ("pyypl", None, None), ("alipay", None, None)
+    for norm, alias, df_cur in wallets:
+        bank, _ = await Bank.get_or_create(name=norm)
+        pm, _ = await Pm.update_or_create(
+            dict(typ=PmType.emoney, bank=bank, df_cur=df_cur, alias=alias), norm=norm, country_id=None
+        )
+        await PmCur.get_or_create(pm=pm, cur=rub)
+
     # origin user
     id0, _ = await Username.get_or_create({"phone": 852_6_497_5811}, id=7807393311, username="XyncPay")
     try:

{xync_db-0.5.5.dev31 → xync_db-0.5.5.dev64}/src/xync_db/migrations/models/seed/a_tg_seed.py

@@ -51,11 +51,14 @@ async def tg_seed(_: BaseDBAsyncClient) -> str:
         "ArmBussinessBank": ("ArmBusinessBank", 20),
         "Asia United Bank (QR) lightnin...": ("Asia United Bank (QR) lightning", 11),
         "Bank Credit Dnepro": ("Credit Dnipro", 14),
+        "Banco de Desarollo Rural": ("Banco de desarrollo Rural", 4),
+        "Banco Itau de Chile": ("Banco Itau Chile", 4),
         "Banistimo Panamá": ("Banistmo Panama", 14),
         "Banque du Developpement Local BDL": ("Banque de développement local (BDL)", 3),
         "Banque de développement local (BDL)": ("Banque de développement local (BDL)", None),
         "BDO": ("Banco De Oro (BDO)", None),
         "Careen Pay": ("Careem Pay", None),
+        "CenterCreditBank": ("CenterCredit Bank", 4),
         "Cash in Person Transaction": ("Cash in Person", 2),
         "Cash Plus": ("Cashplus", 12),
         "Chinabank": ("China Bank", 14),
@@ -66,8 +69,11 @@ async def tg_seed(_: BaseDBAsyncClient) -> str:
         "Elkart": ("Elcart", 20),
         "Erste Group Bank": ("Erste Bank", 3),
         "eZ Cash": ("eZCash", 3),
+        "Grab Pay": ("GrabPay", 9),
         "GTB Bank (Guarantee Trust Bank)": ("GTBank", None),
         "IMEpay": ("IME Pay", 2),
+        "Kapital Bank": ("KapitalBank", 12),  # азербайджанский Kapital Bank = «KapitalBank» Bybit/Htx/Mexc
+        "Kapital Bank Instant": ("KapitalBank", 12),
         "Liv KSA": ("Liv.KSA", 14),
         "Liv.KSA": ("Liv.KSA", 3),
         "Local Bank (R-Green)": ("Sberbank", None),
@@ -84,23 +90,46 @@ async def tg_seed(_: BaseDBAsyncClient) -> str:
         "LINE Bank by Hana Bank": ("LINE Pay", 3),
         "Local Bank (S-Green)": ("Sberbank", 7),
         "m 10": ("m10", 3),
+        "MICB": ("MICB Bank", 9),  # «Bank» в цели — флаг банка для set_pms (Pm.bank), norm не меняется
         "M-PESA kenya(Safaricom)": ("M-PESA kenya (Safaricom)", 11),
         "Mercado Pago": ("Mercadopago", 11),
+        "Metrobank": ("Metropolitan Bank of the Philippines", 12),
+        "Millenium": ("Millennium", None),
+        "Mpesa Pochi la Biashara": ("M-PESA Pochi la Biashara", None),
         "NaranjaX": ("Naranja X", 2),
+        "National Bank of Egyp (NBE)": ("National Bank of Egypt (NBE)", 12),
+        "OptimaBank": ("Optima Bank", 12),
+        "Oschabank": ("Oschadbank", 12),
+        "Otkritie FC Bank": ("Otkritie Bank", 12),
+        "PagoMóvil": ("Pago Movil", None),
+        "Palm Pay": ("PalmPay", None),
         "Philippine National Bank (PNB)": ("Philippines National Bank (PNB)", 12),
         "Philippine National Bank": ("Philippines National Bank", 3),
+        "Pochta Bank": ("Post Bank", 12),
+        "PUMB": ("PUMB Bank", None),
+        # страна в цели: у Bybit ПриватБанк с Ukraine, у Htx/Mexc без страны — Pm уникален по (norm, country)
+        "Privat Bank": ("Privatbank (Ukraine)", None),
+        "Privat Bank (Universal Card)": ("Privatbank (Ukraine)", 12),
+        "PSB": ("Promsvyazbank", 9),
         "SBP - Fast Bank Transfer": ("SBP", None),
         "Sovkombank": ("Sovcombank", 9),
         "SBP Fast Bank Transfer": ("SBP", 14),
         "Rabbit LINE Pay": ("LINE Pay", 20),
+        "Rabitabank": ("Rabita Bank", 12),
         "Raiffaisen Bank": ("Raiffeisen Bank", 14),
         "Raiffaizen": ("Raiffeisen", 14),
+        "Raiffeisen Bank": ("Raiffeisenbank", 12),
         "Russian Standart Bank": ("Russian Standard Bank", 4),
+        "Santander México": ("Santander Mexico", 4),
+        "Scotiabank Perú": ("Scotiabank Peru", 12),
         "Sovkm Bank": ("Sovcombank", 3),
+        "Sport Bank": ("Sportbank", 12),
+        "Superbank": ("Super Bank", 12),
         "Tinkoff": ("T-Bank", None),
         "Tinkoff Bank": ("T-Bank", 2),
         "Transfer with Specific Bank": ("Transfers with specific bank", 2),
         "TrueMoney": ("True Money", 20),
+        "UBRR": ("UBRR Bank", 9),
         "TrueMoney (Cambodia)": ("True Money (Cambodia)", 2),
         "TrueMoney (cambodia)": ("True Money (Cambodia)", 14),
         "United Bank of Africa": ("United Bank for Africa", 4),
@@ -113,7 +142,9 @@ async def tg_seed(_: BaseDBAsyncClient) -> str:
         "YapıKredi": ("Yapi Kredi", 1),  # noqa: RUF001 - Turkish dotless-i is the exchange-side spelling
         "Zain Cash - Business": ("ZainCash - Business", 14),
         "Zain Cash": ("ZainCash", None),
-        "Zalo Pay": ("ZaloPay", 12),
+        # страна в цели: у Bybit ZaloPay с Southeast Asia, у Htx/Mexc без страны
+        "Zalo Pay": ("ZaloPay (Southeast Asia)", None),
+        "ZaloPay": ("ZaloPay (Southeast Asia)", None),
         "Zirraat": ("Ziraat", 3),
         "СБП": ("SBP", 2),
         "ЮMoney": ("YooMoney", None),

{xync_db-0.5.5.dev31 → xync_db-0.5.5.dev64}/src/xync_db/models/CLAUDE.md

@@ -72,6 +72,8 @@ actor.set_user(username_id):
 - `CredEx` = credential registered on exchange `(ex_id, exid)` unique
 - `Fiat` = balance tracker (one-to-one with `Cred`): `amount`, `target`, `min_deposit`
 - `PmAgent` = automation account for a PM `(pm_id, user_id)` unique
+- `Pm` unique `(norm, country)`; дубли сливает ЕДИНСТВЕННЫЙ writer `Pm.merge(keep_id, dup_ids)` (переносит PmEx/PmCur/ad_pm/
+  cond_banks/креды/агентов, удаляет дубли) — плюс правило `PmRep` в seed `a_tg_seed.pm_reps`, чтобы `set_pms` не пересоздал дубль
 
 ### P2P Trading
 `Ad` -> `MyAd` -> `Race` -> `RaceStat`, `Order` -> `Msg`/`Transfer`/`Task`, `Hot`
@@ -84,10 +86,22 @@ actor.set_user(username_id):
 - `Transfer` = order payment record with `amount`, optional `File` (receipt)
 
 ### Conditions (Ad parsing)
-`Cond` -> `CondParsed`, `Synonym`, `CondSim`
+`Cond` -> `CondParsed`, `Synonym`, `CondSim`, `CondPrompt`
 
 - `Cond.raw_txt` = original ad conditions text (4095 chars max, unique)
-- `CondParsed` = structured parse result: `to_party`/`from_party` (`Party`), `ppo`, `slip_req`/`slip_send` (`Slip`), abuse flags, linked bank `Pm`s
+- `CondParsed` = structured parse result: `from_party` / `to_party` (`FromParty`: с чьего / на чей счёт идёт платёж
+  покупателя), `ppo`, `slip` (`Slip`) — требует/шлёт понятно из направления объявы, abuse flags, `is_intermediary`
+  (мейкер-посредник «треугол»), linked bank `Pm`s
+  — все поля nullable, дефолт `None` (= «в условии не сказано»; никаких `*.no`-заглушек). Единый writer
+  `CondParsed.upsert(cond_id, bank_ids=None, **fields)` (бот-разметка /cond и Gemini, D-043); ответ админа
+  на «сохранить разбор?» — эмиттер `CondParsed.answer(cond_id, remark=None)` → pg-канал `cond_ai_answer`
+  `[cond_id, remark]` (null — «да», текст — «нет» с замечанием, "" — «нет», замечание пишется, true — «🔄»: объяву
+  условия заново с биржи — реальный exid замаскированного мейкера + свежий `raw_txt`, затем вопрос заново); возвращает, слушает
+  ли канал хоть один прогон (pg_stat_activity) — иначе ответ пропал бы молча
+- `CondPrompt` = версии промпта разбора: системного промпта Gemini и (`is_jev`) вопросов JEV JSON-ом — у каждого
+  действует последняя (`id` max); пишет только `CondAi` (засев исходной + правки Claude по замечаниям админа, `cond` —
+  условие правки: его одобренный `CondParsed` — эталон регресс-проверки следующих). FK на `cond` — SET NULL: история
+  версий не теряется
 - `Synonym` = condition term with `typ` (`SynonymType`), optional regex (`is_re`), boundary matching
 
 ### Transactions (XyncPay)

{xync_db-0.5.5.dev31 → xync_db-0.5.5.dev64}/src/xync_db/models/__init__.py

@@ -1,15 +1,17 @@
 from __future__ import annotations
 
+import json
 import logging
 import re
 import struct
 import sys
 from collections.abc import Collection
-from datetime import datetime
+from datetime import datetime, timedelta
 from decimal import Decimal
 from time import time
 from typing import ClassVar
 from uuid import UUID
+from zoneinfo import ZoneInfo
 
 from aiohttp import ClientSession
 from cryptography.exceptions import InvalidSignature
@@ -19,9 +21,10 @@ from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PrivateKey,
 from pyro_client.models import File  # noqa: F401
 from tortoise import BackwardFKRelation, BackwardOneToOneRelation, BaseDBAsyncClient, connections
 from tortoise import Model as BaseModel
-from tortoise.expressions import Q
+from tortoise.expressions import Q, Subquery
 from tortoise.fields import (
     CASCADE,
+    SET_NULL,
     BigIntField,
     BinaryField,
     BooleanField,
@@ -40,9 +43,10 @@ from tortoise.fields import (
     OneToOneNullableRelation,
     OneToOneRelation,
     SmallIntField,
+    TextField,
     UUIDField,
 )
-from tortoise.functions import Sum
+from tortoise.functions import Count, Sum
 from tortoise.migrations.constraints import CheckConstraint
 from tortoise.signals import pre_save
 from tortoise.timezone import now
@@ -63,7 +67,7 @@ from x_auth.models import (  # noqa: F401
 )
 from x_auth.models import Country as BaseCountry
 from x_auth.models import User as TgUser
-from x_model.field import DatetimeSecField, UInt1Field, UInt2Field, UInt4Field, UInt8Field, UniqBinaryField
+from x_model.field import DatetimeSecField, UInt1Field, UInt2Field, UInt4Field, UInt8Field, UInt16Field, UniqBinaryField
 from x_model.models import TsTrait
 
 from xync_db.enums import (
@@ -73,15 +77,18 @@ from xync_db.enums import (
     AgentStatus,
     Boundary,
     CoinType,
+    CredType,
     DepType,
     ExAction,
     ExStatus,
     ExType,
+    FromParty,
+    GeminiModel,
+    GeminiRes,
     HotStatus,
     LinkType,
     OrderErr,
     OrderStatus,
-    Party,
     PersonStatus,
     PmType,
     SbpStrict,
@@ -237,10 +244,11 @@ class Ex(Model):
         client = sys.modules[module_name].ExClient
         return client(self, **kwargs)
 
-    def etype(self):
-        module_name = f"xync_client.{self.name}.etype"
-        __import__(module_name)
-        return sys.modules[module_name]
+    def agent_cls(self) -> type:
+        # per-Ex AgentClient: и конструктор живого агента (Agent.client), и classmethod'ы-ссылки, которым сессия
+        # не нужна (get_url/order_url) — зовутся по классу из prefetch'нутых данных в любом процессе
+        __import__(module := f"xync_client.exs.{self.name}.agent")
+        return sys.modules[module].AgentClient
 
 
 class CurEx(BaseModel):
@@ -957,21 +965,9 @@ class User(TgUser, TsTrait):
             ks = coin_scales.get((mad.ad.maker.ex_id, mad.ad.pair_side.pair.coin_id), 0)
             return round(mad.ad.quantity * 10**-ks, ks)
 
-        # web/mob ссылки на объяву биржеспецифичны (формат/наличие share-hex), поэтому формирует их per-Ex
-        # AgentClient.get_url. Берём класс нужной биржи тем же __import__, что Agent.client, но дёргаем
-        # classmethod без живого агент-клиента: ссылку считаем из самой (prefetch'нутой) объявы, сессия не нужна.
-        url_clss: dict[str, type] = {}
-
-        def ad_url(mad: MyAd) -> tuple[str | None, str | None]:
-            name = mad.ad.maker.ex.name
-            if (acl := url_clss.get(name)) is None:
-                __import__(module := f"xync_client.exs.{name}.agent")
-                acl = url_clss[name] = sys.modules[module].AgentClient
-            return acl.get_url(mad)
-
         take_sales, take_buys = [], []
         for buy_ad in buy_ads:
-            web_url, mob_url = ad_url(buy_ad)
+            web_url, mob_url = buy_ad.urls()
             cur_scale = cur_scales[(buy_ad.ad.maker.ex_id, buy_ad.ad.pair_side.pair.cur_id)]
             if mine:  # для своих объяв лимит берем из самого объявления, без сверки с балансами
                 max_fiat = buy_ad.ad.max_fiat
@@ -1019,7 +1015,7 @@ class User(TgUser, TsTrait):
                 max_fiat = int(min(sell_ad.ad.max_fiat, deposit)) if sell_ad.ad.max_fiat else int(deposit)
                 if max_fiat < min_fiat:
                     continue  # не хватает
-            web_url, mob_url = ad_url(sell_ad)
+            web_url, mob_url = sell_ad.urls()
             # есть ли у юзера actor (через person) на бирже этого объявления
             actor_defined = await Actor.filter(person__user_id=self.id, ex_id=sell_ad.ad.maker.ex_id).exists()
             take_buys.append(
@@ -1090,12 +1086,18 @@ class Forum(Model, TsTrait):
 
 
 class Actor(Model):
-    exid: int = UInt8Field()
+    # реальные id бирж влезают в uint8; >= MASKED — id, замаскированный биржей (Bybit userMaskId, 128 бит):
+    # публичный листинг объяв прячет мейкера, реальный exid добудем отдельно (D-042)
+    MASKED: ClassVar[int] = 1 << 64
+    exid: int = UInt16Field()
     name: str = CharField(63)
     ex: ForeignKeyRelation[Ex] = ForeignKeyField("models.Ex", "actors", on_update=CASCADE)
     ex_id: int
-    person: ForeignKeyRelation[Person] = ForeignKeyField("models.Person", "actors", on_update=CASCADE)
-    person_id: int
+    # NULL — у замаскированного актора: персону (Ex.person_save) заводим, когда известен реальный exid
+    person: ForeignKeyNullableRelation[Person] = ForeignKeyField(
+        "models.Person", "actors", on_update=CASCADE, null=True
+    )
+    person_id: int | None
 
     agent: BackwardOneToOneRelation[Agent]
     # conds: BackwardFKRelation[Cond]
@@ -1197,10 +1199,7 @@ class Agent(Model, TsTrait):
     # computed = ["balance"]
 
     def client(self, ex_cl, pm_clients=None, proxy=None):
-        module_name = f"xync_client.exs.{self.actor.ex.name}.agent"
-        __import__(module_name)
-        client = sys.modules[module_name].AgentClient
-        return client(
+        return self.actor.ex.agent_cls()(
             self,
             ex_cl,
             pm_clients or {},
@@ -1329,12 +1328,23 @@ class Agent(Model, TsTrait):
 
 
 class Cond(Model, TsTrait):
-    raw_txt: str = CharField(4095, unique=True)
+    # unique (raw_txt, ads.pair_side.is_sell): тот же текст у buy и sell объяв — два условия (см. side_get). Tortoise
+    # uniq через join не выразит → триггеры ad_cond_side_uniq / cond_txt_side_uniq (0002_triggers). Условие без объяв
+    # не живёт: осиротевшее (объява перецеплена/удалена) и новое без объявы к коммиту удаляет cond_gc (0002_triggers)
+    raw_txt: str = CharField(4095, db_index=True)
     last_ver: str = CharField(4095, null=True)
     # ads: BackwardFKRelation[Ad]
     # parsed: BackwardOneToOneRelation[CondParsed]
     # sim: BackwardOneToOneRelation[Cond]
 
+    @classmethod
+    async def side_get(cls, txt: str, is_sell: bool) -> Cond:
+        """Условие с текстом `txt` для объявы стороны `is_sell`. Сторона условия — сторона его объяв
+        (ads.pair_side.is_sell), а разбор (from_party/to_party) от неё зависит, поэтому buy и sell объявам с
+        одинаковым текстом — разные условия. Нет условия с объявами этой стороны — новое: звать только в одной
+        транзакции с записью объявы в него, иначе его снесёт на коммите cond_new_gc."""
+        return await cls.filter(raw_txt=txt, ads__pair_side__is_sell=is_sell).first() or await cls.create(raw_txt=txt)
+
     async def sims(self):
         return {self.raw_txt: await self.sim.sims()} if await self.sim else self.raw_txt
 
@@ -1346,14 +1356,14 @@ class Synonym(BaseModel):
     curs: ManyToManyRelation[Cur] = ManyToManyField(
         "models.Cur", "synonym_cur", related_name="synonyms", on_update=CASCADE
     )
-    val: int | None = UInt2Field(null=True)  # SynonymType dependent (e.g., no-slavic for name, approx for ppo.)
+    val: int | None = UInt2Field(null=True)  # SynonymType dependent (e.g., approx for ppo.)
     is_re: bool = BooleanField(db_default=False)
 
 
 class CondSim(BaseModel):
     cond: OneToOneRelation[Cond] = OneToOneField("models.Cond", "sim", primary_key=True, on_update=CASCADE)
     cond_id: int  # new
-    similarity: int = UInt2Field(db_index=True)  # /1000
+    similarity: int = UInt2Field(db_index=True)  # (SequenceMatcher.ratio - 0.6) * 10_000 — xync_client.base.Ex.get_sim
     cond_rel: ForeignKeyRelation[Cond] = ForeignKeyField("models.Cond", "sims_rel", on_update=CASCADE)
     cond_rel_id: int  # old
 
@@ -1413,6 +1423,36 @@ class Pm(Model):
         table_description = "Payment methods"
         unique_together = (("norm", "country"), ("alias", "country"))
 
+    @classmethod
+    async def merge(cls, keep_id: int, dup_ids: list[int]) -> None:
+        """ЕДИНСТВЕННЫЙ writer слияния дублей Pm в `keep_id`: биржевые строки (PmEx), валюты (PmCur; если у keep
+        такая валюта уже есть — креды/лимиты дубля переезжают на его PmCur), объявы, условия, override-креды, агенты
+        и topupable; при конфликте уникальности остаётся строка keep. Дубли удаляются. Креды, которые столкнутся
+        уникальностью (person, pmcur, …), роняют всю транзакцию — это уже дедуп кредов, не Pm. Чтобы сидер
+        (`set_pms`) не пересоздал дубль, его биржевые имена сводятся к keep правилом `PmRep` (seed `a_tg_seed`)."""
+        async with in_transaction() as db:
+            for dup in dup_ids:  # по одному: два дубля с общей валютой, которой нет у keep, не столкнутся
+                for sql in (
+                    "UPDATE pmex SET pm_id=$1 WHERE pm_id=$2",
+                    "UPDATE cred c SET pmcur_id=k.id FROM pmcur d JOIN pmcur k ON k.cur_id=d.cur_id AND k.pm_id=$1"
+                    " WHERE c.pmcur_id=d.id AND d.pm_id=$2",
+                    'UPDATE "limit" l SET pmcur_id=k.id FROM pmcur d JOIN pmcur k ON k.cur_id=d.cur_id AND k.pm_id=$1'
+                    " WHERE l.pmcur_id=d.id AND d.pm_id=$2",
+                    "DELETE FROM pmcur d USING pmcur k WHERE d.pm_id=$2 AND k.pm_id=$1 AND k.cur_id=d.cur_id",
+                    "UPDATE pmcur SET pm_id=$1 WHERE pm_id=$2",
+                    "INSERT INTO ad_pm (ad_id, pm_id) SELECT ad_id, $1 FROM ad_pm WHERE pm_id=$2 ON CONFLICT DO NOTHING",
+                    "INSERT INTO cond_banks (cond_parsed_id, pm_id) SELECT cond_parsed_id, $1 FROM cond_banks"
+                    " WHERE pm_id=$2 ON CONFLICT DO NOTHING",
+                    "UPDATE cred SET ovr_pm_id=$1 WHERE ovr_pm_id=$2",
+                    "UPDATE pm_agent d SET pm_id=$1 WHERE pm_id=$2"
+                    " AND NOT EXISTS (SELECT 1 FROM pm_agent k WHERE k.pm_id=$1 AND k.user_id=d.user_id)",
+                    "UPDATE topupable SET pm_id=$1 WHERE pm_id=$2"
+                    " AND NOT EXISTS (SELECT 1 FROM topupable WHERE pm_id=$1)",
+                ):
+                    await db.execute_query(sql, [keep_id, dup])
+                # остатки (ad_pm/cond_banks/agent/topupable, столкнувшиеся с keep) уходят каскадом
+                await db.execute_query("DELETE FROM pm WHERE id=$1", [dup])
+
     # class PydanticMeta(Model.PydanticMeta):
     #     max_recursion = 3
     #     backward_relations = True
@@ -1427,24 +1467,125 @@ class Pm(Model):
 class CondParsed(Model, TsTrait):
     cond: OneToOneNullableRelation[Cond] = OneToOneField("models.Cond", "parsed", on_update=CASCADE, null=True)
     cond_id: int | None  # new
-    to_party: Party = IntEnumField(Party, null=True)
-    from_party: Party = IntEnumField(Party, null=True)
+    from_party: FromParty = IntEnumField(FromParty, null=True)  # с чьего счёта платят
+    to_party: FromParty | None = IntEnumField(FromParty, null=True)  # на чей счёт платят
     ppo: int = UInt1Field(null=True)  # Payments per order
-    slip_req: Slip = IntEnumField(Slip, null=True)
-    slip_send: Slip = IntEnumField(Slip, null=True)
-    abuser: AbuserType = IntEnumField(AbuserType, db_default=AbuserType.no)
+    slip: Slip = IntEnumField(Slip, null=True)
+    abuser: AbuserType | None = IntEnumField(AbuserType, null=True)
     slavic: bool = BooleanField(null=True)
+    cred: CredType | None = IntEnumField(
+        CredType, null=True
+    )  # требование к реквизитам тейкера; (foreign — предупреждение мейкера-продавца о своей зарубежной карте)
     mtl_like: bool = BooleanField(null=True)
     scale: int = SmallIntField(null=True)
     bank_side: bool = BooleanField(null=True)  # False - except these banks, True - only this banks
-    sbp_strict: SbpStrict = IntEnumField(SbpStrict, db_default=SbpStrict.no)
+    sbp_strict: SbpStrict | None = IntEnumField(SbpStrict, null=True)
     contact: str | None = CharField(127, null=True)
-    done: bool = BooleanField(db_default=False, db_index=True)
+    is_intermediary: bool | None = BooleanField(null=True)  # мейкер-посредник («треугол»): сводит с чужим ордером
     banks: ManyToManyRelation[Pm] = ManyToManyField("models.Pm", "cond_banks", related_name="conds", on_update=CASCADE)
 
+    ANSWER = "cond_ai_answer"  # pg-канал ответа админа «сохранить разбор Gemini?» (answer → lens.parse_conds_admin)
+
     class Meta:
         table = "cond_parsed"
 
+    @classmethod
+    async def upsert(cls, cond_id: int, bank_ids: list[int] | None = None, **fields) -> CondParsed:
+        """ЕДИНСТВЕННЫЙ writer разбора условия: бот-разметка /cond (по полю) и Gemini (lens.parse_conds_admin,
+        целиком). bank_ids: None — банки не трогаем, список — заменяем им cond_banks."""
+        async with in_transaction():
+            cp, _ = await cls.update_or_create(fields, cond_id=cond_id)
+            if bank_ids is not None:
+                await cp.banks.clear()
+                await cp.banks.add(*await Pm.filter(id__in=bank_ids))
+        return cp
+
+    @classmethod
+    async def answer(cls, cond_id: int, remark: str | bool | None = None) -> bool:
+        """Ответ админа на вопрос «сохранить разбор Gemini?» (бот, routers/cond): `remark` None — «да», текст —
+        «нет» с замечанием, что не так (по нему Claude правит промпт — `CondAi.fix`), "" — «нет», замечание пишется,
+        True — «🔄»: объяву условия заново с биржи (реальный exid мейкера, свежий текст), затем вопрос заново.
+        Ждёт его прогон lens.parse_conds_admin в ДРУГОМ процессе (скрипт/крон), а ответ ловит бот api — поэтому через
+        pg_notify, как Agent.confirm_trade; на «да» разбор пишет сам ждущий (у него распарсенные поля).
+        → ждёт ли кто-то: без слушателя pg_notify молча пропадает (прогон упал/закончился) — бот скажет это админу.
+        Слушатель виден в pg_stat_activity: его соединение после LISTEN больше ничего не выполняет."""
+        _, [row] = await connections.get("default").execute_query(
+            f"SELECT pg_notify('{cls.ANSWER}', jsonb_build_array($1::int, $2::jsonb)::varchar),"
+            f" EXISTS(SELECT 1 FROM pg_stat_activity WHERE query = 'LISTEN \"{cls.ANSWER}\"') waits",
+            [cond_id, json.dumps(remark)],
+        )
+        return row["waits"]
+
+
+class CondPrompt(Model):
+    """Версия промпта разбора условий (`xync_service.common.cond_ai`): системного промпта Gemini или вопросов JEV
+    (`is_jev`, JSON) — у каждого действует последняя. Новую пишет Claude по замечанию админа к отклонённому разбору
+    (`CondAi.fix`); `cond` — это условие: когда админ одобрит его разбор, `CondParsed` условия станет эталоном
+    регресс-проверки следующих правок."""
+
+    txt: str = TextField()
+    is_jev: bool = BooleanField(db_default=False)  # промпт JEV (её вопросы JSON-ом), иначе — Gemini
+    cond: ForeignKeyNullableRelation[Cond] = ForeignKeyField(  # удаление условия версию промпта не сносит
+        "models.Cond", "prompts", on_update=CASCADE, on_delete=SET_NULL, null=True
+    )
+    cond_id: int | None
+    remark: str | None = TextField(null=True)  # замечание админа
+    note: str | None = TextField(null=True)  # что изменил Claude
+    created_at: datetime = DatetimeSecField(auto_now_add=True, db_default=Now())
+
+    class Meta:
+        table = "cond_prompt"
+
+
+class GeminiKey(Model):
+    """Ключ Gemini API free tier (разбор условий, `xync_service.common.cond_ai`). Квота своя на каждую модель, расход и
+    выбывание ключа — по истории его запросов (`GeminiReq`)."""
+
+    key: str = CharField(63, unique=True)
+    # reqs: BackwardFKRelation[GeminiReq]
+
+    class Meta:
+        table = "gemini_key"
+
+    @classmethod
+    async def pick(cls, model: GeminiModel, rpm: int, rpd: int) -> GeminiKey | None:
+        """Ключ для запроса к `model` при квоте на ключ `rpm` запросов в минуту и `rpd` в сутки: запросов к ней с
+        последнего сброса квоты (полночь по Тихоокеанскому — у всех ключей разом) меньше `rpd` и за минуту меньше `rpm`
+        — сверх квоты не шлём; без 429 PerDay по ней и bad_key с последнего сброса, без прочих 429 по ней за минуту —
+        отказ Google главнее счётчика; наименее нагруженный ею — ключи идут по кругу. None — ни одного: не ждать, а к
+        следующей модели / громко упасть."""
+        reset = datetime.now(ZoneInfo("America/Los_Angeles")).replace(hour=0, minute=0, second=0, microsecond=0)
+        minute = now() - timedelta(minutes=1)
+        out = GeminiReq.filter(
+            Q(res=GeminiRes.bad_key, created_at__gte=reset)
+            | Q(res=GeminiRes.day, model=model, created_at__gte=reset)
+            | Q(res=GeminiRes.minute, model=model, created_at__gte=minute)
+        )
+        return await (
+            cls.exclude(id__in=Subquery(out.values("key_id")))
+            .annotate(
+                d=Count("reqs", _filter=Q(reqs__model=model, reqs__created_at__gte=reset)),
+                m=Count("reqs", _filter=Q(reqs__model=model, reqs__created_at__gte=minute)),
+            )
+            .filter(d__lt=rpd, m__lt=rpm)
+            .order_by("d", "id")
+            .first()
+        )
+
+
+class GeminiReq(Model):
+    """Запрос к Gemini (`cond_ai._generate`) — история за сутки (старше удаляет `CondAi` на входе): по ней
+    `GeminiKey.pick` выбирает ключ, по ней же видно расход квот ключей по моделям."""
+
+    key: ForeignKeyRelation[GeminiKey] = ForeignKeyField("models.GeminiKey", "reqs", on_update=CASCADE)
+    key_id: int
+    model: GeminiModel = IntEnumField(GeminiModel)
+    res: GeminiRes = IntEnumField(GeminiRes)
+    created_at: datetime = DatetimeSecField(auto_now_add=True, db_default=Now())
+
+    class Meta:
+        table = "gemini_req"
+
 
 class Ad(Model, TsTrait):
     exid: int = UInt8Field(db_index=True)
@@ -1454,8 +1595,8 @@ class Ad(Model, TsTrait):
     premium: int = SmallIntField(null=True, db_default=None)  # *100
     amount: int = UInt4Field(null=True)  # /10^cur.scale
     quantity: int = UInt8Field(null=True)  # /10^coinex.scale
-    min_fiat: int = UInt4Field()  # /10^cur.scale
-    max_fiat: int | None = UInt4Field(null=True)  # /10^cur.scale
+    min_fiat: int = UInt4Field()  # целые единицы валюты, БЕЗ scale (ExClient._ad_xe2x: min — ceil, max — floor)
+    max_fiat: int | None = UInt4Field(null=True)  # целые единицы валюты, БЕЗ scale
     auto_msg: str | None = CharField(4095, null=True)
     status: AdStatus = IntEnumField(AdStatus, db_default=AdStatus.active)
     filtered: bool = BooleanField(db_default=False)
@@ -1633,6 +1774,11 @@ class MyAd(Model):  # Road
     class Meta:
         table = "my_ad"
 
+    def urls(self) -> tuple[str | None, str | None]:
+        # web/mob ссылки на объяву биржеспецифичны (формат/наличие share-hex) — строит per-Ex AgentClient.get_url
+        # из самой объявы, без сессии. Требует ad__maker__ex + ad__pair_side__pair__coin/cur
+        return self.ad.maker.ex.agent_cls().get_url(self)
+
     @classmethod
     # запрос для получения объяв всех агентов этой биржи для разогрева
     def hot_mads_query(cls, ex_ids: list[int], active: bool = True):
@@ -2374,11 +2520,8 @@ class Order(Model, TsTrait):
 
     def ex_url(self) -> str:
         # ссылка на этот ордер на его бирже — биржеспецифична (Bybit/orderList, Htx/tradeInfo…);
-        # строит per-Ex AgentClient.order_url. Берём класс нужной биржи тем же __import__, что client(),
-        # но дёргаем classmethod из одного exid — живой агент-клиент/сессия не нужны. Требует ad__maker__ex.
-        module_name = f"xync_client.exs.{self.ad.maker.ex.name}.agent"
-        __import__(module_name)
-        return sys.modules[module_name].AgentClient.order_url(self.exid)
+        # строит per-Ex AgentClient.order_url (classmethod из одного exid — сессия не нужна). Требует ad__maker__ex.
+        return self.ad.maker.ex.agent_cls().order_url(self.exid)
 
     async def get_chat(self):
         await self.fetch_related("ad__pair_side", "msgs")