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

xync_db-0.5.5.dev82/.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.env
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+dist/
+build/
+*.log*
+
+# uv
+.uv-cache/
+
+# Node
+node_modules/
+*.tsbuildinfo
+
+# Env
+.env
+.env.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+
+packages/xync-web
+packages/xync-chrome-ext

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: xync-db
-Version: 0.5.5.dev64
+Version: 0.5.5.dev82
 Summary: Xync DB schema: Tortoise ORM models, enums, pydantic DTOs.
 Author-email: Mike Artemiev <mixartemev@gmail.com>
 License: LicenseRef-EULA
@@ -56,7 +56,7 @@ Single source of truth for data shape across the monorepo.
 classDiagram
 direction BT
 class Actor {
-   uint8 exid
+   uint16 exid
    uint1 ex_id
    varchar(63) name
    integer person_id
@@ -335,13 +335,7 @@ user  -->  username : username_id->username.id
 - а в `Order` соответственно через `ad_id` получаем `ad.actor.ex_id`
 
 
-## Migrations (native Tortoise CLI — no aerich)
-```bash
-cd packages/xync-db
-tortoise init              # only once
-tortoise makemigrations    # detect changes
-tortoise migrate           # apply
-tortoise downgrade models 0001_initial   # roll back
-tortoise sqlmigrate models 0001_initial  # preview SQL
-```
-Config lives in this package's `pyproject.toml` under `[tool.tortoise]`.
+## Миграции
+Ровно три: `0001_initial` (схема), `0002_triggers`, `0003_seed`; изменение схемы — правкой `0001`, новых миграций
+не заводим (`src/xync_db/migrations/CLAUDE.md`). Применить: `tortoise migrate` (конфиг — `[tool.tortoise]` в
+`pyproject.toml`).

{xync_db-0.5.5.dev64 → xync_db-0.5.5.dev82}/README.md

@@ -38,7 +38,7 @@ Single source of truth for data shape across the monorepo.
 classDiagram
 direction BT
 class Actor {
-   uint8 exid
+   uint16 exid
    uint1 ex_id
    varchar(63) name
    integer person_id
@@ -317,13 +317,7 @@ user  -->  username : username_id->username.id
 - а в `Order` соответственно через `ad_id` получаем `ad.actor.ex_id`
 
 
-## Migrations (native Tortoise CLI — no aerich)
-```bash
-cd packages/xync-db
-tortoise init              # only once
-tortoise makemigrations    # detect changes
-tortoise migrate           # apply
-tortoise downgrade models 0001_initial   # roll back
-tortoise sqlmigrate models 0001_initial  # preview SQL
-```
-Config lives in this package's `pyproject.toml` under `[tool.tortoise]`.
+## Миграции
+Ровно три: `0001_initial` (схема), `0002_triggers`, `0003_seed`; изменение схемы — правкой `0001`, новых миграций
+не заводим (`src/xync_db/migrations/CLAUDE.md`). Применить: `tortoise migrate` (конфиг — `[tool.tortoise]` в
+`pyproject.toml`).

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

@@ -236,7 +236,9 @@ class CredType(
     foreign = 3  # продавец просит платёж на зарубежную (не российскую) карту/номер: «перевод на зарубежную карту»
 
 
-class GeminiModel(IntEnum):  # модель Gemini (`GeminiReq`); имя в API, порядок силы и квоты — `cond_ai.MODELS`
+class GeminiModel(
+    IntEnum
+):  # модель Gemini (`GeminiReq`); имя в API, порядок силы и квоты — `cond_ai.providers.gemini.MODELS`
     lite_3_5 = 5
     lite_3_1 = 6
 

{xync_db-0.5.5.dev64 → xync_db-0.5.5.dev82}/src/xync_db/i18n.py

@@ -1,4 +1,4 @@
-"""Bilingual text selector for user-facing strings (D-026).
+"""Bilingual text selector for user-facing strings (D-08).
 
 Usage::
 

xync_db-0.5.5.dev82/src/xync_db/migrations/CLAUDE.md

@@ -0,0 +1,21 @@
+# migrations — три миграции (D-09)
+
+Конфиг — `xync_service.config.TORTOISE_ORM`; `make migrate` / `make makemigrations` из корня.
+
+1. **`0001_initial`** — полная финальная схема (`ops.CreateModel`). **Любое изменение схемы — правкой этого
+   файла**: `0003_seed` пишет через ORM по финальной модели, поздняя миграция с новой колонкой уронит засев.
+   Новых миграций не заводим; на прод (ledger фейковый) — DDL руками.
+2. **`0002_triggers`** — все триггеры и функции (`CREATE OR REPLACE`): NOTIFY-каналы (`contracts/events.md`),
+   гарды (`tx_before`, `tx_no_delete`, `ad_exid_ex_uniq`, `ad_cond_side_uniq`, `cond_txt_side_uniq`), GC условий
+   (`ad_cond_gc`, `cond_new_gc`), утилиты `_user_balance`, `_tx_pack`. Идёт до засева — сид полагается на
+   `user_new`.
+3. **`0003_seed`** — засев по зависимостям: файлы PM-логотипов → `a_actor_seed` (биржи, 56 базовых валют, монеты,
+   XyncPay, эл. кошельки, origin user id=0) → `a_tg_seed` (DC/App, `pm_rep`) → `a_country_seed` (страны+валюты
+   из `seed/countries.json`) → `a_bin_seed` (BIN/банки из `seed/ranges.csv`) → `b_htx_seed` (валюты/монеты/пары
+   HTX) → `c_net_seed` (web3-сети).
+
+Засев, зависящий от Pm (`set_pms` с логотипами, `refine_pms`), — в `xync-script`, не здесь: миграции не
+импортируют `pyro_client`.
+
+Дев-БД пересобирать только с нуля (`DROP`/`CREATE` + `make migrate`); таблицы, созданные заранее
+`generate_schemas`, ломают `0001` (DuplicateTable).

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

@@ -595,7 +595,7 @@ class Migration(migrations.Migration):
             options={"table": "pm_group", "app": "models", "pk_attr": "id"},
             bases=["Model"],
         ),
-        # `bank` — раньше `Bank`/`Bin`/`Card` (D-038), т.к. на него ссылается `pm.bank_id`
+        # `bank` — раньше `Bank`/`Bin`/`Card` (D-17), т.к. на него ссылается `pm.bank_id`
         ops.CreateModel(
             name="Bank",
             fields=[
@@ -2691,7 +2691,7 @@ class Migration(migrations.Migration):
             options={"table": "vpn", "app": "models", "pk_attr": "id", "table_description": "VPNs"},
             bases=["Model"],
         ),
-        # ── Cards / BINs (D-038; засев — `0003_seed` → a_bin_seed из binlist/data; `Bank` создан выше — на него ссылается `pm`) ──
+        # ── Cards / BINs (D-17; засев — `0003_seed` → a_bin_seed из binlist/data; `Bank` создан выше — на него ссылается `pm`) ──
         ops.CreateModel(
             name="Bin",
             fields=[

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

@@ -1,7 +1,7 @@
 """PG triggers migration — ВСЕ триггеры БД в одном месте.
 
-Определяют NOTIFY-триггеры, которые слушает pg-listener service-api. Раньше часть жила отдельными
-миграциями (0005-0009); слиты сюда. `CREATE OR REPLACE` + порядок в `operations` дают финальную форму.
+Определяют NOTIFY-триггеры, которые слушает pg-listener service-api. `CREATE OR REPLACE` + порядок в
+`operations` дают финальную форму.
 
 Channels emitted:
     after_orders_new          -- new order, no hot_id
@@ -9,24 +9,23 @@ Channels emitted:
     hot_order_upd_status      -- hot order status change
     after_orders_upd_status   -- non-hot order status change
     agents_upd_status         -- agent status toggle
-    agents_upd_auth           -- agent web-session (cookies/headers) changed (0007)
+    agents_upd_auth           -- agent web-session (cookies/headers) changed
     actor_person_needs_def_user -- new actor needs person assignment
     after_users_new           -- new user (also creates person + xync-actor)
     tx_verified               -- transaction reached verified
     ads_upd / mads_upd        -- ad row changed (diff payload)
-    creds_new/creds_del/creds_upd, credexs_del (0005), credexs_orphan (0006) -- cred/credex lifecycle
-    w3addr_wanted / w3addr_filled -- web3 address handshake (0009)
+    creds_new/creds_del/creds_upd, credexs_del, credexs_orphan -- cred/credex lifecycle
+    w3addr_wanted / w3addr_filled -- web3 address handshake
 
 Guards (RAISE, без NOTIFY): tx_before (баланс/иммутабельность/монотонность), tx_no_delete,
-ad_exid_ex_uniq (0008, exid уникален per-exchange), ad_cond_side_uniq/cond_txt_side_uniq (unique
+ad_exid_ex_uniq (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).
+`note = "{ex_id}:{exid}"`, D-16). A person-less actor is a maker masked by the exchange (D-16).
 """
 
 from typing import ClassVar
@@ -39,8 +38,8 @@ TRIGGERS_SQL = """
 -- before new Actor
 CREATE OR REPLACE FUNCTION actor_new() returns trigger as $actor_new_trg$
 BEGIN
-    -- персону актору заводит ТОЛЬКО Python (Ex.person_save / Agent.upsert, note = "{ex_id}:{exid}", D-035);
-    -- актор без person_id — замаскированный биржей мейкер (D-042), персону ему не выдумываем.
+    -- персону актору заводит ТОЛЬКО Python (Ex.person_save / Agent.upsert, note = "{ex_id}:{exid}", D-16);
+    -- актор без person_id — замаскированный биржей мейкер (D-16), персону ему не выдумываем.
     -- агентской персоне уже проставлен status=-1 (USER_DEF) в Agent.upsert → зовём админа
     -- определить юзера (actor_person_needs_def_user).
     IF (SELECT status FROM person WHERE id = NEW.person_id) = -1 THEN
@@ -262,12 +261,12 @@ CREATE OR REPLACE TRIGGER cred_del BEFORE DELETE ON "cred" FOR EACH ROW EXECUTE
 """
 
 # ─────────────────────────────────────────────────────────────────────────────────────────────────
-# Дополнительные триггеры (были отдельными миграциями 0005-0009; здесь слиты). Все `CREATE OR REPLACE`,
+# Дополнительные триггеры. Все `CREATE OR REPLACE`,
 # поэтому порядок в `operations` гарантирует финальную форму: `credex_del` переопределяет дефолтный
 # `plsql("credex")` DEL, а `agent_upd` — базовый выше.
 # ─────────────────────────────────────────────────────────────────────────────────────────────────
 
-# Per-CredEx delete → `credexs_del` (0005). Юзер отвязывает ОДИН кред от ОДНОЙ биржи. Дефолтный
+# Per-CredEx delete → `credexs_del`. Юзер отвязывает ОДИН кред от ОДНОЙ биржи. Дефолтный
 # `plsql("credex")` DEL нёс лишь OLD.id — бесполезно после каскада. Шлём [person_id, ex_id, exid]
 # (person через ещё живой родительский `cred`). ПРОПУСКАЕМ notify если родитель-cred уже удалён:
 # это каскад Cred → BEFORE-DELETE `cred_del()` уже снял каждый credex в `creds_del` (иначе двойное
@@ -288,7 +287,7 @@ $credex_del_trg$ LANGUAGE plpgsql;
 CREATE OR REPLACE TRIGGER credex_del AFTER DELETE ON "credex" FOR EACH ROW EXECUTE FUNCTION credex_del();
 """
 
-# Per-CredEx exid-overwrite → `credexs_orphan` (0006). `CredEx.upsert` ключуется по (cred, ex) и
+# Per-CredEx exid-overwrite → `credexs_orphan`. `CredEx.upsert` ключуется по (cred, ex) и
 # перезаписывает `exid`. Перезапись РЕАЛЬНОГО (не 0) exid другим значением осиротит прежний кред на
 # бирже (БД его больше не трекает) — не утекаем молча: BEFORE-UPDATE шлёт [person_id, ex_id, OLD.exid,
 # OLD.cred_id], чтобы service-api спросил владельца, удалить ли устаревший (mirror `is_you`).
@@ -311,7 +310,7 @@ $credex_orphan_trg$ LANGUAGE plpgsql;
 CREATE OR REPLACE TRIGGER credex_orphan BEFORE UPDATE ON "credex" FOR EACH ROW EXECUTE FUNCTION credex_orphan();
 """
 
-# Agent.auth change → `agents_upd_auth` (0007). ПЕРЕОПРЕДЕЛЯЕТ `agent_upd` выше: второй, независимый
+# Agent.auth change → `agents_upd_auth`. ПЕРЕОПРЕДЕЛЯЕТ `agent_upd` выше: второй, независимый
 # branch шлёт `agents_upd_auth` ТОЛЬКО при реальной смене auth (`OLD.auth IS DISTINCT FROM NEW.auth`) —
 # service-api патчит куки/хедеры в ЖИВУЮ http-сессию агента (`BaseAgentClient.reload_auth`) без рестарта.
 # Независим от status-branch (status и auth меняются вместе или порознь).
@@ -330,7 +329,7 @@ $agent_upd_trg$ LANGUAGE plpgsql;
 CREATE OR REPLACE TRIGGER agent_upd AFTER UPDATE ON "agent" FOR EACH ROW EXECUTE FUNCTION agent_upd();
 """
 
-# Ad.exid uniqueness per-EXCHANGE, не per-maker (0008). `unique_together(exid, maker)` не ловит РАЗНОГО
+# Ad.exid uniqueness per-EXCHANGE, не per-maker. `unique_together(exid, maker)` не ловит РАЗНОГО
 # maker на ТОЙ ЖЕ бирже с чужим exid (биржа выдаёт ad-id глобально по аккаунтам). Tortoise не выразит
 # uniq через join (`maker`→`actor.ex_id` не колонка `ad`) → BEFORE INSERT/UPDATE RAISE на конфликт по
 # (exid≠0, тот же actor.ex_id). Падает громко на записи (как fail-loud в `Ex.e2x_ad`).
@@ -451,7 +450,7 @@ CREATE CONSTRAINT TRIGGER cond_new_gc AFTER INSERT ON "cond" DEFERRABLE INITIALL
     FOR EACH ROW EXECUTE FUNCTION cond_gc();
 """
 
-# web3-хендшейк адресов (0009): net_addr_ins (вставка пустого val → зовём получателя завести адрес,
+# web3-хендшейк адресов: 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.)
 NET_ADDR_TRIGGERS_SQL = """

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

@@ -1,8 +1,6 @@
 """Полный засев БД одной миграцией — файлы (PM-логотипы) + справочники/сущности в нужном порядке.
 
-Слияние прежних `0003_files_seed` и `0004_all_seed`. Идёт ПОСЛЕ триггеров (0002) и по ПОЛНОЙ схеме
-(0001), поэтому сидеры, пишущие через ORM (напр. `set_pairs` → `pair.scale`), не спотыкаются о
-недостающие колонки (раньше `pair.scale`/`country.ccn3` добавлялись миграциями ПОСЛЕ засева).
+Идёт ПОСЛЕ триггеров (0002) и по ПОЛНОЙ схеме (0001) — сидеры пишут через ORM по финальной модели.
 
 Порядок (зависимости):
   1. files       — PM-логотипы из `seed/xync_files.sql` (если файлов < 100)
@@ -13,7 +11,7 @@
   6. b_htx_seed   — HTX-специфика: валюты (CurEx), монеты, пары
   7. c_net_seed   — web3-сети (Net) + недостающие нативные монеты
 
-NB (D-017): PM-зависимый засев (`set_pms` + `refine_pms`) живёт в `packages/xync-script`, НЕ здесь —
+NB (D-09): PM-зависимый засев (`set_pms` + `refine_pms`) живёт в `packages/xync-script`, НЕ здесь —
 он тянет `pyro_client` (FileClient), а миграции не должны импортировать `pyro_client`.
 """
 

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

@@ -285,7 +285,7 @@ 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
+    # банков разбора условий, `cond_ai.banks`) + 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)

{xync_db-0.5.5.dev64 → xync_db-0.5.5.dev82}/src/xync_db/migrations/models/seed/a_bin_seed.py

@@ -5,7 +5,7 @@
 bank_logo,bank_url,bank_phone,bank_city`. `iin_start` — BIN-префикс (6 ИЛИ 8 цифр), `iin_end` —
 верх диапазона (пусто = одиночный). Диапазоны маленькие (макс. span 18), поэтому РАЗВОРАЧИВАЕМ их в
 отдельные префиксы — модель `Bin` остаётся префиксной (`Bin.for_card` ищет 6- и 8-значный префикс,
-`Card.from_number` режет тело по длине найденного BIN). См. D-038.
+`Card.from_number` режет тело по длине найденного BIN). См. D-17.
 
 Идём после стран, т.к. `Bin.country` линкуется на уже засеянные `Country` по alpha-2 (`short`).
 Банки дедуплицируем по `name` (первый вариант деталей выигрывает). Идемпотентно: guard по count +

{xync_db-0.5.5.dev64 → xync_db-0.5.5.dev82}/src/xync_db/migrations/models/seed/a_country_seed.py

@@ -1,13 +1,9 @@
 """Единый сидер стран и их валют — ПЕРЕД биржевыми сидерами (`b_htx_seed`).
 
 Данные — статический `countries.json` рядом (сгенерирован из mledoze/countries: `name.common`
-→ name, `cca2` → short, `ccn3` → ccn3, первая из `currencies` → cur). Раньше страны тянулись
-из HTX (`cl.countries()`) с ручными костылями (`cnt_codes` для пропавших short, `cur_map`,
-`additional_countries`) и разъезжались с реальностью: у 78 стран стояла USD-заглушка (HTX
-дефолтил `currencyId=1`), у Бенина short был `"BJ,"` с запятой. Теперь канонично:
+→ name, `cca2` → short, `ccn3` → ccn3, первая из `currencies` → cur):
 
-  • `ccn3`  — числовой ISO 3166-1 (бывшая колонка `code`, где лежал телефонный код — он нигде
-             не читался, см. миграцию 0012);
+  • `ccn3`  — числовой ISO 3166-1;
   • `short` — чистый ISO alpha-2;
   • `name`  — каноническое common-имя;
   • `cur`   — реальная валюта страны. Валюты, которых нет среди 56 базовых (`a_actor_seed`),

{xync_db-0.5.5.dev64 → xync_db-0.5.5.dev82}/src/xync_db/migrations/models/seed/b_htx_seed.py

@@ -14,7 +14,7 @@ async def htx_seed(db: BaseDBAsyncClient) -> str:
     await cl.set_curs()
 
     # NB: set_pms() lives in packages/xync-script now (it uploads logos via service-pyro and
-    # so must not pull pyro_client into xync-db — D-017). The script also re-runs the setters
+    # so must not pull pyro_client into xync-db — D-09). The script also re-runs the setters
     # below when an exchange is under-seeded, so they could move there too later.
     await cl.set_coins()
     await cl.set_pairs()

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

@@ -1,8 +1,4 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Overview
+# xync_db.models
 
 All Tortoise ORM models (~60) are defined in `__init__.py`. Models are organized into domain groups listed below.
 
@@ -51,18 +47,8 @@ Re-exported models from `x_auth`: `Username`, `Proxy`, `Dc`, `Fcm`, `App`, `Sess
 - `Addr` = crypto deposit address `(coin_id, actor_id)` unique; linked to `Net`s via `NetAddr`
 - `Asset` = balance snapshot `(addr_id, typ)` unique; amounts `free`/`freeze`/`lock`/`target`. Owner reached via `addr → actor` (agent 1:1 actor — the old `agent_id` was redundant with `addr.actor` and was dropped)
 
-actor.set_user(username_id):
-При создании юзера(User) в sql-триггере автоматически создается персона(Person) с его user_id.
-А при создании актора(Actor) создается персона без user_id, но в actor.person_id = id этой персоны.
-И когда юзер заходит в объявление одного из агентов(Agent) первый раз, создается его актор для биржи (на которой 
-размещено это объявление) и новая персона этого актора.
-Если к персоне юзера еще не "привязано" ни одного актора, 2 персоны для юзера с одним актором избыточны, их нужно 
-смерджить: т.е старой персоне юзера назначить имя, креды(creds) и актора этой новой персоны, а новую "осиротевшую" 
-персону удалить.
-Далее, если этот же юзер будет заходить с других акторов:
-- других бирж, но с тем же именем: это та же персона нужно так же смерджить новую персону нового актора с существующей.
-- с другим именем: значит это уже другая персона, и существующая персона(ы) уже "занята" существующим(и) актором(ами), 
-тогда уже не надо мержить новую персону нового актора, оставляем новую.
+Персона актора — только из Python по ключу `note = "{ex_id}:{exid}"`, замаскированный мейкер без персоны;
+слияние — `Person.merge` / `Actor.set_user` (D-16).
 
 ### Payment Methods
 `PmGroup` -> `Pm` -> `PmCur` <- `Cur`, `PmEx` <- `Ex`, `PmExBank`
@@ -88,12 +74,12 @@ actor.set_user(username_id):
 ### Conditions (Ad parsing)
 `Cond` -> `CondParsed`, `Synonym`, `CondSim`, `CondPrompt`
 
-- `Cond.raw_txt` = original ad conditions text (4095 chars max, unique)
+- `Cond.raw_txt` = текст условия (до 4095); условие — одной стороны, без объяв не живёт (D-18)
 - `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.upsert(cond_id, bank_ids=None, **fields)` (бот-разметка /cond и разбор нейронками, D-19); ответ админа
   на «сохранить разбор?» — эмиттер `CondParsed.answer(cond_id, remark=None)` → pg-канал `cond_ai_answer`
   `[cond_id, remark]` (null — «да», текст — «нет» с замечанием, "" — «нет», замечание пишется, true — «🔄»: объяву
   условия заново с биржи — реальный exid замаскированного мейкера + свежий `raw_txt`, затем вопрос заново); возвращает, слушает

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

@@ -404,12 +404,9 @@ class Person(Model, TsTrait):
     status: PersonStatus = IntEnumField(PersonStatus, db_default=PersonStatus.DEFAULT)
     name: str | None = CharField(127, null=True)
     # bootstrap-персона (создана от актора) несёт note = "{ex_id}:{exid}" её актора-источника —
-    # уникальный ключ, по которому её резолвят Ex.person_save и Agent.upsert (D-035, single-writer).
+    # уникальный ключ, по которому её резолвят Ex.person_save и Agent.upsert (D-16).
     note: str | None = CharField(255, null=True)
-    # Уникальность на уровне БД (migration 0010_person_note_unique, D-035):
-    #   UNIQUE(note) WHERE note IS NOT NULL           — bootstrap-персона уникальна по своему актору;
-    #   UNIQUE NULLS NOT DISTINCT (name, user_id, note) — тёзки живут лишь при разных user_id / note
-    #                                                     (двух (name, NULL, NULL) быть не может).
+    # Уникальность в БД — пока только unique(name, user, note); UNIQUE(note) — в decisions.md `## Pending`.
     user: ForeignKeyNullableRelation[User] = ForeignKeyField("models.User", "persons", on_update=CASCADE, null=True)
     user_id: int | None
     creds: BackwardFKRelation[Cred]
@@ -1087,7 +1084,7 @@ class Forum(Model, TsTrait):
 
 class Actor(Model):
     # реальные id бирж влезают в uint8; >= MASKED — id, замаскированный биржей (Bybit userMaskId, 128 бит):
-    # публичный листинг объяв прячет мейкера, реальный exid добудем отдельно (D-042)
+    # публичный листинг объяв прячет мейкера, реальный exid добудем отдельно (D-16)
     MASKED: ClassVar[int] = 1 << 64
     exid: int = UInt16Field()
     name: str = CharField(63)
@@ -1269,7 +1266,7 @@ class Agent(Model, TsTrait):
 
         Bootstrap-персону нового актора резолвим
         ПО `note` (`"{ex_id}:{exid}"`, уникальному по актору) — тем же ключом, что клиентский
-        `Ex.person_save`, чтобы у Person был ОДИН путь создания (D-035). По НЕуникальному `name` НЕ
+        `Ex.person_save`, чтобы у Person был ОДИН путь создания (D-16). По НЕуникальному `name` НЕ
         ищем: именно `get_or_none(name=rname)` ронял прод `MultipleObjectsReturned` на тёзках без юзера.
 
         Если note не нашёлся (актор впервые) — пробуем gmail-автолинк: замаскированная биржей почта,
@@ -2128,7 +2125,7 @@ class CredEx(Model):
     async def remove(cls, *, cred_id: int, ex_id: int) -> bool:
         """ЕДИНСТВЕННЫЙ standalone-делитор CredEx (single-writer-правило): сносит строку (cred, ex).
         Снятие креда с ОДНОЙ биржи из формы — удаление на бирже реактивно: BEFORE/AFTER-DELETE триггер
-        `credex_del` (миграция 0005) положит `[person_id, ex_id, exid]` в `credexs_del` → handler вызовет
+        `credex_del` (0002_triggers) положит `[person_id, ex_id, exid]` в `credexs_del` → handler вызовет
         `acl.cred_del(exid)`. Каскадное удаление при сносе самого Cred идёт другим путём (`creds_del`)."""
         return bool(await cls.filter(cred_id=cred_id, ex_id=ex_id).delete())
 
@@ -2136,7 +2133,7 @@ class CredEx(Model):
     async def orphan_del(cls, *, person_id: int, ex_id: int, exid: int) -> None:
         """Удалить ОСИРОТЕВШИЙ exid на бирже — после согласия владельца (web-контроллер / бот-колбэк).
         Перезапись exid у строки (cred, ex) на другой оставляет старый реквизит висеть на бирже дубликатом;
-        BEFORE-UPDATE триггер `credex_orphan` (миграция 0006) ловит это и шлёт `credexs_orphan` → handler
+        BEFORE-UPDATE триггер `credex_orphan` (0002_triggers) ловит это и шлёт `credexs_orphan` → handler
         спрашивает владельца. На «да» зовут СЮДА: свой канал `credexs_orphan_del` (НЕ переиспользуем
         `credexs_del`) — его handler `credex_orphan_del` делает `acl.cred_del(exid)` по (person, ex) И
         возвращает владельцу результат (успех/ошибка) тем же Notify; у обычного `credex_del` отчёта нет,
@@ -2227,7 +2224,7 @@ class Bin(Model):
     @classmethod
     async def for_card(cls, digits: str) -> Bin:
         """Найти BIN для номера карты. BIN бывает 6- или 8-значным, заранее не знаем — пробуем ОБА
-        префикса в НАШЕЙ таблице (засеяна из binlist/data, D-038) и берём более специфичный (8 > 6).
+        префикса в НАШЕЙ таблице (засеяна из binlist/data, D-17) и берём более специфичный (8 > 6).
         В binlist.net ходим ТОЛЬКО если не нашли у себя (`_fetch`, префикс 8 цифр)."""
         # префиксы разной длины не пересекаются как int (6-значный < 10^6 ≤ 8-значный), поэтому один
         # запрос prefix__in корректен; order_by(-length) отдаёт 8-значный, если он есть.

xync_db-0.5.5.dev64/.gitignore

@@ -1,48 +0,0 @@
-# Python
-__pycache__/
-*.py[cod]
-*.egg-info/
-.env
-.venv/
-venv/
-.pytest_cache/
-.mypy_cache/
-.ruff_cache/
-.coverage
-htmlcov/
-dist/
-build/
-*.log*
-
-# uv
-.uv-cache/
-
-# Node
-node_modules/
-packages/xync-coord/dist/
-packages/xync-coord/.vite/
-*.tsbuildinfo
-
-# Env
-.env
-.env.local
-
-# IDE
-.vscode/
-.idea/
-*.swp
-
-# OS
-.DS_Store
-Thumbs.db
-
-# Generated
-# packages/xync-coord/src/api/schema.gen.ts is regenerated by `npm run codegen`
-# (against the live API /schema/openapi.json), but stays tracked so `tsc -b`
-# and CI work without a running API.
-
-# Claude state (board) — track this in git, but ignore live edits if user prefers:
-# .claude/state/log.md   # uncomment to ignore the journal
-
-packages/xync-web
-packages/xync-chrome-ext

xync_db-0.5.5.dev64/src/xync_db/migrations/CLAUDE.md

@@ -1,129 +0,0 @@
-# migrations/ — Database Migrations (Tortoise native)
-
-Native Tortoise ORM migrations. Config: `xync_service.config.TORTOISE_ORM`
-(referenced from `packages/xync-db/pyproject.toml`).
-
-CLI (from `packages/xync-db/`): `uv run tortoise makemigrations` / `uv run tortoise migrate`
-(or `make makemigrations` / `make migrate` from the repo root).
-
-> **Консолидировано в 3 миграции (D-037).** Прежние 0001-0012 слиты в:
-> 1. **`0001_initial`** — ФИНАЛЬНАЯ схема всех таблиц (`ops.CreateModel`), включая всё, что раньше
->    доливали поздние миграции: `pair.scale`+`rate` INT (было 0011), `country.ccn3` (было `code`, 0012),
->    `updatestate` перестроен (0010), `net_addr.val` nullable + таблицы `coin_net`/`w3_send` (0009).
-> 2. **`0002_triggers`** — ВСЕ триггеры (база + credex_del/credex_orphan/agent_upd-auth/ad_exid_ex_uniq/
->    net_addr — были 0005-0009). `CREATE OR REPLACE` + порядок в `operations` дают финальную форму.
-> 3. **`0003_seed`** — весь засев (files + actor/tg/country/htx/net) в порядке зависимостей.
->
-> **Почему:** сид (0003) пишет через ORM (`set_pairs`→`pair.scale`) и должен идти по ПОЛНОЙ схеме;
-> когда колонку добавляла миграция ПОСЛЕ сида, fresh-migrate падал «column … does not exist». Правило:
-> **любое изменение схемы для засеваемой таблицы — в `0001`, а не в поздней миграции.**
-> Разделы ниже описывают ИСТОРИЧЕСКОЕ содержимое (для контекста) — оно теперь внутри этих трёх файлов.
-
-## models/0001_initial.py — Initial Schema
-
-Creates all ~50 tables. Key tables and their relationships:
-
-### Core Domain
-- **`user`** — Xync users. `username_id` → `username.id` (Telegram user). Has `pub/prv` (Ed25519 keys for XyncPay signing), `role` (bitmask: READER=4, WRITER=2, MANAGER=6, ADMIN=7), `status` (SLEEP=0, PAY=1, ACTIVE=2)
-- **`person`** — Identity abstraction. A user has 1+ persons. `status`: VIP=2, DEFAULT=1, ANONYMOUS=0, USER_DEF=-1, BLOCKED=-2
-- **`actor`** — Exchange account. Links `person` to `ex` (exchange). Unique per (ex_id, exid). `exid` = external user id on exchange
-- **`agent`** — Automated trading agent. 1:1 with `actor`. Has `auth` (exchange session JSON), `expire_at` (session TTL), `status` (bitmask, bit 1 = listening)
-
-### Trading
-- **`ad`** — P2P advertisement. Belongs to `maker` (actor), `pair_side` (coin/cur + buy/sell direction). Price/amount stored as integers (scaled)
-- **`my_ad`** — Our managed ad (extends `ad` with target_place, shared_at)
-- **`order`** — P2P order. Links `ad`, `taker` (actor), `cred` (payment credential), optional `hot` (hot session). Status: created=1, paid=2, completed=3, canceled=4, appealed_by_seller=5, appealed_by_buyer=6, appeal_disputed=7
-- **`cred`** — Payment credential (bank account/wallet). `detail` = account number, `ovr_pm_id` = override PM (0 = XyncPay hot cred). Unique per (person, pmcur, ovr_pm_id)
-
-### XyncPay
-- **`transaction`** — XyncPay transfers. UUID id generated by PG function from packed fields. `status`: request=0, signed=1, verified=2. `proof` = Ed25519 signature
-- **`hot`** — Hot swap session. `status`: closed=0, opened=1. Belongs to user
-- **`topup`** — Fiat topup to XyncPay balance via external PM
-
-### Reference Data
-- **`ex`** — Exchanges (Bybit=4, HTX=9, etc). `typ`: p2p=1, cex=2, main=3, dex=4, tg=5. `status`: plan=0, parted=1, full=2
-- **`coin`** — Cryptocurrencies with `scale` (decimal places) and `rate` (to base currency)
-- **`cur`** — Fiat currencies with `scale` and `rate`
-- **`pm`** — Payment methods. `norm` = normalized name, `typ`: bank=0, emoney=1, cash=2, gift_card=3, card=4, IFSC=5, SBP=6, phone=7
-- **`pair`/`pair_side`** — Trading pairs (coin+cur) and their buy/sell sides
-- **`coinex`/`curex`/`pmex`** — Exchange-specific mappings for coins, currencies, payment methods
-
-### Telegram Integration
-- **`username`** — Telegram users (id = tg_id)
-- **`session`** — Pyrogram sessions for userbot
-- **`peer`** — Cached Telegram peers (access_hash)
-- **`forum`** — Telegram forum groups per user
-- **`dc`** — Telegram data centers
-- **`app`** — Telegram API applications
-
-### Other
-- **`race`/`race_stat`** — Ad price competition automation
-- **`cond`/`cond_parsed`/`synonym`** — P2P ad condition text parsing and analysis
-- **`fiat`** — Fiat balance per credential
-- **`asset`** — Crypto balance per addr (coin+actor) per `typ`; owner via `addr.actor` (no `agent_id`)
-- **`transfer`** — Fiat transfer proof for orders
-- **`msg`** — Order chat messages
-
-## models/0002_triggers.py — PG Triggers and Functions
-
-### Entity Triggers
-- **`actor_new()`** BEFORE INSERT — auto-creates anonymous `person` if actor has no person_id
-- **`user_new()`** AFTER INSERT — auto-creates `person` + `actor` (ex_id=0 = Xync) for new user, notifies `after_users_new`
-- **`order_new()`** AFTER INSERT — routes to `hot_order_new` (if hot_id set) or `after_orders_new`
-- **`order_upd()`** AFTER UPDATE — routes status changes to `hot_order_new` (hot_id just set), `hot_order_upd_status` (hot status change), or `after_orders_upd_status` (non-hot status change). Payload: `[row_json, old_status]`
-- **`agent_upd()`** AFTER UPDATE — notifies `agents_upd_status` on status change. Payload: `[row_json, old_status]`
-
-### Transaction Functions
-- **`_user_balance(uid, cid)`** — SQL function: calculates XyncPay balance as `SUM(received) - SUM(sent)` with status checks (verified for received, signed+ for sent)
-- **`_tx_pack(status, ts, cur_id, receiver_id, amount, sender_id)`** — Generates deterministic UUID from transaction fields: `(type << 30 | ts-epoch) || cur_id[1B] || receiver[3B] || amount[5B] || sender[3B]`
-- **`tx_before()`** BEFORE INSERT/UPDATE:
-  - INSERT: generates id if null, checks sender balance (rejects if insufficient)
-  - UPDATE: validates that packed fields haven't changed (id must still match generated)
-- **`tx_after()`** AFTER INSERT/UPDATE — notifies `tx_verified` when status becomes 2 (verified)
-- **`tx_no_delete()`** BEFORE DELETE — prevents transaction deletion entirely
-
-### Auto-generated Triggers
-- `plsql("cred", 2)` — generates AFTER INSERT trigger for `cred` table → `creds_new` channel
-- `plsql("msg", 2)` — generates AFTER INSERT trigger for `msg` table
-
-## models/0003_files_seed.py — File Seed
-
-Loads PM logo files from `seed/xync_files.sql` if < 100 files exist. These are Telegram file references stored as binary `ref` in the `file` table.
-
-## models/0004_all_seed.py — Full Seed
-
-Orchestrates the seed scripts in order:
-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`
-   (ISO 3166-1 numeric — the old `code`/phone column, renamed in 0012), clean `short` (cca2),
-   canonical `name`, real `cur` (creates the ~99 non-base `Cur`); `id` baked into the file so
-   existing countries keep theirs, meta-aggregates hold 201/202. Idempotent. (D-036)
-4. `b_htx_seed` — HTX-specific: currencies (CurEx), coins, pairs (via `xync_client.ExClient`).
-   No longer seeds countries — those moved to `a_country_seed`.
-
-> **PM-dependent seeding left the migration (D-017).** PMs aren't populated at migrate
-> time (they come from `set_pms`), so anything keyed off them moved to `packages/xync-script`
-> (`python -m xync_script`, run after `migrate` with `pyro` up):
-> - `b_htx_seed` dropped `set_pms` — it pulled `pyro_client` (FileClient) into xync-db, the
->   import cycle (xync-db ⇄ pyro-client) we removed.
-> - the former `c_ex_seed` (PM default-currency + bank groups) is now
->   `xync_script.seed.refine_pms`, run only when `set_pms` actually added new `Pm` rows.
->
-> **Rule:** never import `pyro_client` from a migration. (`b_htx_seed` still uses
-> `xync_client.ExClient` for currency/coin/pair seeding — accepted for now.)
-
-### Key Seed Data
-- 24 exchanges defined (Xync=0, Binance=1, Bybit=4, HTX=9, OKX=14, TgWallet=20...)
-- 53 fiat currencies with rates relative to RUB
-- 14 coins: XYNC(0), USDT(1), BTC(2), ETH(3), USDC(4), TON(5), SOL(6)...
-- Origin user: id=0, username=XyncPay, tg_id=7807393311
-- PM name normalizations (`pm_rep`): maps exchange-specific names to canonical forms (e.g. "Tinkoff" → "T-Bank", "ADVCash" → "Volet.com")
-
-## models/0005_ad_upd_full_row.py — ad_upd payload
-
-Replaces the `ad_upd()` trigger function: payload `[NEW.id, diff]` → `[row_to_json(NEW), diff]`
-(`diff` = `{field: [old, new]}`, channels `ads_upd`/`mads_upd`). The api handlers build the
-exchange push from the row state **at event time** instead of re-reading the (possibly already
-overwritten) row from the DB.