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

Страница состоит из трёх частей: функциональные характеристики — что программа умеет; установка — что нужно, чтобы начать; эксплуатация — как ею пользоваться каждый день.

Часть I. Функциональные характеристики

«Макетка» — учебный онлайн-сервис для занятий по трёхмерному проектированию и электронике. Работает в веб-браузере, интерфейс полностью на русском языке.

1. Трёхмерное проектирование

• построение и правка трёхмерных моделей в браузере: тела, контуры по точкам, вытягивание контура в объём;
• булевы операции над телами: объединение, вычитание, пересечение;
• скругление выбранных рёбер, создание полости, зеркальное отражение, масштабирование, круговой массив, спираль;
• покраска и скрытие элементов модели;
• облачное сохранение работ с автосохранением, хранением ревизий и разбором расхождений, если работу правили с двух устройств;
• выгрузка модели в форматы STL (для 3D-печати) и STEP (для передачи в другие программы);
• панель шагов задания рядом с моделью, подсказка при первом входе, индикатор состояния сохранения;
• экономный режим отрисовки для слабых школьных компьютеров.

2. Электрические схемы

• сборка схем из палитры деталей: плата Arduino Uno, светодиоды, резисторы, кнопки, потенциометр, пьезоизлучатель и другие — всего девятнадцать наименований, с поиском и описанием каждой детали;
• соединение деталей проводами по сетке с изломами;
• электрическая модель схемы с подсказками об ошибках соединения;
• редактор текста программы для микроконтроллера и кнопка «Включить»: сборка выполняется на сервере, а собранная программа исполняется в браузере (моделирование работы микроконтроллера);
• вывод сообщений от платы и звук пьезоизлучателя;
• выгрузка исходного текста программы и собранного файла прошивки для настоящей платы.

3. Учебная часть

• вход ученика по коду группы или личному коду, при необходимости — с коротким кодом-PIN;
• кабинет ученика: свои работы, раздел «С чего начнём», карточки уроков (десять по трёхмерному проектированию, три по электронике), раздел «Примеры» с готовыми схемами;
• кабинет наставника: группы, код на проектор, печатные карточки входа, лента работ группы, добавление учеников списком, раздача заготовки, корзина, учебное окно, PIN группы, кнопка «Новый учебный год», принудительный выход ученика, показатели занятия;
• режим общего компьютера класса: экран-замок и передача компьютера следующему ученику;
• регистрация взрослых по адресу электронной почты с подтверждением адреса и восстановлением пароля;
• заявка на роль наставника с ручным одобрением администратором;
• пробный режим: редактор открывается без входа, работы в нём не сохраняются.

4. Технические характеристики

• работа в браузере без установки программ на устройство пользователя;
• хранение работ и учётных записей в базе данных на сервере на территории Российской Федерации;
• интерфейс на русском языке, включая сообщения об ошибках;
• при работе программа не обращается к иностранным серверам; сторонней рекламы нет. Единственный внешний сервис в составе страниц — российский счётчик посещаемости Яндекс.Метрика (ООО «ЯНДЕКС», обработка на серверах в России).

Часть II. Установка

Установка программного обеспечения на устройство пользователя не требуется. «Макетка» — облачный сервис: программа работает на сервере, а пользователь открывает её в браузере по адресу https://cad.cmit.ru/. Скачивать дистрибутив, устанавливать приложение, расширения или плагины не нужно ни ученику, ни наставнику, ни школе.

1. Что нужно на рабочем месте

2. Порядок начала работы

1. Откройте браузер и введите адрес cad.cmit.ru.
2. Ученик нажимает «Войти по коду» и вводит код, который дал наставник. Взрослый нажимает «Войти» и вводит адрес почты и пароль.
3. Всё. Сервис готов к работе; ничего скачивать и настраивать не нужно.

Проверить, что рабочее место подходит, можно без входа: откройте cad.cmit.ru и нажмите «Попробовать» — откроется редактор без сохранения. Если модель вращается мышью плавно, компьютер подходит.

