AI Sana — Challenge Hub

MVP команды DoubleMid: бизнес превращает потребность в понятную задачу, студенты выбирают её в общем каталоге, бизнес сравнивает предложения и подтверждает выполненный этап.

Быстрый запуск

Нужны Node.js 24 и npm. Команды выполняются в папке проекта:

git clone https://github.com/BAITC-Hacks/hack-0f8b3a7c-doublemid.git
cd hack-0f8b3a7c-doublemid
npm ci
npm run db:migrate
npm run dev

Откройте http://localhost:5173 (или адрес из вывода сервера). Миграции можно запускать повторно: применяются только новые. Данные сохраняются в .wrangler/state между перезапусками.

Для готовой сборки:

npm run build
npm start -- --port 4173

Откройте http://localhost:4173. Для чистого клона сначала нужны npm ci и npm run db:migrate. Локальная конфигурация базы — wrangler.local.jsonc: её имя намеренно отличается от автоматически загружаемой конфигурации сборщика, чтобы не дублировать DB.

Аккаунты

На странице входа есть две кнопки для быстрой демонстрации. Также можно войти по email и паролю:

Кабинет	Email	Демо-пароль
Бизнес / администратор	[email protected]	AdminSana2026!
Студент, команда Qadam	[email скрыт]	StudentSana2026!
Дополнительные команды	[email скрыт] — [email скрыт]	StudentSana2026!

Бизнес и студент могут работать из разных браузеров или устройств с одним сервером. Открывайте разные аккаунты в разных профилях/приватных окнах: обычные вкладки одного браузерного профиля разделяют cookie. Общие данные обновляются каждые 15 секунд и при возвращении в окно.

Публичные пароли предназначены для учебного показа. Перед закрытым пилотом задайте в серверном окружении DEMO_LOGIN_ENABLED=false, ADMIN_PASSWORD, STUDENT_PASSWORD и, если нужны, TEAM2_PASSWORD–TEAM5_PASSWORD. Без заданного пароля соответствующий аккаунт при выключенном демо недоступен. Самостоятельной регистрации и восстановления паролей пока нет.

Что доработано

• Вместо переключателя ролей — серверный вход, отдельные кабинеты и отзыв сессии при выходе.
• Общая база задач для всех аккаунтов; черновики видит только бизнес. Студент получает только свои предложения, но видит общее число откликов и рейтинг достижений.
• Обзор бизнеса: публикации, черновики, новые отклики, результаты на проверке. Обзор студента: интересные задачи, предложения, работа и баллы.
• Конструктор: свободное описание → минимум 3 уточнения → редактируемая карточка → ручное подтверждение → публикация.
• Рейтинг 0–100, расшифровка, недостающие поля и пересчёт. Каталог сортируется по рейтингу; есть поиск и фильтры темы/готовности.
• Неограниченное число откликов: идея, план, срок и HTTP(S)-ссылка. Команда определяется сессией, а не присланным идентификатором.
• Бизнес сравнивает предложения карточками или таблицей; выбирает одну, несколько или ни одной команды.
• Выбранная команда отправляет отчёт. Только после этого бизнес проверяет и подтверждает результат. +20 баллов один раз за отклик; сам выбор баллов не даёт.
• Адаптивный экран входа, два обзора, рекомендации по интересам и рейтинг команд за подтверждённые результаты.

Рейтинг

Показатель	Вес
Контекст и потребность	20
Данные и материалы	20
Ожидаемый результат	15
Критерии успеха	15
Ограничения	10
Пользователи	10
Контакт и взаимодействие	10

Контекст/потребность разделены на 10+10, контакт/взаимодействие — на 5+5. Сервер начисляет баллы только за заполненные и подтверждённые поля. От 8 символов, распространённые заглушки не учитываются. Это оценка полноты, не семантическая экспертиза. Предварительный балл в редакторе не является начисленным рейтингом.

