AI Pages: Product Requirements Document

July 30, 2025 · View on GitHub

Версия: 2.0
Дата: Январь 2025
Статус: Approved

🎯 Видение продукта

AI Pages - веб-платформа с коллекцией интерактивных HTML-примеров для разработчиков и студентов. Главная страница служит навигационным узлом для доступа к 25+ самодостаточным приложениям.

Миссия: Превратить идеи в код за минуты, а не дни.

👥 Целевая аудитория

  • Первичная: Веб-разработчики (junior/middle), студенты IT
  • Вторичная: Преподаватели программирования, техлиды

📊 Ключевые метрики

  • Время на странице > 5 минут
  • Return rate > 30% в месяц
  • Время загрузки < 2 секунд
  • Использование > 3 инструментов у 80% пользователей

🛠️ Основные категории и инструменты

Dev Tools

  • Python Editor - интерактивная среда с Pyodide, Numpy, Matplotlib
  • WebLLM Chat - локальные языковые модели
  • Web Stable Diffusion - ИИ генерация изображений (WebGPU)
  • Gradio Lite - создание ML интерфейсов

Games

  • Tetris (классический + React версия)
  • Arkanoid - неоновый стиль
  • Snake - прогрессивная сложность
  • Minesweeper - многоуровневый сапер

Web Apps

  • React News - агрегатор новостей
  • Professions - каталог профессий с поиском
  • Precipitation Map - визуализация погоды (OpenLayers)

3D Graphics

  • 3D Balls - физическая симуляция (Three.js)
  • Liquid Simulation - флюидная динамика

🎨 Принципы дизайна

Ключевые принципы

  • Самодостаточность - каждое приложение в одном файле
  • Готовность к использованию - работает сразу после открытия
  • Образовательная ценность - код понятен и прокомментирован
  • Современные технологии - использует последние веб-стандарты

Технический стек

  • Frontend: Vanilla JS + HTML5 + CSS3
  • Frameworks: React (опционально), Three.js, OpenLayers
  • AI/ML: WebGPU, WebLLM, Gradio Lite, Pyodide
  • Deploy: GitHub Pages, автоматическое развертывание

Ограничения

  • Каждое приложение в одном HTML файле
  • Минимальные внешние зависимости
  • Поддержка только современных браузеров
  • Размер файла < 2MB

📋 Функциональные требования

Главная страница

  • Поиск по всем инструментам
  • Категоризация по типам
  • Карточки с превью и описанием
  • Адаптивная сетка компонентов

Каждое приложение

  • Кнопка "Назад к AI Pages"
  • Полноэкранный режим
  • Темная/светлая тема
  • Справка по использованию

🎯 Нефункциональные требования

Производительность

  • Загрузка главной страницы < 2 сек
  • Время запуска приложения < 3 сек
  • 60 FPS для игр и 3D приложений

Безопасность

  • HTTPS только
  • CSP заголовки
  • Валидация пользовательского ввода

Совместимость

  • Chrome 90+, Firefox 88+, Safari 14+
  • Мобильные устройства (responsive)

Доступность

  • WCAG 2.1 Level AA
  • Поддержка screen readers
  • Keyboard navigation

🚀 AI Pages - от идеи к коду за минуты!