Часть III. Эксплуатация

Ниже — короткие рецепты по шагам: как сделать в сервисе то, что нужно чаще всего. Первые семь пригодятся всем, остальные — наставнику. К ученику здесь обращаются на «ты», ко взрослому — на «вы».

1. Как войти ученику

1. Открой cad.cmit.ru и нажми «Войти по коду класса».
2. На занятии: введи код класса — шесть символов, наставник показывает их на экране. Потом найди себя в списке и нажми свою плитку.
3. Дома: введи личный код со своей карточки — восемь символов. Он сразу открывает твои работы, список класса спрашивать не будет.
4. Если группа просит код из четырёх цифр, введи его. В первый раз ты придумываешь его сам; забыл — скажи наставнику, он сбросит.
5. Себя нет в списке — нажми «Меня здесь нет» и напиши имя так, как тебя зовут на занятии. Наставник потом проверит список.
6. Код не подошёл — пересчитай символы: у кода класса их шесть, у личного восемь. Большие буквы, маленькие и русская раскладка значения не имеют. Если всё равно не пускает, скажи наставнику: новый код он выдаёт за минуту.

2. Как войти наставнику

1. Откройте cad.cmit.ru и нажмите «Войти».
2. Введите адрес почты и пароль — откроется кабинет с вашими группами.
3. Пароль забыт — «Забыли пароль?»; по ссылке из письма зададите новый.
4. Учётной записи ещё нет — «Зарегистрироваться»: почта, пароль, подтверждение адреса по письму. Так вы получите свою мастерскую. Чтобы появились группы, напишите нам на cad@cmit.ru, где и с кем вы занимаетесь, — администратор откроет доступ наставника и ответит на почту.
5. На общем компьютере класса после урока нажмите в верхней строке своё имя и «Выйти» — иначе кабинет останется открытым для следующего.

3. Как сделать модель

1. В своей мастерской нажми «Создать модель».
2. На экране «С чего начнём?» выбери карточку урока или «Пустая сцена». С карточкой рядом с моделью будут видны шаги задания — выходить из мастерской не придётся.
3. Возьми фигуру в ленте команд, поставь её в сцене и растяни мышью до нужного размера.
4. Дальше — вытяни контур в объём, вырежи лишнее, скругли рёбра, покрась. Ненужное можно спрятать в списке частей модели, не удаляя совсем.
5. Вращать и приближать сцену — мышью; какая кнопка что делает, написано подсказкой в самой мастерской.
6. Готово — работа уже сохранена. Вернуться к остальным работам можно ссылкой «Мои работы» в верхней строке мастерской.

4. Как собрать схему

1. В своей мастерской нажми «Создать схему» и выбери на экране «С какой схемы начнём?» готовую заготовку или «Пустая схема».
2. Найди деталь в палитре — по названию или по разделу — и нажми на неё: деталь появится на поле. Дальше её можно двигать мышью.
3. Соедини выводы проводом: нажми на вывод одной детали, потом на вывод другой.
4. Открой вкладку «Программа» и напиши программу для платы.
5. Нажми «▶ Включить». Программа собирается на сервере, а схема оживает прямо в браузере: светодиоды загораются, пищалка звучит. Пока схема работает, та же кнопка читается «⏹ Выключить» — на ходу схему менять нельзя.
6. Что плата пишет о себе, показывает раздел «Сообщения от Arduino» под схемой. Если программа не собралась, сервис объяснит по-русски, что в ней не так.

Разобранные примеры схем лежат в разделе «Примеры» — он открыт даже без входа. Чтобы менять пример, забери копию себе: она появится среди твоих работ.

5. Как работа сохраняется и где её найти

1. Нажимать «сохранить» не нужно: работа сохраняется сама, пока ты работаешь.
2. Рядом с названием видно, что происходит: «Сохраняю…», «Сохранено», а если сохранить не удалось — что случилось и что делать.
3. Все работы лежат в мастерской. На плитке видно картинку работы, название и когда её трогали в последний раз.
4. Переименовать работу — кнопка с карандашом на плитке. Название можно поменять и в самой мастерской: нажми на него в верхней строке и выбери «Переименовать».
5. Убрать работу — крестик на плитке. Совсем она не пропадёт: ляжет в «Корзину», откуда её можно вернуть.

