справочник ОКВЭД okvedik.ru

Что реализовано

Описание проекта

OKVEDIK помогает быстро разобраться с кодами ОКВЭД без чтения длинных классификаторов и случайных статей из поиска. Сервис собирает справочник, поиск, карточки кодов, тематический контент и AI-помощника в одном интерфейсе.

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

Публичная часть

• Главная страница платформы.
• Каталог ОКВЭД.
• Детальные страницы кодов ОКВЭД.
• Поиск по кодам и описаниям.
• Региональные страницы ОКВЭД.
• Страница избранных кодов.
• AI-селектор кодов по описанию деятельности.
• Раздел лицензирования.
• Детальные страницы лицензий.
• Раздел сертификации.
• Детальные страницы сертификаций.
• Блог и страницы статей.
• Страницы о проекте, контактов и политики конфиденциальности.
• Страница статуса sitemap.

Поиск и подбор ОКВЭД

• REST API для каталога ОКВЭД.
• Поиск через PostgreSQL FTS.
• Ранжирование результатов.
• Валидация поисковых запросов.
• Логирование поисковой аналитики.
• Сервис импорта и проверки данных ОКВЭД.
• Генерация fallback-данных для локального наполнения.
• CLI для импорта ОКВЭД.
• CLI для переиндексации поиска.

AI-инструменты

• AI-подбор кодов через /api/v1/ai/select.
• AI-подсказки через /api/v1/ai/suggest.
• Интеграция с OpenRouter.
• Настраиваемые модели через env.
• Кэширование AI-ответов.
• Логирование AI-подборов.
• Контроль бюджета AI-запросов.
• Отдельный слой промптов для AI-селектора.

Контент и SEO

• SEO-страницы для справочника и тематических разделов.
• Blog CMS на backend-данных.
• Markdown-контент для статей.
• Лицензионные материалы.
• Материалы по сертификации.
• Генерация SEO-лендингов из Wordstat-данных.
• Генерация sitemap.
• Sitemap index.
• Защищенная ревалидация контента.
• Schema.org разметка.
• Поддержка Yandex Metrika, Google Analytics и verification-тегов через env.

Экспорт и данные

• Экспорт выбранных кодов.
• Общие TypeScript-контракты между frontend и backend.
• Pydantic-схемы для runtime-валидации API.
• Совместимость backend-схем и shared TypeScript-типов.
• PostgreSQL как основная база данных.
• Redis для инфраструктурных задач и кэша.
• Alembic-миграции.
• Фоновые задачи через APScheduler.
• CLI для seed-данных блога, лицензий и сертификаций.

Инфраструктура

• Docker-first запуск проекта.
• Docker Compose для локальной разработки.
• Отдельный compose-файл для VPS.
• Production-деплой за host nginx.
• Публичный сайт https://okvedik.ru.
• Публичный API https://okvedik.ru/api/v1.
• GitHub Actions для CI.
• Release smoke-скрипт.
• Runbook для релиза и отката.
• Env-контракты для web, api, PostgreSQL, Redis и AI-интеграций.

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

• Next.js 15, App Router.
• React 19.
• TypeScript.
• Tailwind CSS 4.
• class-variance-authority.
• clsx и tailwind-merge.
• Motion.
• Lucide React.
• schema-dts.
• Vitest.
• Python 3.11.
• FastAPI.
• SQLAlchemy 2 async.
• Pydantic v2.
• pydantic-settings.
• Alembic.
• PostgreSQL.
• Redis.
• APScheduler.
• OpenRouter API.
• httpx.
• BeautifulSoup и lxml.
• ReportLab.
• OpenPyXL.
• Bleach и Markdown.
• Prometheus client.
• Poetry.
• Ruff, mypy и pytest.
• Docker и Docker Compose.
• GitHub Actions.

Роль в проекте

Разработана архитектура платформы, frontend на Next.js, backend на FastAPI, API-контракты, поиск, импорт ОКВЭД, AI-селектор, SEO-разделы, блог, лицензии, сертификация, экспорт, фоновые и CLI-задачи, Docker-инфраструктура и production-подготовка для VPS.