README.md

README.md

@@ -1,20 +1,64 @@
-<div align="center">
-<img width="1200" height="475" alt="GHBanner" src="https://github.com/user-attachments/assets/0aa67016-6eaf-458a-adb2-6e31a0763ed6" />
-</div>
+# PrintFit - Генератор Органайзеров для 3D Печати
 
-# Run and deploy your AI Studio app
+PrintFit — это мощный веб-инструмент для создания параметрических органайзеров, разделителей и ящиков, оптимизированных для 3D-печати. Приложение позволяет легко проектировать системы хранения под любые размеры с возможностью детальной настройки перегородок и перфорации.
 
-This contains everything you need to run your app locally.
+![PrintFit Preview](https://via.placeholder.com/1200x600?text=PrintFit+3D+Preview)
 
-View your app in AI Studio: https://ai.studio/apps/drive/1gUfO_tgl_CPfAGf1eXuSFyC0K7nUZFgu
+## ✨ Основные Возможности
 
-## Run Locally
+### 🛠 Параметрическое Моделирование
+- **Полный контроль размеров**: Настраивайте ширину, глубину и высоту ящика с точностью до миллиметра.
+- **Толщина стенок и допуски**: Установка толщины внешних стенок и внутренних перегородок, а также компенсация усадки пластика (tolerance) для идеальной совместимости.
+- **Скругление углов**: Настройка радиуса углов для эстетики и совместимости с различными стандартами (например, Gridfinity).
 
-**Prerequisites:**  Node.js
+### 📐 Гибкая Система Перегородок
+- **Визуальный редактор макета**: Интуитивно понятный интерфейс для добавления вертикальных и горизонтальных разделителей.
+- **Вложенность**: Создание сложных сеток и ячеек разных размеров внутри одного органайзера.
+- **Умное отображение размеров**: Автоматический расчет и отображение внутренних габаритов каждого отсека прямо на 3D-модели.
 
+### 💨 Продвинутая Перфорация
+- **Экономия материала и времени**: Возможность создания перфорированных стенок и дна.
+- **Различные узоры**: Выбор формы отверстий (соты/гексагоны, круги, треугольники и др.).
+- **Умные исключения**: Алгоритм автоматически убирает перфорацию в местах стыков перегородок и углов, обеспечивая прочность конструкции (Solid Zones).
+- **Настройка плотности**: Регулировка размера отверстий и отступов между ними.
 
-1. Install dependencies:
-   `npm install`
-2. Set the `GEMINI_API_KEY` in [.env.local](.env.local) to your Gemini API key
-3. Run the app:
-   `npm run dev`
+### 🖥 Интерактивный 3D Предпросмотр
+- **Real-time рендеринг**: Мгновенное отображение изменений в браузере с помощью Three.js.
+- **Управление камерой**: Вращение, масштабирование и панорамирование для детального осмотра модели со всех сторон.
+- **Индикация размеров**: Внутренние размеры отсеков отображаются прямо внутри ячеек.
+
+### 💾 Экспорт и Шеринг
+- **STL Экспорт**: Генерация готовых к печати STL файлов. Можно скачать отдельные детали или весь проект архивом (ZIP).
+- **Сохранение проектов**: Возможность поделиться ссылкой на конфигурацию (все параметры кодируются в URL).
+
+## 🚀 Запуск Локально
+
+Для работы требуется установленный **Node.js**.
+
+1. Клонируйте репозиторий:
+   ```bash
+   git clone https://github.com/your-username/printfit-box-generator.git
+   cd printfit-box-generator
+   ```
+
+2. Установите зависимости:
+   ```bash
+   npm install
+   ```
+
+3. Запустите локальный сервер разработки:
+   ```bash
+   npm run dev
+   ```
+
+4. Откройте приложение в браузере (обычно http://localhost:5173).
+
+## 🛠 Технологический Стек
+- **React**: UI и управление состоянием.
+- **Three.js (@react-three/fiber)**: 3D рендеринг и геометрия.
+- **Tailwind CSS**: Стилизация интерфейса.
+- **Vite**: Сборщик проекта.
+- **Lucide React**: Иконки.
+
+## 📝 Лицензия
+Этот проект распространяется под лицензией MIT. Вы можете свободно использовать, изменять и распространять его.