6. Как выгрузить результат

1. Работу можно скачать файлом прямо из мастерской: нажми на её название в верхней строке, выбери «Скачать…» и в окне «Что скачать?» — что именно нужно.
2. Модель выгружается в двух видах: STL — для 3D-принтера, STEP — чтобы открыть модель в другой программе проектирования.
3. Схема тоже отдаёт два файла: .ino — текст программы, его открывают в Arduino IDE, и .hex — готовая прошивка, её заливают прямо в настоящую плату. Прошивка появляется после того, как программа хотя бы раз собралась.
4. Кроме этого из того же окна забирают картинку работы и файл работы — запасную копию на свой компьютер.
5. Файл сохраняется туда, куда браузер складывает загрузки.
6. Файл работы можно вернуть обратно: перетащи его на мастерскую или нажми на название работы → «Открыть другую работу…» → «Открыть файл работы с компьютера…». Он станет новой работой; схема откроется в мастерской схем, модель — в мастерской 3D, и неважно, из какой мастерской его вернули.
7. На общем компьютере класса забери файл на флешку или отправь себе до того, как передашь компьютер следующему.

7. Как работать на общем компьютере класса

1. Входи, как обычно: код класса, потом своя плитка в списке.
2. Закончил — нажми «Выйти / Передать компьютер» и подтверди. Кнопка одна и та же и в мастерской, и в верхней строке кабинета. Работа уже сохранена, ничего не пропадёт.
3. Следующий вводит код класса и находит себя — твои работы ему не откроются.
4. Если отошёл и забыл выйти, экран закроется сам: на классном компьютере это происходит быстрее, чем на своём.
5. Ученик ушёл, не выйдя, — наставник завершает его вход из кабинета группы: «Выйти» в строке ученика или «Выйти всем» в конце занятия. Работы при этом сохраняются.

8. Как завести группу

1. В кабинете нажмите «Новая группа».
2. Назовите группу так, как называете её в расписании, — например «Схемотехника, четверг 16:30».
3. Вставьте список имён — по одному в строке, прямо из журнала.
4. Отметка «Занятия на общих компьютерах класса» стоит по умолчанию; снимите её, если у каждого ученика свой ноутбук.
5. Нажмите «Создать группу». Добавить учеников позже можно снизу страницы группы — «Добавить учеников — по одному имени в строке» и «Добавить в группу».
6. Если сервис предупредит, что в группе есть одинаковые имена, включите на странице группы «Спрашивать у ученика код из четырёх цифр» — иначе дети смогут открыть работы друг друга.

9. Как показать код класса на уроке

1. Откройте группу и нажмите «Показать код класса».
2. Выведите страницу на проектор — код напечатан крупно, его видно с последней парты.
3. Ученики открывают cad.cmit.ru, жмут «Войти по коду класса», вводят код и находят себя в списке.
4. Код ушёл на сторону — нажмите «Сменить код класса»: старый перестанет пускать новых, а те, кто уже вошёл, продолжат работать.

10. Как напечатать карточки входа

1. Откройте группу и нажмите «Коды для печати».
2. Помните: на листе личные коды учеников. Это документ наставника — на проектор его не выводят и целиком никому не раздают.
3. Нажмите «Печать» и распечатайте лист. Пунктир на нём — линия реза.
4. Раздайте каждому его карточку: с ней ребёнок войдёт из дома.
5. Начался новый учебный год — кнопка «Новый учебный год» в группе выдаст всем новые личные коды: старые перестанут работать, работы сохранятся. После этого карточки печатают заново.

11. Как раздать заготовку группе

