MSBGROUP · Workforce platform

MSB Activity.

Система управления сотрудниками, задачами, рабочим временем, ежедневными отчётами и Telegram-уведомлениями. Веб-интерфейс и Android-приложение работают через один FastAPI-сервер и одну базу данных.

FastAPIJWTHTTP-only cookiesAndroid WebViewTelegram BotAI
msbactivity/architecture
ClientBrowser / Android WebView
APIFastAPI server
StorageDatabase + uploads + reports
NotifyTelegram groups and bot
OptionalAI text enhancement
One backend

Сайт и Android-приложение используют одни аккаунты, задачи, отчёты, файлы и настройки.

Role check

Административные страницы защищены серверной проверкой роли.

Live updates

Интерфейс периодически запрашивает обновления и уведомления.

Production ready

Поддержка HTTPS, persistent volumes, секретов и резервного копирования.

Что это

Один сервер, одна база и одинаковые данные на всех устройствах.

Android-приложение не хранит отдельную базу и не реализует отдельную бизнес-логику. Оно открывает тот же интерфейс и отправляет запросы на тот же FastAPI-сервер.

2роли пользователей
24hJWT-сессия
10slive updates
1 APIединая бизнес-логика

Демо логики

Как это работает

Нажимайте кнопки слева — бот и команда ответят прямо в Telegram.

Группа «MSB Команда»
‹
👥
MSB Команда
12 участников, 4 онлайн
Чат с @MSBActivityBot
‹
🤖
MSB Activity Bot
онлайн

Роли

Администратор управляет процессом, сотрудник работает со своими задачами.

Права разделены в интерфейсе и дополнительно проверяются на сервере. Недостаточно просто открыть административный URL вручную.

Администратор

Создаёт сотрудников, графики, задачи, дедлайны, встречи, премии, замечания и Telegram-группы.

  • контроль статусов задач
  • рассмотрение опозданий и неявок
  • экспорт и архивные отчёты
  • управление регулярными задачами

Сотрудник

Отмечает рабочий день, принимает задачи, отправляет отчёты и связывает аккаунт с Telegram.

  • приход, обед, уход
  • статусы задач и проверка
  • запрос продления дедлайна
  • профиль, пароль, Telegram ID

Задачи

Полный жизненный цикл задачи: от назначения до принятия результата.

Администратор создаёт задачу, сотрудник принимает её в работу, отправляет на проверку, а администратор принимает или возвращает на доработку.

01

Новая задача

Администратор создаёт задачу: название, описание, исполнитель, приоритет, дедлайн, вложения и Telegram-группа.

02

В работе

Сотрудник принимает задачу и переводит её в работу.

03

На проверке

После выполнения сотрудник отправляет задачу на проверку.

04

Выполнена / На доработке

Администратор принимает задачу или возвращает её в работу с комментарием.

Рабочее время

Приход, уход, обед, опоздания, неявки и ежедневные отчёты.

График сотрудника используется для определения рабочих дней, опозданий и неявок. Все записи сохраняются в истории рабочего времени.

Посещаемость

Сотрудник отмечает приход и уход. Сервер сравнивает время с рабочим графиком.

  • отметка об опоздании
  • количество минут опоздания
  • статус опоздания

Обед

После прихода можно начать один обеденный перерыв в день. Интерфейс показывает обратный таймер.

  • длительность 1 час
  • напоминание за 5 минут
  • Telegram-уведомление

Ежедневный отчёт

Сотрудник фиксирует выполненную работу, прогресс по задачам, текущие задачи и сложности.

  • фильтр по сотруднику
  • периоды и сортировка
  • CSV и печать

Telegram и AI

Уведомления, группы, встречи, замечания и улучшение текстов через AI.

Telegram-интеграция опциональна, но закрывает важные уведомления: задачи, дедлайны, встречи, обед, опоздания, неявки, премии и замечания.

Telegram Bot

Сотрудник связывает Telegram с аккаунтом, а администратор управляет группами и темами.

  • новые задачи
  • дедлайны и просрочки
  • встречи и обед

AI-функции

При наличии DeepSeek API система улучшает формулировки задач, отчётов и распознанной речи.

  • POST /api/ai/enhance
  • до 10 000 символов
  • основные функции работают без AI

Голосовой ввод

Для текстовых полей доступно распознавание речи. Требуется HTTPS и разрешение микрофона.

  • русский
  • туркменский
  • английский

Android и Production

WebView-приложение работает с тем же сервером, что и браузер.

Первый запуск просит адрес сервера. Приложение хранит только адрес, cookies и настройки WebView. Все рабочие данные находятся на FastAPI-сервере.

Android-возможности

Authcookies, JavaScript, повторное подключение
Filesвыбор файлов, загрузка и Android Download Manager
UXкнопка «Назад», внешние ссылки, портрет/альбом
Securityзапрет игнорирования SSL-ошибок

Production-настройка

ServerLinux/VPS, Docker, Nginx или Caddy, HTTPS
Storagepersistent volumes для базы, uploads и employee_reports
Secretsсложный SECRET_KEY и пароль администратора
Backupбаза, файлы, .env, Telethon session, release keystore

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

Авторизация, роли, лимиты запросов и защита production-окружения.

Система использует bcrypt для паролей, проверку ролей и базовые защитные заголовки.

Auth

  • bcrypt password hash
  • HTTP-only cookies
  • logout удаляет cookie

Rate limits

  • /login — 5 запросов за 5 минут
  • /api — 60 запросов в минуту
  • остальное — 120 запросов в минуту

Data model

  • users, tasks, task_files
  • time_entries, lunch_breaks
  • daily_reports, meetings
  • bonuses, remarks, telegram_groups

Контакты

Готовы обсудить задачу?

Быстрая заявка

Оставьте контакт и короткое описание.

Ответим удобным способом и подскажем следующий шаг.

Написать в WhatsApp

Локация

Как нас найти.

M.E.R.Y.O.S.A.B Electronics

Откройте маршрут в Google Maps и выберите удобный способ добраться до точки.

Google MapsМаршрутЛичная встреча

Перед визитом

Лучше заранее написать: уточним задачу, наличие специалиста и удобное время.

WhatsAppУточнить времяБез ожидания