🚀 SmartSolTech

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

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

✨ Основные возможности

📱 Веб-платформа

• Современный адаптивный интерфейс на Bootstrap 5
• Система подачи заявок на услуги с QR-кодами
• Портфолио проектов и услуг
• Админ-панель для управления контентом

🤖 Telegram Bot Integration

• Автоматическое уведомление о новых заказах
• Подтверждение заявок через QR-коды
• Двусторонняя связь клиент-компания
• Real-time статусы заказов

🔧 DevOps & Автоматизация

• Docker контейнеризация
• CI/CD pipeline с Drone
• Автоматизированные скрипты развертывания
• Система резервного копирования

🚀 Быстрый старт

Требования

• Docker & Docker Compose
• Git
• Python 3.10+ (для разработки)

Запуск проекта

# Клонирование репозитория
git clone https://github.com/smartsoltech/smartsoltech.kr.git
cd smartsoltech.kr

# Запуск всех сервисов
./start

# Создание суперпользователя (опционально)
./cli createsuperuser

# Проверка статуса
./cli status

Сайт будет доступен по адресу: http://localhost:8000

Основные команды

.utils/cli shell          # Django shell
./cli migrate         # Применить миграции
./update             # Полное обновление проекта
./stop               # Остановка сервисов
./logs               # Просмотр логов

📚 Документация

Документ	Описание
🛠️ Управление скриптами	Полное руководство по всем скриптам управления
🔧 Настройка бэкапа	Настройка системы резервного копирования
📝 История изменений	Подробная история разработки
🚀 Развертывание	Руководство по развертыванию в продакшн
🤖 API документация	Документация REST API

🏗️ Архитектура проекта

smartsoltech.kr/
├── 📄 README.md                 # Основная документация
├── 📜 LICENSE                   # Лицензия MIT
├── 🔧 .drone.yml               # CI/CD pipeline конфигурация
├── 📋 .gitignore               # Git исключения
├── 🐳 Контейнеризация
│   ├── Dockerfile              # Docker образ
│   ├── docker-compose.yml      # Оркестрация сервисов
│   └── requirements.txt        # Python зависимости
├── 🛠️ bin/                     # Скрипты управления
│   ├── cli.sh                  # CLI для контейнера
│   ├── update.sh               # Скрипт обновления
│   ├── start.sh, stop.sh       # Управление сервисами
│   ├── logs.sh                 # Просмотр логов
│   └── setup-backup.sh         # Настройка backup
├── 📚 docs/                    # Документация
│   ├── SCRIPTS_README.md       # Руководство по скриптам
│   ├── DEPLOYMENT.md           # Развертывание в продакшн
│   ├── API.md                  # API документация
│   └── *.md                    # Другая документация
├── 🐍 smartsoltech/            # Django приложение
│   ├── web/                    # Основное веб-приложение
│   ├── comunication/           # Telegram bot & уведомления
│   ├── static/                 # Статические файлы
│   ├── media/                  # Загруженные файлы
│   └── manage.py               # Django управление
├── 🎨 frontend/                # Фронтенд ресурсы
│   ├── assets/                 # CSS, JS, изображения
│   └── *.html                  # HTML шаблоны
├── 🔧 patch/                   # Патчи и временные файлы
└── 🔗 Корневые утилиты         # cli, update, start, stop, logs

🔧 Разработка

Локальная разработка

# Активация виртуального окружения
source .venv/bin/activate

# Установка зависимостей
pip install -r requirements.txt

# Запуск в режиме разработки
./cli runserver

Работа с базой данных

# Подключение к БД
./cli dbshell

# Создание миграций
./cli makemigrations

# Применение миграций
./cli migrate

Управление контейнерами

# Пересборка контейнеров
./stop --clean && ./update

# Логи конкретного сервиса
./logs web
./logs db

# Вход в контейнер
./cli bash

🌐 Продакшн развертывание

Настройка сервера

# Полное обновление с резервным репозиторием
./update origin backup

# Настройка backup репозитория
./bin/setup-backup.sh

# Проверка статуса продакшн сервисов
./cli status

📂 Структура проекта

smartsoltech/
├── 🐍 smartsoltech/          # Основное Django приложение
├── 🎨 frontend/              # Статические фронтенд файлы  
├── 🐳 bin/                   # Скрипты развертывания
├── 📋 docs/                  # Документация проекта
├── 🧩 patch/                 # Патчи и исправления
├── 🛠️ utils/                 # Утилиты и инструменты
│   ├── start                 # Запуск проекта
│   ├── stop                  # Остановка сервисов
│   ├── update                # Обновление проекта
│   ├── cli                   # CLI интерфейс
│   ├── logs                  # Просмотр логов
│   └── drone                 # CI/CD бинарий
├── 🐍 scripts/               # Вспомогательные скрипты
│   ├── create_hero_banner.py # Создание баннеров
│   └── hero_script.py        # Скрипты для баннеров
├── 💾 backups/               # Резервные копии
│   ├── .drone.yml.backup     # Бэкап CI конфигурации
│   └── original_home_modern.html # Оригинал главной страницы
├── 🗂️ temp/                  # Временные файлы
├── 🐳 docker-compose.yml     # Docker конфигурация
├── 🚀 .drone.yml             # CI/CD конфигурация  
├── 📄 requirements.txt       # Python зависимости
└── 📖 README.md              # Этот файл

Мониторинг

• Веб-сайт: http://localhost:8000
• Админ-панель: http://localhost:8000/admin
• PgAdmin: http://localhost:8080
• Drone CI: https://drone.smartsoltech.kr

🤝 Участие в разработке

1. Fork репозитория
2. Создайте feature ветку: git checkout -b feature/amazing-feature
3. Commit изменения: git commit -m 'Add amazing feature'
4. Push в ветку: git push origin feature/amazing-feature
5. Создайте Pull Request

📝 Лицензия

Этот проект распространяется под лицензией MIT. Подробности в файле LICENSE.

📞 Контакты

• Сайт: smartsoltech.kr
• Email: info@smartsoltech.kr
• Telegram: @smartsoltech

---

Сделано с ❤️ командой SmartSolTech