1. Сначала соберите образец в своей мастерской — это обычная ваша работа.
2. Откройте группу и нажмите «Раздать заготовку».
3. Выберите работу-образец в списке и нажмите «Раздать».
4. Сразу увидите отчёт: кто получил копию, у кого она уже была и кому не хватило места.
5. У ученика копия появится среди его работ с пометкой «Новое от наставника». Раздать ту же заготовку второй раз не страшно — лишних копий не будет.

12. Как посмотреть, кто как справляется

1. Откройте группу — её страница и есть сводка занятия.
2. Сверху видно, сколько в группе учеников, сколько ещё не начали и какой сейчас код класса.
3. В списке у каждого ученика — его состояние и последняя работа. Нажмите на название работы, чтобы её открыть.
4. Чтобы застрявшие были на виду, переключите список: «показать первыми» поставит наверх тех, кто не начал.
5. Ученик забыл выйти — «Выйти» в его строке; всему классу разом — «Выйти всем».

13. ИИ-помощник наставника

К «Макетке» можно подключить ту ИИ-программу, которой вы уже пользуетесь, и разговаривать с ней о занятии обычными словами: посмотреть работы группы, собрать черновик разбора, придумать задание, построить образец. Ниже — что для этого нужно, что ИИ-помощник умеет, чего не умеет никогда и что делать, если он молчит.

Что вам понадобится

• Программа, которая умеет подключать помощников. Это может быть настольное приложение ИИ-помощника или редактор кода с ИИ-режимом — тот, которым вы уже пользуетесь каждый день.
• Возможность поставить программу на свой компьютер. ИИ-помощник запускается там же, где открыт ваш чат, и ему нужны две бесплатные программы: Node.js (nodejs.org) версии 18 или новее и Git (git-scm.com) — ИИ-помощник ставится прямо из нашего хранилища кода. Если на рабочий компьютер ставить программы нельзя — подождите варианта без установки, мы его готовим.
• Тариф вашего чата. У веб-чатов возможность подключать свои источники бывает только на платных тарифах; платит за неё тот, кто подключает.
• Включённый ИИ-помощник у группы. Его включает администратор сервиса, для каждой группы отдельно; по умолчанию он выключен.
• Код доступа — вы выдаёте его себе сами, см. ниже.

Самой «Макетке» это ничего не меняет: она по-прежнему открывается в браузере и ничего ставить не требует ни ученику, ни школе. Node.js и Git нужны не ей, а вашей ИИ-программе, и только на вашем компьютере.

Что это такое

ИИ-помощник — небольшая программа-посредник на вашем компьютере. Ваш чат просит её «покажи работы вторничной группы», она спрашивает у «Макетки» и возвращает ответ. Ключ ко всему — код доступа: без него не проходит ни один вопрос, и отвечает «Макетка» только про ваши группы.

С чатом посредник говорит на общем языке — он называется MCP, и его понимают разные программы. Поэтому подойдёт не какая-то одна, а любая, которая этот язык знает. Сама «Макетка» при этом никуда не обращается и никому ничего не отправляет: к ней подключаются, а не наоборот.

Что ИИ-помощник может

• Посмотреть работы группы — кто что сохранил, по какой карточке урока, когда и какого объёма получилась модель.
• Разобрать работу — открыть её строение и картинку и сказать, сходится ли она с шагами карточки.
• Собрать черновик разбора занятия — по строке на ученика: короткий вердикт и пояснение. Черновик приходит в кабинет, на страницу «ИИ-помощник».
• Придумать задание — карточку урока со списком шагов; в кабинете она появится выключенной, пока вы её не проверите.
• Сделать образец и раздать его группе — каждому ученику своя копия.
• Построить модель по описанию — в открытой мастерской, на глазах у класса: шаги выполняет та вкладка, где работа открыта. Если работа не открыта ни у кого, построение ждёт.
• Показать свежий кадр сцены — сверху, сбоку или спереди, если нужно посмотреть, что получилось.

В чате вы видите черновик разбора; ученику попадает только то, что вы подтвердили в кабинете, построчно. Этот второй шаг не лишняя работа: черновик пишет машина, а разговаривать с ребёнком будете вы.

