KLERK - Telegram Bot для управления финансами компаний

Описание проекта

Основной функционал

Для менеджеров:

• Управление счетами: создание и удаление счетов с поддержкой дробных значений

• Финансовые операции: внесение доходов/расходов с комментариями

• Отчетность: детализация операций по счетам и группам

• Сверка балансов: автоматическая проверка и корректировка расчетов

Для администраторов:

• Управление персоналом: прием и увольнение менеджеров

• Глобальные операции: сброс счетов, полная отчетность

• Настройка интерфейса: управление кнопками и командами

Для клиентов:

• Просмотр счетов: доступ к балансам группы

• Калькулятор: вычисление математических выражений

• Связь с менеджерами: возможность вызвать специалиста

Стек технологий

Backend

• PHP 8+: основной язык разработки

• PDO (PHP Data Objects): безопасная работа с MySQL базами данных

• cURL: HTTP-клиент для API взаимодействий

API и интеграции

• Telegram Bot API: полная интеграция с Telegram

• Собственный Database API: удаленный доступ к данным через REST-подобный интерфейс

• Webhook система: асинхронная обработка сообщений

База данных

• MySQL: хранение всех данных системы

• Транзакционная модель: обеспечение целостности данных

• Опциональное кэширование: Memcached для повышения производительности

Форматы данных

• JSON: обмен данными между компонентами

• UTF-8: поддержка кириллицы и международных символов

Frontend (для отчетов)

• HTML5/CSS3: современная верстка отчетов

• JavaScript: интерактивные элементы

• Responsive design: адаптивность под разные устройства

Архитектура

1. Database класс - абстракция работы с БД через API

1. Model класс - бизнес-логика и обработка команд

1. Webhook обработчики - прием и отправка сообщений Telegram

Безопасность

• API-ключи: авторизация запросов

• Валидация данных: защита от некорректного ввода

• SSL/TLS: шифрование передаваемых данных

• Ролевая модель: разные права доступа для пользователей

Особенности реализации

• Математический парсер: поддержка сложных выражений

• Форматирование сумм: правильное отображение валют с дробями

• Транзакции: атомарность операций для предотвращения ошибок

• Кэширование экземпляров: оптимизация производительности