Project Description & Details

Задача

Pamyatay Pro решает прикладную задачу: Pamyatay-pro — это приложение с бекендом на Express с использованием базы данных Postgres и фронтендом на Next.js и React. Также активно используются API различных LLM для генерации информации различного вида, начиная от текстовой и заканчивая аудио- и видеогенерацией. Приложение находится в процессе разработки, поддерживается и совершенствуется в части актуальности модулей и функциональности.

Проект относится к коммерческий разработке и в активной разработке. Связан с услугами: Маркетинговые и корпоративные сайты.

Кейс показывает подход к задачам в области «Маркетинговые и корпоративные сайты»: от постановки до сдачи с понятной структурой модулей.

Перед стартом зафиксировали критерии готовности: понятный первый экран, предсказуемые ошибки форм, возможность доработки без переписывания половины кодовой базы.

Решение

Собран рабочий прототип/продукт с понятной навигацией и предсказуемым поведением форм и списков. Демо доступно по ссылке на странице.

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

Отдельное внимание — состояния загрузки и пустые списки: skeleton/spinner там, где данные приходят асинхронно, и понятные empty-state тексты вместо пустой таблицы.

Архитектура и стек

UI и клиент: react, react-hook-form, tailwindcss.

Сервер и данные: express.

Инфраструктура и утилиты: prisma, bcrypt, cors, dotenv, jsonwebtoken, multer, openai, pg, next, swiper, zustand, eslint.

Распределение языков в репозитории: HTML (57.3%), TypeScript (35.2%), CSS (3.5%), JavaScript (2.7%), Shell (1.1%), MDX (0.2%), Dockerfile (0.1%).

Слои разделены так, чтобы UI не знал деталей транспорта: адаптеры API/хранилища, доменные типы, компоненты представления. Это упрощает замену бэкенда и точечные UX-правки.

Ключевые функции

• prisma — использован в продуктовой логике: снижает количество самописного кода и ускоряет добавление новых экранов.
• bcrypt — использован в продуктовой логике: снижает количество самописного кода и ускоряет добавление новых экранов.
• cors — использован в продуктовой логике: снижает количество самописного кода и ускоряет добавление новых экранов.
• dotenv — использован в продуктовой логике: снижает количество самописного кода и ускоряет добавление новых экранов.
• express — использован в продуктовой логике: снижает количество самописного кода и ускоряет добавление новых экранов.
• jsonwebtoken — использован в продуктовой логике: снижает количество самописного кода и ускоряет добавление новых экранов.
• multer — использован в продуктовой логике: снижает количество самописного кода и ускоряет добавление новых экранов.
• openai — использован в продуктовой логике: снижает количество самописного кода и ускоряет добавление новых экранов.

Дополнительно:

• Интеграция и использование prisma в продуктовой логике и интерфейсе.
• Интеграция и использование bcrypt в продуктовой логике и интерфейсе.
• Интеграция и использование cors в продуктовой логике и интерфейсе.

Результат

MVP уже покрывает ключевой сценарий; дальше — расширение отчётности, тестов и мониторинга.

Исходный код открыт: https://github.com/astropsy999/pamyatay-pro — можно оценить структуру модулей и стиль коммитов.

Интерактивное демо доступно по ссылке выше — можно проверить UX без развёртывания локально.

Что бы улучшил

Следующий шаг — observability (логи/метрики), автотесты на регресс и документация API для интеграторов. Для high-load сценариев — профилирование узких мест и кеширование справочников.