Техзадание МЛМ: различия между версиями

Текущая версия на 18:30, 14 ноября 2024

	Эта статья представляет собой концептуальные записки. Возможно, её удастся привести к виду, достойному энциклопедической статьи? См. Категория:Концептуальные записки для списка подобных статей.

Цель приложения

Разработать скрипт для распределения донатов за рекомендованных и интегрированных участников в Ассоциацию. Система основана на рекомендациях через Blockchain Social Network (BSN) и токенах MTLAP, которые используются для мотивации участников к привлечению и поддержке новых членов.

Сущности

Целевой счет — донатный счет для распределения средств по программе.
Рекомендатель — участник, установивший на своем аккаунте ключ RecommendToMTLA с значением счета Рекомендуемого. Должен иметь четвертый уровень участия в Ассоциации (4 токена MTLAP на счету).
Рекомендуемый — участник, которого установил в значение Рекомендатель с ключом RecommendToMTLA.

Основные функции и сценарии

1. Распределение донатов

Раз в месяц 1/3 собранных донатов с Целевого счета распределяется между Рекомендателями.
Вознаграждения распределяются между Рекомендателями пропорционально количеству полученных Рекомендуемым токенов MTLAP, только если их количество увеличилось с прошлого распределения.

2. Учет рекомендаций и работа с тегами

Если у нескольких Рекомендателей одни и те же Рекомендуемые, выводим в отчет конфликт и решаем его самостоятельно.
Исторически отозванные теги не учитываются в процессе распределения.
Рекомендатель ставит теги, но Рекомендуемый не интегрируется в Ассоциации, то ему можно отозвать 4-й токен MTLAP и исключить из системы решением Совета.

Технические требования

Приложение должно быть написано по Протоколу Гильдии программистов.
Параметры распределения должны быть вынесены в настройки.

Реализация

Целевое приложение будет состоять из двух компонентов: самого скрипта с алгоритмом и бота для управления.
Скрипт.
1. Запускается отдельно раз в месяц.
2. Проверяет дату последнего запуска и начинает расчет именно с нее.
3. Настройки алгоритма будут хранится в базе (все цифры).
4. После запуска записывается отчет и получившийся xdr в базу.
5. По результату бот может отправить нотификацию в любой чат.
6. Спрятать за настройку автоматическую отправку транзакции.
Бот.
1. Служит панелью управления скриптом.
2. Может показывать список отчетов, перезапускать их (например, с новыми настройками).
На будущее.
1. Данные по расчетам будут храниться в базе, поэтому можно разрабатывать рейтинги, аналитику, что угодно.
2. Через бота менять настройки скрипта. В MVP настройки будут предустановлены.
3. Переиспользовать основу (настройки, отчеты) для других расчетов со всеми фичами выше.

@@ Строка 1: / Строка 1: @@
+{{Концепт}}
 == Цель приложения ==
@@ Строка 13: / Строка 15: @@
 * Раз в месяц 1/3 собранных донатов с Целевого счета распределяется между Рекомендателями.
-* Вознаграждения делятся на две части:
+* Вознаграждения распределяются между Рекомендателями пропорционально количеству полученных Рекомендуемым токенов MTLAP, только если их количество увеличилось с прошлого распределения.
-** '''50%''' направляются на поддержку Рекомендуемых, которые в течении 30 дней после фиксирования рекомендации получили хотя бы один токен MTLAP.
-** '''50%''' распределяются между Рекомендателями пропорционально количеству полученных Рекомендуемыми токенов MTLAP (в какой пропорции? '''100% MTLAP рекомендуемых = 100% от суммы распределения, т.е. чем больше в МТЛА интегрированы рекомендуемые по токеномике, тем больше доля, прямая пропорция''').
 === 2. Учет рекомендаций и работа с тегами ===
-* Вознаграждение получает Рекомендатель, что раньше всех назначил Рекомендуемого.
+* Если у нескольких Рекомендателей одни и те же Рекомендуемые, выводим в отчет конфликт и решаем его самостоятельно.
 * Исторически отозванные теги не учитываются в процессе распределения.
-* Приложение должно содержать систему мониторинга для выявления и исключения злоупотреблений ('''не уверен что это нужно пытаться запихать сюда усложняя её, это достаточно поддерживать и чистить в ручном режиме, благо выборка небольшая''').
+* Рекомендатель ставит теги, но Рекомендуемый не интегрируется в Ассоциации, то ему можно отозвать 4-й токен MTLAP и исключить из системы решением Совета.
-* Рекомендатель раздаёт теги, но не занимается поддержкой новых членов (как определить? '''его члены стагнируют, оставаясь не верифицированными и не продвигаясь дальше по токеномике значимое время - тут политически определяться должно Советом, в разные моменты разная жёсткость требований должна быть, постепенно возрастая по мере развития системы и роста бюджета'''), то ему можно отозвать 4-й токен MTLAP и исключить из системы.
 == Технические требования ==
@@ Строка 28: / Строка 27: @@
 * Приложение должно быть написано по [https://github.com/Montelibero/MTLA-Documents/blob/main/External/ProgrammersGuild/ProgrammersGuildProtocol.ru.md Протоколу Гильдии программистов].
 * Параметры распределения должны быть вынесены в настройки.
+== Реализация ==
+# Целевое приложение будет состоять из двух компонентов: самого скрипта с алгоритмом и бота для управления.
+# Скрипт.
+## Запускается отдельно раз в месяц.
+## Проверяет дату последнего запуска и начинает расчет именно с нее.
+## Настройки алгоритма будут хранится в базе (все цифры).
+## После запуска записывается отчет и получившийся xdr в базу.
+## По результату бот может отправить нотификацию в любой чат.
+## Спрятать за настройку автоматическую отправку транзакции.
+# Бот.
+## Служит панелью управления скриптом.
+## Может показывать список отчетов, перезапускать их (например, с новыми настройками).
+# На будущее.
+## Данные по расчетам будут храниться в базе, поэтому можно разрабатывать рейтинги, аналитику, что угодно.
+## Через бота менять настройки скрипта. В MVP настройки будут предустановлены.
+## Переиспользовать основу (настройки, отчеты) для других расчетов со всеми фичами выше.