From 5664e99554f68b63c23ec867358b06848e1a13d7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=A5=D0=B0=D0=BB=D0=B8=D0=BC=D0=BE=D0=B2=20=D0=A0=D1=83?= =?UTF-8?q?=D1=81=D1=82=D0=B0=D0=BC?= Date: Tue, 13 Jan 2026 01:30:05 +0300 Subject: [PATCH] README.md --- README.md | 70 ++++++++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 57 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 68dc502..152684a 100644 --- a/README.md +++ b/README.md @@ -1,20 +1,64 @@ -
-GHBanner -
+# 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. Вы можете свободно использовать, изменять и распространять его.