Skip to content
Alexey Lars edited this page Dec 15, 2025 · 1 revision

🎯 Surway Wiki

Добро пожаловать в документацию проекта Surway — современного full-stack сервиса для создания и проведения опросов с множественным выбором.

📚 Содержание

Основное

  • Home — эта страница
  • Быстрый старт — начало работы с проектом
  • FAQ — часто задаваемые вопросы

Архитектура и дизайн

Разработка

  • Development Guide — гайд для разработчиков
  • Configuration — полное описание конфигурации
  • Testing — как писать и запускать тесты
  • Contributing — как контрибьютить в проект

Деплой и DevOps

  • Deployment — деплой в production
  • Docker Guide — работа с Docker и Docker Compose
  • Monitoring — мониторинг и логирование

🚀 Что такое Surway?

Surway — это микросервис для создания временных опросов с:

  • Множественным выбором — голосуйте за несколько вариантов
  • Автоматическим TTL — опросы удаляются по истечении срока
  • Real-time результатами — мгновенное обновление статистики
  • Современным UI — красивый интерфейс с анимациями
  • REST API — интеграция с любыми клиентами
  • Production-ready — готов к деплою с Docker и SSL

🏗️ Технологический стек

Backend

  • Go 1.24.2 + Gin framework
  • Redis 7 для хранения данных
  • Swagger для документации API
  • Структурированное логирование (slog)

Frontend

  • Next.js 15 + React 19
  • TypeScript 5
  • Tailwind CSS 4
  • Recharts для графиков
  • Framer Motion для анимаций

Infrastructure

  • Docker & Docker Compose
  • Caddy для reverse proxy и SSL
  • Redis для persistence

📖 С чего начать?

  1. Новичок в проекте? → Начните с Быстрого старта
  2. Хотите понять архитектуру? → Читайте Architecture
  3. Нужно настроить проект? → Смотрите Configuration
  4. Готовы к разработке? → Изучите Development Guide
  5. Деплоите в production? → Следуйте Deployment

🤝 Поддержка и контакты


📊 Статус проекта

🚀 Active Development — проект активно развивается

Последние обновления

  • ✅ REST API с Swagger
  • ✅ Frontend на Next.js 15
  • ✅ Docker Compose для dev и prod
  • ✅ Множественный выбор в опросах
  • ✅ Graceful shutdown
  • 🚧 WebSocket для live updates (в планах)
  • 🚧 Аутентификация (в планах)

Последнее обновление: December 2025