Союз женщин России: цифровой портал Балашихинского отделения

Портал Союза женщин России в Балашихе — рабочая civic-tech платформа для локального отделения общественной организации. Проект переводит путь участницы, администратора и партнера из ручных таблиц, бумажных заявлений и разрозненной переписки в единый цифровой контур: от первого знакомства с отделением до членства, событий, партнерских преимуществ и коммуникаций.

Что было сделано

• Публичный сайт с главной страницей, информацией об отделении, документами, проектами, новостями, событиями, контактами и формой сотрудничества.
• Электронная подача заявления на вступление с версиями согласий, проверкой контактных данных и адресными подсказками DaData.
• Личный раздел участницы: профиль, статус заявления и членства, регистрация на мероприятия, настройки уведомлений и подключение Telegram.
• Цифровой членский билет с постоянным номером формата СЖР-БАЛ-000001, QR-кодом и публичной проверкой без раскрытия телефона, email и адреса.
• Административный контур для заявлений, участниц, событий, посещаемости, новостей, страниц, проектов, партнеров и обращений о сотрудничестве.
• Telegram-бот с командами /login, /status, /card, /events, /news, /benefits и /chat.
• Email-очередь для восстановления доступа, подтверждения новой почты, анонсов событий и напоминаний.

Продуктовая логика

Важное решение проекта — не смешивать обычную регистрацию на сайте и юридически значимое членство в организации. Интерфейс различает гостя, зарегистрированную участницу, заявителя и принятого члена СЖР. Пользователь видит текущий статус и следующие шаги, а администратор обрабатывает заявление, фиксирует решение и активирует членство только после проверки.

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

Архитектура

Frontend построен на React 19, Next.js 16, TypeScript, Vinext, Vite и Tailwind CSS. Backend — модульный Node.js-сервис на node:http и pg, где PostgreSQL является источником истины. Доменные вертикали разделены на auth, membership, events, notifications, admin, content, collaboration и telegram.

Система разделяет публичные, пользовательские, административные и внутренние Telegram API. Frontend и Telegram-бот не обращаются к базе напрямую, а работают через backend. В production общий /api/* маршрутизируется через Traefik, а административные запросы проходят дополнительную проверку frontend-сессии и внутреннего токена.

Эксплуатация и безопасность

Проект поставляется как Docker Compose стек: frontend, backend, PostgreSQL, notification worker, Telegram bot, миграции и optional seed для локальной разработки. Staging и production публикуются через Traefik, образы собираются в GitHub Actions, публикуются в GHCR и разворачиваются immutable sha-<commit> тегами.

В MVP реализованы server-side пользовательские сессии, hash одноразовых токенов, PostgreSQL-backed rate limiting, JSON-логи с request ID, readiness checks, Prometheus metrics, backup перед деплоем и smoke-проверки окружений. Известные ограничения не маскируются: персональный RBAC администраторов, полная история решений о членстве, медиатека, ревизии контента и внешнее хранение backup вынесены в следующий технический этап.

Качество поставки

В репозитории поддерживаются актуальные документы по архитектуре, API, локальной разработке, тестированию, безопасности, деплою, мониторингу, backup и release readiness. Current и future OpenAPI спецификации разделены, текущие endpoints сверяются с route handlers, а generated TypeScript-типы обновляются в CI.

Проверки включают lint, render-тесты frontend, backend unit и contract tests, тесты Telegram-бота, coverage thresholds, Docker Compose validation и Docker integration smoke. Это делает проект не просто витриной, а сопровождаемым MVP, который можно развивать после первого публичного запуска.

Ценность

Платформа снижает ручную нагрузку на отделение и делает путь участницы прозрачным: подать заявление, понять статус, получить билет, зарегистрироваться на событие и воспользоваться преимуществами можно из одного цифрового контура. Администраторы получают управляемый реестр и рабочие процессы, партнеры — официальный канал предложений, а организация — основу для масштабирования цифровой инфраструктуры на следующие отделения и новые сценарии.