Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

Repository files navigation

Mini CMS Aggregator — Портфолио проект

📋 Обзор проекта

Mini CMS Aggregator — это легковесная CMS для создания агрегаторов промокодов, рейтингов и статей с современным Dark Mode дизайном.

Параметр Значение
Тип Веб-приложение (CMS)
Стек PHP 8.2, MySQL, Tailwind CSS
Архитектура MVC (собственная реализация)
Назначение Агрегатор промокодов и рейтингов
Статус ✅ Готов к продакшену

🎯 Цель проекта

Разработка универсальной CMS для быстрого развёртывания сайтов-агрегаторов с:

  • Каталогами сервисов с рейтингами
  • Системой промокодов и скидок
  • Блогом со статьями
  • Встроенной админ-панелью
  • SEO-оптимизацией из коробки

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

Backend

PHP 8.2
├── Собственный MVC фреймворк
├── PDO для работы с БД
├── Автзагрузка классов (SPL)
└── Роутинг на основе URI

Database

MySQL 5.7+ / MariaDB 10.3+
├── Таблицы: users, items, articles, settings, seo_pages, item_votes
├── Индексы для оптимизации
└── Демонстрационные данные

Frontend

Tailwind CSS 3.x
├── Dark Mode дизайн (#0d0d0d, #1a1a1a, #ff4500)
├── Адаптивная вёрстка (mobile-first)
├── Компоненты: карточки, сайдбары, формы
└── AJAX голосования без перезагрузки

DevOps

Docker & Docker Compose
├── MariaDB 10.11
├── PHP 8.2 Apache
├── Adminer для управления БД
└── Готовая конфигурация для хостинга

🏗️ Архитектура приложения

┌─────────────────────────────────────────────────────────┐
│                     Frontend (Tailwind)                  │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────┐  │
│  │   Главная   │  │  Промокоды  │  │    Статьи       │  │
│  │  (Рейтинг)  │  │   Freebie   │  │    Блог         │  │
│  └─────────────┘  └─────────────┘  └─────────────────┘  │
└─────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────┐
│                    Router (index.php)                    │
│         Маршрутизация по URI / ЧПУ поддержка            │
└─────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────┐
│                   Контроллеры (MVC)                      │
│  ┌──────────────┐ ┌──────────────┐ ┌─────────────────┐  │
│  │ CategoryCtrl │ │  ArticleCtrl │ │    AdminCtrl    │  │
│  └──────────────┘ └──────────────┘ └─────────────────┘  │
│  ┌──────────────┐ ┌──────────────┐ ┌─────────────────┐  │
│  │   ItemCtrl   │ │   VoteCtrl   │ │    ErrorCtrl    │  │
│  └──────────────┘ └──────────────┘ └─────────────────┘  │
└─────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────┐
│                      Модели (ORM-lite)                   │
│  ┌──────────────┐ ┌──────────────┐ ┌─────────────────┐  │
│  │    Item      │ │   Article    │ │      User       │  │
│  └──────────────┘ └──────────────┘ └─────────────────┘  │
│  ┌──────────────┐ ┌──────────────┐ ┌─────────────────┐  │
│  │   Setting    │ │   SeoPage    │ │   ItemVotes     │  │
│  └──────────────┘ └──────────────┘ └─────────────────┘  │
└─────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────┐
│                    MySQL Database                        │
│              (MyISAM, utf8mb4, индексы)                 │
└─────────────────────────────────────────────────────────┘

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

www/
├── docker-compose.yml          # Docker конфигурация
├── INSTALL_HOSTING.md          # Гайд по установке на хостинг
├── PORTFOLIO.md                # Этот файл
│
├── web/
│   ├── index.php               # Точка входа, роутинг
│   ├── admin.php               # Админ-панель
│   ├── vote.php                # AJAX обработчик голосов
│   ├── .htaccess               # Apache mod_rewrite правила
│   │
│   ├── config/
│   │   └── config.php          # Конфигурация приложения
│   │
│   ├── core/                   # Ядро фреймворка
│   │   ├── Config.php          # Загрузчик конфигурации
│   │   ├── Controller.php      # Базовый контроллер
│   │   ├── Model.php           # Базовая модель
│   │   ├── Router.php          # Роутер (опционально)
│   │   └── Template.php        # Шаблонизатор
│   │
│   ├── models/                 # Модели данных
│   │   ├── Item.php            # Элементы каталога
│   │   ├── Article.php         # Статьи
│   │   ├── User.php            # Пользователи
│   │   ├── Setting.php         # Настройки
│   │   ├── SeoPage.php         # SEO страницы
│   │   └── ItemVotes.php       # Голоса
│   │
│   ├── controllers/            # Контроллеры
│   │   ├── CategoryController.php
│   │   ├── ArticleController.php
│   │   ├── ItemController.php
│   │   ├── AdminController.php
│   │   ├── VoteController.php
│   │   └── ErrorController.php
│   │
│   ├── templates/
│   │   ├── layouts/            # Layouts (main, admin, article)
│   │   ├── pages/              # Страницы (category)
│   │   └── admin/              # Админ-панель
│   │
│   ├── public/                 # Публичные файлы
│   ├── cache/                  # Кэш шаблонов
│   └── sql/                    # SQL схема и дампы

✨ Ключевые особенности

Фронтенд

  • ✅ Dark Mode дизайн — цветовая схема #0d0d0d / #1a1a1a / #ff4500
  • ✅ Tailwind CSS — утилитарные классы для быстрой разработки
  • ✅ Адаптивность — mobile-first подход
  • ✅ Динамические сайдбары — баннеры слева/справа
  • ✅ Копирование промокодов — в 1 клик
  • ✅ Голосование — AJAX с защитой от накрутки (по IP)

Backend

  • ✅ Собственный MVC — легковесный фреймворк без зависимостей
  • ✅ ЧПУ (SEO URLs) — /rating, /promocodes, /articles, /item/{slug}
  • ✅ Автозагрузка классов — SPL autoload_register
  • ✅ Конфигурация — централизованное управление настройками
  • ✅ Шаблонизатор — кэширование представлений

Админ-панель

  • ✅ Безопасная авторизация — хеширование паролей (bcrypt)
  • ✅ Dashboard — статистика по элементам, статьям, просмотрам
  • ✅ CRUD элементов — сайты, промокоды, категории
  • ✅ Управление статьями — блог с SEO полями
  • ✅ Менеджер баннеров — HTML/JS/iframe
  • ✅ SEO менеджер — мета-теги для всех страниц
  • ✅ Настройки сайта — Telegram, Email, Footer

База данных

  • ✅ Нормализованная схема — 6 таблиц с индексами
  • ✅ Защита от накрутки — таблица item_votes с IP
  • ✅ SEO страницы — отдельные H1-H3, meta title/description
  • ✅ Настройки — ключ-значение для гибкости
  • ✅ Демо данные — готовый контент для старта

🔍 Реализованные функции

Публичная часть

Функция Описание
Главная страница Рейтинг лучших сервисов
Каталог промокодов Список с копированием в 1 клик
Freebie раздел Бесплатные предложения
Блог Список статей + страница статьи
Голосование 5-звёздочный рейтинг + защита
SEO страницы Уникальные заголовки и мета-теги

Админ-панель

Функция Описание
Dashboard Статистика, быстрые действия
Элементы CRUD, сортировка, категории
Статьи Редактор, SEO поля, публикации
Баннеры Левый/правый сайдбар, HTML/JS
SEO страниц H1-H3, title, description, keywords
Настройки Контакты, футер, логотип

🎨 Дизайн-система

Цветовая палитра

--bg-primary: #0d0d0d;      /* Основной фон */
--bg-card: #1a1a1a;         /* Фон карточек */
--bg-border: #2a2a2a;       /* Границы */
--primary: #ff4500;         /* Акцент (оранжевый) */
--accent: #00ff00;          /* Успех (зелёный) */
--text-main: #ffffff;       /* Текст */
--text-muted: #a0a0a0;      /* Вторичный текст */

Компоненты

  • Site Card — логотип, название, рейтинг, промокод, кнопка
  • Promo Code — кнопка копирования с анимацией
  • Rating Stars — интерактивные звёзды голосования
  • Sidebar Banners — динамические баннеры (HTML/JS/iframe)
  • Article Card — изображение, заголовок, описание

📊 База данных

Схема БД

users           — Пользователи (админка)
├── id, login, email, password, role, created_at

items           — Элементы каталога
├── id, title, slug, logo_url, description
├── promo_code, promo_description, link
├── rating, votes, sort_order, category_slug
├── is_active, created_at, updated_at

articles        — Статьи блога
├── id, title, slug, content, image
├── seo_title, seo_desc, is_published, views
├── created_at, updated_at

settings        — Настройки (ключ-значение)
├── id, key_name, value, updated_at

seo_pages       — SEO страницы
├── id, slug, h1, h2, h3, title, description, keywords
├── updated_at

item_votes      — Голоса (защита от накрутки)
├── id, item_id, ip_address, rating, created_at

🚀 Развёртывание

Docker (локальная разработка)

# Запуск контейнеров
docker-compose up -d

# Установка PDO MySQL
docker-compose exec web docker-php-ext-install pdo pdo_mysql
docker-compose restart web

# Импорт БД
docker-compose exec -T db mysql -u root -psecret myshop < web/sql/schema_full.sql

# Права на кэш
docker-compose exec web chmod -R 777 /var/www/html/cache

Хостинг (продакшен)

# 1. Загрузить файлы web/ на хостинг
# 2. Создать БД и пользователя
# 3. Импортировать schema_full.sql
# 4. Отредактировать config/config.php
# 5. chmod 755 cache/

Подробности в INSTALL_HOSTING.md


🔐 Доступы (демо)

Сервис URL Логин/Пароль
Сайт http://localhost:8080 —
Админка http://localhost:8080/admin.php admin / admin123
Adminer http://localhost:8081 devuser / devpass

📈 Возможности масштабирования

Что можно добавить

  • REST API для мобильных приложений
  • Импорт/экспорт элементов (CSV, XML)
  • Мультиязычность (i18n)
  • Кэширование Redis/Memcached
  • Поиск по элементам (Elasticsearch)
  • Уведомления (Email, Telegram)
  • Аналитика (просмотры, клики, CTR)
  • Модерация пользовательского контента
  • API интеграции с партнёрскими сетями

🧠 Технические решения

Собственный MVC фреймворк

Почему не Laravel/Symfony?

  • Минимальные требования к хостингу
  • Нет зависимостей (composer не нужен)
  • Полный контроль над архитектурой
  • Образовательная цель — понимание MVC изнутри

Роутинг

// Простая маршрутизация по URI
$uri = parse_url($_SERVER["REQUEST_URI"], PHP_URL_PATH);

if ($uri === "/rating") {
    $controller = new CategoryController();
    $controller->handle(["slug" => "rating"]);
} elseif (preg_match('#^/item/([a-z0-9-]+)$#', $uri, $matches)) {
    $controller = new ItemController();
    $controller->handle(["slug" => $matches[1]]);
}

Защита от накрутки голосов

// Проверка IP + Cookie
$ip = $_SERVER['REMOTE_ADDR'];
$exists = $this->model->checkVote($itemId, $ip);

if (!$exists) {
    $this->model->addVote($itemId, $ip, $rating);
    setcookie("voted_{$itemId}", '1', time() + 86400);
}

📸 Скриншоты

Примечание: В проекте присутствуют скриншоты интерфейса:

  • screen.png — главная страница
  • screen-panel.png — админ-панель

🎓 Чему научился в проекте

Backend

  • ✅ Разработка собственного MVC фреймворка
  • ✅ Работа с PDO и подготовка SQL-запросов
  • ✅ Реализация роутинга и ЧПУ
  • ✅ Хеширование паролей (bcrypt)
  • ✅ Защита от CSRF и XSS атак
  • ✅ Работа с сессиями и cookie

Frontend

  • ✅ Tailwind CSS для быстрой вёрстки
  • ✅ Dark Mode дизайн-система
  • ✅ AJAX запросы без jQuery
  • ✅ Адаптивная вёрстка (mobile-first)
  • ✅ Компонентный подход

DevOps

  • ✅ Docker и Docker Compose
  • ✅ Настройка Apache + mod_rewrite
  • ✅ Развёртывание на shared-хостинге
  • ✅ Работа с MySQL и phpMyAdmin
  • ✅ Настройка прав доступа (chmod/chown)

Soft Skills

  • ✅ Проектирование архитектуры приложения
  • ✅ Документирование кода и процессов
  • ✅ Подготовка гайдов по установке
  • ✅ Планирование масштабирования

📝 Лицензия

MIT License — свободное использование и модификация.


🔗 Контакты

Параметр Значение
Telegram @den06is

Проект разработан в 2026 году. Готов к использованию в продакшене.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages