62 lines
3.0 KiB
Markdown
62 lines
3.0 KiB
Markdown
# Главный экран
|
||
Появляется после ввода команды /start
|
||
|
||
Текст сообщения: Официальное приветствие. Коротко описание что это бот для партнерки
|
||
|
||
Кнопки:
|
||
1. Мои ссылки — просмотр ваших партнерских ссылок с пагинацией
|
||
2. Промо материалы — переход по внешней ссылке
|
||
3. Партнерское соглашение — переход по внешней ссылке
|
||
4. Задать вопрос — всплывающее сообщение (функция не реализована)
|
||
5. Моя статистика — просмотр общей статистики и статистики по рефералам с пагинацией
|
||
6. Создать заявку на вывод средств — всплывающее сообщение (функция не реализована)
|
||
|
||
---
|
||
|
||
## Формат файлов данных
|
||
|
||
### partner-tg/my_links_mock_data.json
|
||
Массив объектов:
|
||
```
|
||
[
|
||
{
|
||
"link": "stores-apple.com?ref=<uuid>", // ссылка с уникальным идентификатором
|
||
"name": "Название ссылки" // описание/название ссылки
|
||
},
|
||
...
|
||
]
|
||
```
|
||
|
||
- `link` — уникальная партнерская ссылка
|
||
- `name` — описание/название ссылки
|
||
|
||
### partner-tg/my_ststs_mock_data.json
|
||
Объект:
|
||
```
|
||
{
|
||
"totalSales": int, // общее количество продаж
|
||
"totalIncome": float, // общий доход
|
||
"availableWithdrawal": float, // доступно к выводу
|
||
"refData": [ // список данных по рефералам
|
||
{
|
||
"name": str, // название реферальной ссылки
|
||
"sales": int, // количество продаж по ссылке
|
||
"income": float // доход по ссылке
|
||
},
|
||
...
|
||
]
|
||
}
|
||
```
|
||
|
||
- `totalSales` — общее количество продаж
|
||
- `totalIncome` — общий доход
|
||
- `availableWithdrawal` — сумма, доступная к выводу
|
||
- `refData` — массив статистики по каждой реферальной ссылке
|
||
|
||
---
|
||
|
||
## Основные функции бота
|
||
- Все экраны реализованы через редактирование исходного сообщения (edit_text), а не отправку новых сообщений.
|
||
- Для списков и таблиц реализована пагинация (по 10 элементов на страницу).
|
||
- Кнопки навигации и возврата всегда присутствуют на соответствующих экранах.
|
||
- Для не реализованных функций выводится всплывающее сообщение (show_alert). |