http://digida.mgpu.ru/index.php?action=history&feed=atom&title=%D0%A1%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%B0_RarePayСистема RarePay - История изменений2026-04-22T12:08:45ZИстория изменений этой страницы в викиMediaWiki 1.44.0http://digida.mgpu.ru/index.php?title=%D0%A1%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%B0_RarePay&diff=46235&oldid=prevPatarakin: Новая страница: «== Определение функциональных требований == Перед разработкой системы RarePay была проведена аналитика внутренних процессов бренда RARE MOD, направленная на выявление узких мест в обработке расходов сотрудников. Основной проблемой являлось отсутствие центр...»2026-04-15T07:24:09Z<p>Новая страница: «== Определение функциональных требований == Перед разработкой системы RarePay была проведена аналитика внутренних процессов бренда RARE MOD, направленная на выявление узких мест в обработке расходов сотрудников. Основной проблемой являлось отсутствие центр...»</p>
<p><b>Новая страница</b></p><div>== Определение функциональных требований ==<br />
Перед разработкой системы RarePay была проведена аналитика внутренних процессов бренда RARE MOD, направленная на выявление узких мест в обработке расходов сотрудников. Основной проблемой являлось отсутствие централизованного и прозрачного механизма подачи заявок и контроля оплат.<br />
Целью проекта стало создание автоматизированного чат-бота, который упрощает процесс подачи заявок, снижает нагрузку на бухгалтерию и формирует прозрачную систему учета расходов.<br />
Ключевая идея проекта:<br />
Создать единый канал взаимодействия между сотрудником и бухгалтерией, объединяющий создание заявки, учет данных и подтверждение оплаты.<br />
<br />
'''Функциональные требования:'''<br />
Создание заявки на оплату через чат-бот<br />
Пошаговое заполнение данных (сумма, назначение, категория)<br />
Автоматическая запись данных в Google Sheets<br />
Отправка заявки бухгалтеру в отдельный чат<br />
Уведомление пользователя о статусе заявки<br />
Обработка статусов (ожидание / одобрено / оплачено / отклонено)<br />
История заявок пользователя<br />
Валидация вводимых данных<br />
<br />
'''Нефункциональные требования:'''<br />
Высокая скорость обработки запросов<br />
Надежность доставки сообщений<br />
Защита данных сотрудников<br />
Масштабируемость под рост команды<br />
Простота использования (минимум действий)<br />
Таким образом, RarePay выступает как инструмент оптимизации внутренних процессов, а не просто чат-бот.<br />
<br />
== Получение API и конфигурация проекта ==<br />
Для работы системы используются внешние сервисы и API:<br />
Telegram Bot API — взаимодействие с пользователем<br />
Google Sheets API — хранение данных<br />
(опционально) webhook-сервер для обработки событий<br />
<br />
'''Процесс настройки:'''<br />
Создание бота через @BotFather<br />
Получение токена Telegram<br />
Подключение Google Cloud и Sheets API<br />
Настройка таблицы для учета<br />
Конфигурация backend<br />
<br />
'''Пример .env:'''<br />
TELEGRAM_BOT_TOKEN="your_token"<br />
GOOGLE_SHEETS_CREDENTIALS="path_to_json"<br />
SPREADSHEET_ID="your_sheet_id"<br />
ACCOUNTING_CHAT_ID="chat_id"<br />
Использование переменных окружения позволяет обеспечить безопасность и изолировать чувствительные данные.<br />
<br />
== Архитектурное проектирование системы ==<br />
Система построена по принципу event-driven архитектуры с разделением логики.<br />
{{#mermaid:<br />
flowchart LR<br />
A[User Telegram] --> B[Bot]<br />
B --> C[Backend]<br />
C --> D[Google Sheets]<br />
C --> E[Accounting Chat]<br />
}}<br />
'''Компоненты:'''<br />
Bot Layer — обработка сообщений пользователя<br />
Backend — логика заявок<br />
Data Layer — Google Sheets<br />
Notification Layer — отправка уведомлений<br />
Такой подход позволяет легко масштабировать систему и добавлять новые функции.<br />
== Общая схема работы системы ==<br />
{{#mermaid:<br />
flowchart TB<br />
A[User] --> B[Bot]<br />
B --> C[Form Input]<br />
C --> D[Backend]<br />
D --> E[Save to Sheets]<br />
D --> F[Send to Accountant]<br />
F --> G[Approve/Pay]<br />
G --> H[Notify User]<br />
}}<br />
'''Описание процесса:'''<br />
Пользователь создает заявку<br />
Бот собирает данные<br />
Данные записываются в таблицу<br />
Заявка отправляется бухгалтеру<br />
После оплаты приходит уведомление<br />
== Детализация backend-логики ==<br />
Backend реализует бизнес-логику и управление состояниями заявок.<br />
{{#mermaid:<br />
flowchart TB<br />
A[Message] --> B[Handler]<br />
B --> C[Validation]<br />
C --> D[Create Request]<br />
D --> E[Save]<br />
E --> F[Notify]<br />
}}<br />
'''Ключевые функции:'''<br />
Обработка команд (/start, /new, /status)<br />
Валидация данных<br />
Генерация ID заявки<br />
Работа со статусами<br />
Логирование<br />
== Управление состоянием пользователя ==<br />
Каждый пользователь проходит сценарий (state machine):<br />
{{#mermaid:<br />
flowchart TB<br />
A[Start] --> B[Enter Amount]<br />
B --> C[Enter Description]<br />
C --> D[Confirm]<br />
D --> E[Submit]<br />
}}<br />
Это позволяет избежать ошибок и сделать UX максимально понятным.<br />
== Работа с Google Sheets ==<br />
Google Sheets используется как простая и прозрачная база данных.<br />
<br />
'''Структура таблицы:'''<br />
ID заявки<br />
Имя сотрудника<br />
Сумма<br />
Назначение<br />
Дата<br />
Статус<br />
<br />
'''Преимущества:'''<br />
Простота<br />
Доступ для бухгалтера<br />
Быстрая интеграция<br />
Наглядная отчетность<br />
<br />
== Система уведомлений ==<br />
Система уведомлений обеспечивает двустороннюю связь:<br />
Пользователь → бухгалтер<br />
Бухгалтер → пользователь<br />
{{#mermaid:<br />
flowchart LR<br />
A[User Request] --> B[Accountant Chat]<br />
B --> C[Payment Done]<br />
C --> D[User Notification]<br />
}}<br />
== Обработка ошибок и отказоустойчивость ==<br />
Система предусматривает обработку следующих ситуаций:<br />
Некорректный ввод данных<br />
Потеря соединения<br />
Ошибки API<br />
Дублирование заявок<br />
<br />
'''Решения:'''<br />
Повторные запросы<br />
Валидация на каждом этапе<br />
Логирование ошибок<br />
Резервные уведомления<br />
<br />
== Безопасность системы ==<br />
В системе реализованы базовые меры безопасности:<br />
Ограничение доступа по user ID<br />
Защита API-ключей<br />
Логирование действий<br />
Проверка ролей (сотрудник / бухгалтер)<br />
== Роли пользователей ==<br />
Система разделяет пользователей:<br />
'''Сотрудник:'''<br />
Создает заявки<br />
Получает уведомления<br />
Просматривает статус<br />
'''Бухгалтер:'''<br />
Получает заявки<br />
Обрабатывает оплату<br />
Меняет статус<br />
== Масштабируемость и развитие ==<br />
Система может быть расширена:<br />
Добавление категорий расходов<br />
Аналитика расходов<br />
Дашборд для руководства<br />
Интеграция с CRM или 1С<br />
Автоматические лимиты<br />
== Пользовательский опыт (UX) ==<br />
Основной упор сделан на:<br />
Минимум действий<br />
Пошаговый сценарий<br />
Быстрый отклик<br />
Понятные сообщения<br />
<br />
Процесс создания заявки на оплату наглядно показан ниже:<br />
[[File:112.jpg|thumb|center|RarePay - Создание заявки через бота]]<br />
<br />
[[File:113.jpg|thumb|center|RarePay - Заявка создана]]<br />
<br />
== Заключение ==<br />
RarePay представляет собой полноценную систему автоматизации финансовых процессов внутри RARE MOD.<br />
В отличие от классических решений, система:<br />
упрощает взаимодействие<br />
снижает нагрузку на бухгалтерию<br />
делает процесс прозрачным<br />
ускоряет обработку заявок<br />
<br />
<br />
----<br />
[[Категория: Работа с API]]</div>Patarakin