{"id":21577439,"url":"https://github.com/daniarmakyev/shaar","last_synced_at":"2026-04-10T13:31:43.645Z","repository":{"id":264325708,"uuid":"893049347","full_name":"daniarmakyev/Shaar","owner":"daniarmakyev","description":"Shaar is a website to boost tourism in Bishkek with maps, routes, and customizable parking.","archived":false,"fork":false,"pushed_at":"2025-06-10T14:51:32.000Z","size":17719,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-10T13:33:11.972Z","etag":null,"topics":["framer-motion","google-maps-api","i18next","jotai","jwt","react","react-query","tailwind","typescript","vite"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/daniarmakyev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-11-23T11:59:45.000Z","updated_at":"2025-09-03T08:19:11.000Z","dependencies_parsed_at":"2024-12-21T16:31:13.245Z","dependency_job_id":"481fe7db-d017-4b59-9d4a-6dfaa17d7d4c","html_url":"https://github.com/daniarmakyev/Shaar","commit_stats":null,"previous_names":["daniarmakyev/shaar"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/daniarmakyev/Shaar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daniarmakyev%2FShaar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daniarmakyev%2FShaar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daniarmakyev%2FShaar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daniarmakyev%2FShaar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daniarmakyev","download_url":"https://codeload.github.com/daniarmakyev/Shaar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daniarmakyev%2FShaar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279004060,"owners_count":26083667,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["framer-motion","google-maps-api","i18next","jotai","jwt","react","react-query","tailwind","typescript","vite"],"created_at":"2024-11-24T13:04:28.348Z","updated_at":"2025-10-10T13:33:31.377Z","avatar_url":"https://github.com/daniarmakyev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Shaar\nПерейти на сайт Shaar: https://shaar-tau.vercel.app/welcome\n\nБэкэнд : https://github.com/daniarmakyev/ShaarBackCleanArch\n\nВеб-приложение, направленное на улучшение туристического опыта в Бишкеке с использованием современных технологий фронтенд-разработки и интеграции с Google Maps API.\n\nСайт был разработан за 24 часа в рамках хакатона на мероприятии **IT-Fest** в Бишкеке, организованном мэрией с целью развития молодежи города, включая студентов университетов и колледжей.\n\n---\n\n## Основные зоны проекта\n\n### 1. Туристические маршруты\n\u003cimg src=\"./src/assets/md/mapmIni.png\" alt=\"Пример маршрута на карте\" width=\"400\" height=\"700\"/\u003e  \n\u003cimg src=\"./src/assets/md/mapBig.png\" alt=\"Пример маршрута на карте\" width=\"1920\" height=\"550\"/\u003e  \n\n**Описание:**  \n- Построение кастомных маршрутов на основе туров.\n- Отображение ключевых точек маршрута с полным описанием (время, дистанция, описание).\n- Интеграция поиска Google Maps.  \n\n---\n\n### 2. Парковки\n\u003cimg src=\"./src/assets/md/parking.png\" alt=\"Карта парковок с полигонами\" width=\"1920\" height=\"550\"/\u003e  \n\n**Описание:**  \n- Карты с зонами парковки, обозначенными зелёными полигонами.\n- Метки на парковках с информацией о стоимости, дистанции и возможностью построить маршрут.\n- **Конструктор парковок**: возможность вручную создавать собственные парковочные зоны, рисовать полигоны и добавлять метки без кода.  \n\n---\n\n### 3. События\n\u003cimg src=\"./src/assets/md/event.png\" alt=\"Пример страницы календаря\" width=\"1920\" height=\"550\"/\u003e  \n\n**Описание:**  \n- Страница с календарём ближайших мероприятий в Бишкеке.  \n- Интерактивный интерфейс для просмотра и фильтрации событий (функционал в разработке).  \n\n---\n\n### 4. Конструктор парковок\n\u003cimg src=\"./src/assets/md/parking.png\" alt=\"Интерфейс конструктора парковок\" width=\"1920\" height=\"550\"/\u003e   \n\n**Описание:**  \n- Полностью интерактивный инструмент для добавления новых зон парковки.\n- Рисование полигонов вручную прямо на карте.\n- Добавление пользовательских меток с детальной информацией.  \n\n---\n\n### 5. Регистрация и авторизация\n\u003cimg src=\"./src/assets/md/login.png\" alt=\"Логин\" width=\"1920\" height=\"550\"/\u003e    \n\u003cimg src=\"./src/assets/md/registerMini.png\" alt=\"Логин\" width=\"320\" height=\"550\"/\u003e \n\nДля использования функционала приложения предусмотрены следующие возможности регистрации и логина:\n\n- **JWT Токены** используются для авторизации пользователей.\n- Процесс регистрации:\n  - Пользователь создаёт аккаунт с помощью email и пароля.\n  - После успешной регистрации на сервер отправляется запрос для генерации JWT токена.\n- Процесс логина:\n  - Пользователь вводит email и пароль.\n  - Сервер отправляет JWT токен, который сохраняется в **localStorage**.\n  - Этот токен используется для аутентификации на всех последующих запросах.\n\n---\n\n## Технологии и функционал\n\nПриложение построено на **React** с использованием **TypeScript**. Карты реализованы через Google Maps API и визуализированы с помощью **@vis.gl/react-google-maps**. Используются библиотеки для управления состоянием, мультиязычности и работы с запросами.\n\n### Основные зависимости:\n- **Google Maps API**\n- **Tailwind CSS**\n- **React Hook Form**\n- **Framer Motion**\n- **JWT (JSON Web Tokens)** для аутентификации и авторизации пользователей\n\n\n## Галерея\n\nЗдесь представлены фотографии и скриншоты, иллюстрирующие функционал и дизайн нашего проекта.\n\n### Боковое меню / навигация\n\u003cimg src=\"./src/assets/md/sidebar.png\" alt=\"сайдбар\" width=\"400\" height=\"650\"/\u003e\n\n### Главное меню\n\u003cimg src=\"./src/assets/md/main.png\" alt=\"главное меню\" width=\"1920\" height=\"550\"/\u003e  \n\n### Страница привествия /welcome\n\u003cimg src=\"./src/assets/md/welcome.png\" alt=\"главное меню\" width=\"320\" height=\"650\"/\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaniarmakyev%2Fshaar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaniarmakyev%2Fshaar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaniarmakyev%2Fshaar/lists"}