🚀Быстрый старт
За 3 минуты ты сможешь добавить первый компонент:
1️⃣ Открой админку
Перейди на /admin/ и авторизуйся
2️⃣ Добавь компонент
Заполни форму и загрузи GLB файл
3️⃣ Опубликуй
Нажми "Сохранить" и компонент появится на сайте
✨Основные возможности
- Добавляй неограниченное количество 3D компонентов
- Загружай GLB/GLTF модели с текстурами
- Описывай каждый компонент подробно
- Устанавливай уникальные цвета для выделения
- Управляй порядком отображения компонентов
- Включай/отключай компоненты без удаления
- Редактируй информацию в любой момент
📝Как добавить компонент
Шаг 1: Откройте страницу администратора
Шаг 2: Нажмите "+ Добавить"
На странице с примером компонентов нажми кнопку для добавления нового.
Шаг 3: Заполните форму
| Поле |
Значение |
Пример |
| Название компонента |
Полное название |
CPU (Процессор) |
| URL-название |
Уникальный идентификатор |
cpu |
| Описание |
Подробное объяснение |
Центральный процессор — это мозг компьютера... |
| Характеристики |
По одной в строку |
Выполняет миллиарды операций
Многоядерная архитектура |
| 3D модель (GLB) |
Файл модели |
cpu.glb (5-10 MB) |
| Изображение |
Фото/превью (опцион.) |
cpu.png (1-2 MB) |
| Цвет |
HEX код |
#4299e1 |
Шаг 4: Сохраните
Нажми кнопку "Сохранить" и компонент появится на главной странице.
✓ Компонент сразу станет видимым на сайте и пользователи смогут с ним взаимодействовать!
🎨Стандартные цвета компонентов
Используй эти цвета для единообразного дизайна:
CPU (Процессор)
#4299e1
GPU (Видеокарта)
#48bb78
RAM (Оперативная память)
#ecc94b
Motherboard (Материнская плата)
#ed8936
PSU (Блок питания)
#f687b3
SSD (Накопитель)
#9f7aea
🔌REST API для разработчиков
Получить все компоненты
GET /api/components/
Получить компонент по URL-названию
GET /api/components/cpu/
Пример ответа
{
"success": true,
"components": [
{
"slug": "cpu",
"name": "CPU (Процессор)",
"description": "...",
"glb_model": "/media/models/glb/cpu.glb",
"color": "#4299e1"
}
]
}
🐛Решение проблем
Не могу войти в админку
Запусти скрипт для восстановления пароля: reset_admin_password.bat
Ошибка: "Компонент с URL-названием уже существует"
URL-название должно быть уникальным. Используй другое имя (например: cpu2, cpu-v2).
Файл GLB слишком большой
Оптимизируй модель. Рекомендуемый размер: 5-10 MB.
Инструменты: Blender, Meshlab, glTF-Transform.
Изображение не загружается
Используй стандартные форматы (JPG, PNG) размером до 5 MB.
Компонент не появляется на сайте
Убедись что:
- Флажок "Активен" включен
- GLB файл загружен и доступен
- Страница обновлена (нажми F5)
💡Советы и трюки
Оптимизация GLB моделей
- Используй только необходимые полигоны
- Сжимай текстуры до 2K или ниже
- Удаляй неиспользуемые материалы
- Тестируй размер файла перед загрузкой
Хорошие описания
- Начни с функции компонента
- Добавь технические подробности
- Используй простой язык
- Упоминай важные параметры
Управление порядком
Используй "Порядок сортировки" для управления положением компонентов в списке. Меньшее число = выше.
Красивые цвета
Используй контрастные цвета для лучшей видимости в 3D сцене.
📚Дополнительная информация
✅Готов?
Тогда давайте добавим твой первый компонент!