Чего он не может и не сможет

• Не видит имён. Ни имени, ни личного кода, ни адреса почты, ни названия, которое ребёнок придумал сам. Вместо имени у него «ученик №5»; имя подставляет только ваш кабинет и только вам.
• Не ставит оценок и ничего не отправляет ученикам.
• Не может удалить или изменить работу ученика — ни по просьбе, ни по ошибке. Строить в детской работе он вправе лишь после того, как вы нажали «Править».
• Не работает с группой, где вы его не включили.
• Не бывает у ученика. Код доступа выдаётся только взрослой учётной записи.
• Схемы пока не разбирает — на работу-схему он ответит, что это не 3D-работа.

Как подключить

Порядок один: получить код доступа, вставить готовый блок настроек в свою программу, перезапустить её и написать в чат «проверь подключение к Макетке». Блоки ниже отличаются только тем, как устроен файл настроек; кроме кода доступа в них менять нечего.

{
  "mcpServers": {
    "maketka": {
      "command": "npx",
      "args": ["-y", "github:cmit-ru/maketka-mcp#v0.3.0"],
      "env": { "MAKETKA_TOKEN": "mk_ВАШ_КОД" }
    }
  }
}

{
  "servers": {
    "maketka": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:cmit-ru/maketka-mcp#v0.3.0"],
      "env": { "MAKETKA_TOKEN": "mk_ВАШ_КОД" }
    }
  }
}

Метка версии в блоке стоит намеренно: на вашем компьютере лежит код доступа, и мы не предлагаем тянуть из сети свежий код при каждом запуске. Когда выйдет новая версия, ИИ-помощник скажет об этом одной строкой в ответе на проверку подключения — тогда поменяйте метку после решётки. Первый запуск дольше остальных: программа забирает ИИ-помощника и ставит то, что ему нужно; дальше берёт готовое. Готовые блоки под конкретные программы и ответы на частые вопросы лежат рядом с самим ИИ-помощником — по тому же адресу, что стоит в блоке настроек.

Веб-чаты и облачные студии так подключиться пока не могут: им нужен наш адрес, а не программа на вашем компьютере. Это отдельная работа, и она в планах.

Где взять код доступа

1. В кабинете нажмите «ИИ-помощник» в верхней строке.
2. Нажмите «Выдать код доступа». Код показывается один раз — скопируйте его сразу.
3. Вставьте код в блок настроек вместо mk_ВАШ_КОД и перезапустите программу.

Новый код заменяет прежний. ИИ-помощник, настроенный на другом компьютере, отключится, пока вы не впишете туда новый код. Выдавайте новый, если прежний потерян или попал не в те руки. Код — как пароль: он лежит открытым текстом в файле настроек, не показывайте этот файл на проекторе и не пересылайте код письмом.

На странице ИИ-помощника видно, когда кодом пользовались последний раз. Если вы им не пользовались, а отметка свежая, — отзовите код и выдайте новый.

Если спросят, что видит ИИ-помощник — это можно пересказать вслух: он видит фигуры в работах, их размеры и картинку модели; имён, личных кодов и того, что дети написали сами, он не видит — вместо имени у него «ученик №5». Оценок он не ставит и ученикам ничего не отправляет.

Как получить разбор занятия

1. Убедитесь, что ИИ-помощник включён у группы: если нет, он ответит, что группа закрыта, и попросит обратиться к администратору.
2. Попросите словами: «разбери работы группы по карточке „Брелок“» — или, если в кабинете видно, что урок ждёт разбора, — «возьми пакет проверки и разбери».
3. Черновик появится в разделе «Разборы работ»: по каждому ученику вердикт и комментарий. Это не оценка: прежде чем говорить с учеником, просмотрите каждую строку и подтвердите её, исправьте или уберите — принять весь черновик разом нельзя.

Ученику черновик не показывается — о разборе ему рассказывает наставник.

Как выключить