0–39 — требует уточнения; 40–69 — рабочая; 70–89 — готовая; 90–100 — приоритетная. Последнее название сохранено из исходного проекта: присланный текст задания обрывается на диапазоне 70–89. Опубликованная карточка доступна для откликов при любом балле. Неподтверждённые личные черновики в общий каталог не попадают.

Помощник

Без ключей и платных запросов работают контекстные резервные вопросы. Ответы пользователя переносятся в карточку, отсутствующие факты не выдумываются. Для OpenAI скопируйте .env.example в .env.local, задайте OPENAI_API_KEY и включите OPENAI_REQUESTS_ENABLED=true только если готовы оплачивать запросы. Модель задаётся OPENAI_MODEL; существующая настройка — gpt-5.4-mini.

Реальное обращение к OpenAI в этой доработке не выполнялось. Контракт и резервные режимы проверены на имитациях. При недоступности модели конструктор продолжает работать. Контактное поле исключено из AI-запроса; личные сведения в свободном тексте автоматически не удаляются. Подробности — docs/OPENAI-INTEGRATION.md.

Автоматические проверки без платных запросов

После установки зависимостей:

npm run typecheck
npm run lint
npm test
npm run build
npm run test:built

test:built запускает собранный Worker с временной D1, применяет обе миграции и проверяет вход, права, общий каталог, скрытые черновики, предложение от своего аккаунта, ручной выбор нескольких команд, отчёт, подтверждение, однократные баллы, конфликт правок, повторы запросов, недопустимые ссылки и выход. Это рекомендуемая безопасная проверка: база пользователя не меняется.

node scripts/test-api.mjs предназначен только для отдельного тестового сервера с исходными демо-данными, потому что создаёт и изменяет записи в общем каталоге. Не запускайте его на рабочем показе. TEST_URL задаёт адрес сервера.

Состав

• app/page.tsx, components/hub/ — интерфейс и кабинеты.
• app/api/auth/route.ts, lib/auth.ts — вход, ограничения попыток, сессии.
• app/api/workspace/route.ts — серверная авторизация действий и бизнес-логика.
• lib/domain.ts — рейтинг, типы, вопросы и синтетические примеры.
• db/, drizzle/ — D1 и миграции.
• docs/CRITERIA.md — соответствие присланному кейсу.
• docs/CLICK-THROUGH.md — сценарий для демонстрации.
• docs/REVIEW-AND-TESTING.md — проверенные изменения и ограничения.

Архив содержит исходники, миграции и lockfile; не содержит зависимостей, локальной базы и секретов. Изменения не отправлялись в GitHub: доступа к приватному репозиторию в сессии нет. Замените соответствующие файлы в своей рабочей копии, проверьте запуск и сохраните обычным коммитом. Старые записи исходной версии остаются в базе под прежними идентификаторами пространств; новый общий каталог создаётся отдельно и не удаляет их. npx tsc --noEmit node scripts/test-domain.mjs node --test scripts/test-openai.mjs scripts/test-reliability.mjs npm run build node scripts/test-built.mjs

`test-built.mjs` запускает готовую сборку на свободном локальном порте, создаёт временную базу, проверяет страницу и клиентские файлы, затем выполняет серверный сценарий. Ключ не загружается, реальные AI-запросы выключены, база пользователя не используется.

Дополнительные команды:

```sh
# API-проверка уже работающего сервера; по умолчанию http://localhost:4173
node scripts/test-api.mjs
# Проверка отсутствия локального ключа в исходниках и сборке
# Требует .env.local с ключом, существующую dist и Git в PATH
node scripts/check-secret-boundary.mjs

Для другого адреса API-теста задайте TEST_URL. Например, в PowerShell:

$env:TEST_URL = 'http://localhost:5173'
node scripts/test-api.mjs

API-тест создаёт отдельное пространство. Он требует выключенных реальных AI-запросов и проверяет публикацию при низком рейтинге, отклик, выбор, подтверждение, сохранение, изоляцию, неверные запросы, повторную отправку и конкурентные изменения.

Зафиксированные проверки текущей версии: 17 тестов OpenAI-адаптера на имитациях ответов и 9 тестов восстановления форм/чтения запросов прошли; доменные проверки, TypeScript, сборка и серверный сценарий также прошли. Интерфейс проверялся на компьютере и экранах шириной 390 и 320 px. Это проверка конкретных сценариев, а не гарантия отсутствия любых ошибок. Подробности — отчёт об аудите.

Для отдельной проверки модели предусмотрен scripts/test-live-ai.mjs. Он делает один реальный запрос только с флагом --allow-paid-request; запускать его следует после согласования расходов. Этот тест не входит в команды выше и ещё не выполнялся.

8. Данные и интеграции

• Демонстрационные данные: массивы seedDrafts, seedTasks, teams, seedProposals в lib/domain.ts. Названия организаций, контакты, задачи и предложения синтетические. Упоминания CSV/PDF внутри карточек описывают учебные условия; импорта этих файлов и подключённых наборов данных нет.
• Данные пользователя: текст карточек, отклики, решения и описания подтверждённых этапов сохраняются в D1. Незавершённые формы дополнительно сохраняются в sessionStorage текущей вкладки.
• OpenAI: внешний API используется только после явного включения. Модель по умолчанию — gpt-5.4-mini. Доступ ключа, баланс и качество реального ответа в этом проекте пока не подтверждены.
• Cloudflare D1 / Workers: база и среда выполнения; локально эмулируются установленными инструментами.
• Sites: в репозитории есть конфигурация привязки D1 и инфраструктура сборки. Публичное размещение не подтверждено.
• Ссылки на прототипы: принимаются HTTP(S)-адреса без логина и пароля. Приложение хранит ссылку, но не проверяет работоспособность или качество внешнего прототипа.

Автоматического импорта задач из внешних систем, отправки писем, подключения к университетским базам или NVIDIA-сервисам нет.

9. Ограничения текущей версии

1. Демонстрационные роли вместо отдельных аккаунтов. Нет регистрации организаций/команд и серверных прав на отдельные роли. Другой браузер получает другое пространство. Публичный многопользовательский каталог ещё не реализован.
2. Рейтинг оценивает полноту текста. Он не проверяет достоверность, смысл, измеримость критериев или реализуемость задачи. Длинный бессодержательный ответ может получить баллы.
3. Живой AI не проверен. OpenAI-адаптер протестирован на имитациях; по умолчанию работают вопросы по правилам. Одна только настроенная переменная ключа не подтверждает доступность модели.
4. Карточку формирует пользователь. Автоматического переписывания всего задания моделью, семантического matching и автоматического назначения команд нет.
5. Лимиты AI действуют в одном экземпляре сервера. Между реальными запросами пространства предусмотрена пауза 30 секунд. Это не постоянная квота и не финансовый лимит; для открытого пилота нужны авторизация и надёжный контроль расходов.
6. Восстановление формы ограничено вкладкой. Для постоянного хранения задачи нужно сохранить черновик; отклик сохраняется на сервере после отправки. Очистка cookie создаёт новое пространство и не является механизмом восстановления доступа к прежним записям.
7. Подтверждение этапа ручное. Нет автоматической проверки доказательств, загрузки файлов или системы нескольких этапов на один отклик.
8. Публичный деплой не подтверждён. Для реального пилота также потребуются настройка секретов, резервного копирования, мониторинга и прав доступа. Vinext используется в beta-версии.

10. Развёрнутая версия

Подтверждённой публичной ссылки в текущем репозитории нет. Для оценки используйте локальный запуск по разделу 6.

Адрес localhost доступен только на компьютере с запущенным сервером и не является ссылкой на deployed-версию. GitHub содержит исходный код и документацию, но сам по себе не запускает это приложение с сервером и базой.

Аккаунт	Email	Демо-пароль
Админ	[email protected]	AdminSana2026!
Студент	[email скрыт]	StudentSana2026!

11. Материалы для защиты

• Архитектура и границы MVP
• Пошаговая проверка с текстами для вставки
• Сценарий демо, структура питча и ответы жюри
• Настройка и статус OpenAI
• Аудит, исправления и результаты проверок