Перенести документацию в docs и добавить социальный граф

2026-07-13 12:58:41 +04:00
parent c9cfb394d7
commit af12d7b954
91 changed files with 653 additions and 2 deletions
@@ -0,0 +1,20 @@
+# Promo-логины через продавцов в Solana
+
+- краткое описание:
+  - в `shine_users` добавлена поддержка PDA продавцов красивых логинов, promo-подписи `shine_promo_v1:<login>` и отдельная автономная страница `shine-UI/promo-code-generator.html` для генерации promo-кода через браузерный кошелёк или через ручной ввод Base58 seed 32 bytes;
+- что проверять:
+  - admin-транзакцией создать или обновить `promo_seller_pda`;
+  - сгенерировать promo-код на странице `promo-code-generator.html` в режиме wallet extension;
+  - сгенерировать promo-код на той же странице в режиме ручного Base58 seed;
+  - открыть HTML локально как отдельный файл без сервера и убедиться, что генерация в режиме Base58 seed продолжает работать;
+  - зарегистрировать короткий/premium логин по promo-коду;
+  - убедиться, что без promo-кода тот же логин не проходит `shine_login_guard`;
+  - убедиться, что после успешной регистрации `remaining_sales` уменьшается на 1;
+  - проверить отказ при исчерпанной квоте, неверной подписи и логине короче `min_login_length`;
+- ожидаемый результат:
+  - promo-регистрация проходит только при валидной подписи продавца и соблюдении лимитов;
+  - обычная регистрация без promo-кода продолжает работать как раньше;
+  - страница генерации выдаёт строку формата `1seller-signatureBase58` в обоих режимах;
+  - single-file HTML работает локально оффлайн минимум в режиме ручного Base58 seed;
+- статус:
+  - `pending`