1. Отозвать код: страница «ИИ-помощник» → «Отозвать». ИИ-помощник перестанет подключаться сразу, даже если код у кого-то остался.
2. Выключить ИИ-помощника у группы — это делает администратор сервиса; после этого по группе не пройдёт ни один вопрос.

О чём его спрашивать

Говорите своими словами — что именно сделать, ИИ-помощник выбирает сам. Фразы ниже сверены 3 сентября 2026 года с тем, что он умеет: у каждой есть подходящее действие. Проверку в живых чатах мы проводим с первыми наставниками и поставим здесь её дату; ответ может звучать по-разному, потому что формулирует его ваш чат, а не «Макетка».

• «Проверь подключение к Макетке.»
• «Покажи мои группы.»
• «Что сохранили во вторничной группе на этой неделе?»
• «Разбери занятие: у кого получилось, у кого застряло. Сохрани черновик разбора.»
• «Открой работу 128 и скажи, сходится ли она с шагами карточки.»
• «Придумай задание на 45 минут: брелок с отверстием. Шаги — словами для ребёнка.»
• «Создай образец „подставка под телефон“, построй его и раздай группе 3.»
• «Построй в работе 86 пружину и покажи, как это выглядит сверху.»

Если не работает

Ищите себя по левому столбцу: в чужом чате сообщение об ошибке пересказывают своими словами, поэтому точной фразы там может и не быть.

Не нашли свой случай — напишите на cad@cmit.ru и приложите то, что ответила программа. Код доступа в письмо не вставляйте.

Приватность

Через ИИ-помощника наружу уходят номера учеников, типы фигур и числа (размеры, объём, габариты), названия групп и карточек — наш текст, а не детский — и картинки работ. Имена, личные коды, адреса почты и строки, которые набирал ребёнок, не уходят никогда: их отсекает сам сервис, до отправки. Что и зачем обрабатывает «Макетка», написано в политике обработки персональных данных.

14. Как вернуть убранную работу

1. Ученик: открой «Мои работы», нажми «Корзина» и верни работу кнопкой «Вернуть».
2. Наставник: откройте группу, нажмите «Корзина» и верните работу ученику кнопкой «Вернуть». Свою работу возвращайте из своей «Корзины».
3. Работа лежит там 30 дней, потом стирается совсем — успейте до этого.
4. Если места у ученика не осталось, вернуть работу не выйдет: сначала уберите ненужное.

15. Что делать, если что-то пошло не так

1. Страница не открылась или ведёт себя странно. Обновите её (клавиша F5). Работа не потеряется: она сохранена на сервере.
2. Пропал интернет. Работайте дальше: правки копятся в браузере и уходят на сервер сами, как только связь вернётся. Пока сервис показывает, что сохранить не удалось, вкладку лучше не закрывать и компьютер не выключать.
3. Работу открыли сразу на двух компьютерах. Молча ничего не затрётся: сервис предупредит, что работа открыта ещё где-то, и спросит, с какой из них продолжать.
4. Вместо сцены — сообщение, что компьютер не тянет. Включите в браузере аппаратное ускорение графики, закройте лишние вкладки и согласитесь на экономный режим отрисовки, который предложит сервис.
5. Не подошёл код входа. Пересчитайте символы: у кода класса шесть, у личного восемь. Наставник выдаёт ученику новый личный код кнопкой «Новый код» в строке ученика; старый сразу перестаёт работать.
6. Что-то сломалось или неудобно. В обеих мастерских есть кнопка «Что-то не так?»: она отправляет нам сообщение вместе с картинкой того, что было на экране.
7. Ничего не помогло. Напишите на cad@cmit.ru: школа и группа, имя ученика без фамилии, время и что было на экране. Подробности — на странице «Поддержка».

16. Куда смотреть дальше

• Условия использования и стоимость — сколько стоит и что будет, если условия изменятся.
• Политика в отношении обработки персональных данных — какие данные обрабатываются и как ими управлять.
• Пользовательское соглашение — правила пользования сервисом.
• О программе и открытом коде — версия, правообладатель, открытые компоненты, исходный текст редактора.