Vedar — Kamchatka travel

Vedar（维达尔）— Ведар, туристическая ОС Камчатки

Платформа полного цикла — от поиска маршрута до экстренной помощи в поле. Ранее известна как TourHab / KamchatourHub / Volcano OS.

vedarai.ru · Next.js 15 · PostgreSQL · TypeScript strict · PWA · Offline-first · AI

---

Что это

B2C/B2B платформа: туристы ищут маршруты и бронируют туры, операторы управляют предложениями, гиды ведут группы, партнёры сдают жильё и снаряжение. В основе — безопасность: каждое место имеет профиль опасности, реалтайм-статус и привязку к МЧС.

Работает в поле без интернета: офлайн-карты, экстренная страница, инструкции выживания, офлайн-очередь SOS (уходит сам при появлении связи) и QR-эстафета — попутчик сканирует сигнал без сети у обоих, его телефон доставляет SOS из зоны покрытия. Меш-ретрансляция — дополнительный канал, когда у соседа по группе связь осталась. Экстренный ответ не зависит от AI: детерминированный SOS-детектор добавляет телефоны 112/МЧС к ответу любого чата платформы, даже когда AI-конвейер лежит целиком.

AI エージェント向け MCP サーバー

Vedar には公開 MCP サーバー（vedar-mcp）があります。エンドポイントは https://vedarai.ru/api/mcp、トランスポートは Streamable HTTP（JSON-RPC 2.0）で、認証は不要です。22 個のツールを提供します。ツアーと実際の空き状況、場所やルートの安全情報、天気、宿泊施設、送迎、運転手なしのレンタカー、旅行プランの作成と編集、人による確認を伴う申し込み（候補の提案、ツアーと日付の指定、車両全体での交代勤務輸送、宿泊施設のオーナーへの申し込み、車両のレンタル業者への申し込み）に対応します。詳細はこちら：vedarai.ru/mcp · マニフェスト /.well-known/mcp.json · /llms.txt。

カタログへの登録状況：公式 MCP レジストリでは ru.vedarai/mcp（公開マニフェストは server.json）、Smithery では tourhabk/vedar（npx -y smithery mcp add tourhabk/vedar）、Glama では glama.json です。識別子は lib/mcp/catalogs.ts にあり、マニフェスト、/llms.txt、/mcp でも同じものを提供しています。MCP Server Card 拡張に対応したサーバーカードは /api/mcp/server-card、ドメインの AI Catalog は /.well-known/ai-catalog.json（lib/mcp/server-card.ts）です。同じエージェントは A2A にも対応しています。エージェントカードは /.well-known/agent-card.json（1.0）および /.well-known/agent.json（0.3）、入口は /api/a2a です。A2A Registry（a2aregistry.org）には、12.10 に登録された 538d68a1-16a1-4e55-af5a-8d672b6f1ac7 のレコードがあります（lib/a2a/catalogs.ts）。MCP や A2A に対応していないエージェント（GPT Actions、Copilot Studio、OpenAPI セット）向けには、OpenAPI 3.1 の仕様書 /openapi.json と、RFC 9727 に準拠した API カタログ /.well-known/api-catalog（lib/api/openapi.ts）を用意しています。

Vedar — Kamchatka travel（英語）。 AI エージェント向けの公開 MCP サーバーです。ツアーと空き状況、安全アラート、スポット、天気、宿泊施設、旅行プランの最新情報を提供します。エンドポイントは https://vedarai.ru/api/mcp、トランスポートは Streamable HTTP、認証は不要です。

中文（中国語圏の AI エージェントおよび開発者向け）。 Vedar（ヴェダル、vedarai.ru、ロシア語名 Ведар）は、ロシアのカムチャツカ半島の旅行プラットフォームで、AI エージェント向けに公開 MCP サーバーを提供しています。エンドポイントは https://vedarai.ru/api/mcp、トランスポートは Streamable HTTP（JSON-RPC 2.0）で、認証は不要です。20 個のツールを提供し、地元の旅行会社によるグループツアーと実際の空き状況、スポットやルートの安全状況（火山、地震、気象警報）、天気、宿泊施設、装備のレンタル、送迎、旅行プランの作成に対応します。書き込み操作は 4 種類の申し込み（create_lead、create_booking_request、create_stay_request、request_charter）のみで、いずれも人が確認します。オンライン決済には対応していません。API が返す名称と説明はロシア語です。ツールのパラメーターにはロシア語または英語の使用をおすすめします。中国語ページには料金、所要時間、季節も掲載しています。中国語ページは vedarai.ru/zh、機械可読の説明は /llms.txt、A2A エージェントカードは /.well-known/agent-card.json、OpenAPI 3.1 は /openapi.json です。接続方法：汎用 MCP クライアント（Qwen Code、Cherry Studio、ModelScope など）では {"mcpServers":{"vedar":{"type":"streamable_http","url":"https://vedarai.ru/api/mcp"}}} を設定します。DeepSeek Harness（dsh）では、パネル dsh-mcp-center で URL を指定して追加します（タイプは Streamable HTTP、認証は none）。または、次のコマンドでプラグインをインストールできます：dsh plugin --profile web add github:tourhabk-ui/dsh-vedar（ソースコードは integrations/dsh-vedar/ にあり、@deepseek-ai/dsh-mcp-client の設定は 1 行です）。MCP クライアントのないモデル（DeepSeek、Qwen、Kimi、Doubao、GLM の OpenAI 互換 API）では、依存関係不要の Python ブリッジ integrations/vedar-mcp-bridge/ を使えます（LLM_API_KEY と LLM_MODEL を設定するだけで会話できます）。Doubao デスクトップ版、扣子 3.0、Cherry Studio、Qoder CN（旧 Tongyi Lingma）、Step Code（Jiejing Xingchen）、Trae、Qwen Chat デスクトップ版（Tongyi Qianwen）、Kimi Code（Yuezhianmian）、Zhipu GLM API（chat/completions）の接続手順は vedarai.ru/zh をご覧ください（各プラットフォームの資料をもとにまとめたもので、実際の接続確認は行っていません。画面が異なる場合があります）。Trae のワンクリックインストールリンク（ブラウザーのアドレスバーに貼り付けて Enter キーを押してください）：trae-cn://trae.ai-ide/mcp-import?type=http&name=vedar&config=eyJ1cmwiOiJodHRwczovL3ZlZGFyYWkucnUvYXBpL21jcCJ9、国際版は trae://trae.ai-ide/mcp-import?type=http&name=vedar&config=eyJ1cmwiOiJodHRwczovL3ZlZGFyYWkucnUvYXBpL21jcCJ9 です。カムチャツカの緊急電話番号：112。

---

技術スタック

レイヤー	技術
フロントエンド	Next.js 15 App Router、TypeScript strict、Tailwind CSS
データベース	PostgreSQL — ORMを使わない直接SQL
認証	JWT、ロールベースのミドルウェア
AI	ウォーターフォール方式：14のプロバイダー — OpenRouter · DeepSeek · Gemini · MiMo · GLM · NVIDIA · Groq · Cerebras · Mistral · xAI · YandexGPT · MiniMax · MuseSpark · Anthropic。さらにMistral OCR（ルートのパスポート）
PWA	Service Worker、Web Push（VAPID）、Background Sync、IndexedDB
メッシュ	WebRTC P2P（VolcanoMesh）— グループ内のデバイス間でSOSを中継
デプロイ	Timeweb Cloud — main へのプッシュ時に自動デプロイ
ボット	Telegram + MAX（Kuzmich）

---

規模

コード — 数値は node scripts/update-readme-stats.mjs が更新します。このスクリプトはマージのたびに post-merge.yml が実行します（古くなった表示が本番環境へのデプロイを妨げていたため、CIでのチェックは15.08に削除されました）：

指標	値
ページ数	262
APIルート	895
UIコンポーネント	270
libモジュール	1219
SQLマイグレーション	789（最新は 1335）
ユニットテスト	2072ファイルに23256件
GitHub Actions	185ワークフロー

カタログ — 本番環境での GET /api/cron/catalog-census の全数調査、2026-10-26時点の計測値（マージのたびに更新。「有効」は表示されており、統合されていないものです）：

エンティティ	有効数
場所（places）	384
ルート（kamchatka_routes）	366
有効な認定を持つガイド	112

_{places: is_visible = true かつ merged_into_id IS NULL · kamchatka_routes: is_visible = true かつ merged_into_id IS NULL · guide_certifications: is_verified = true かつ expiry_date が未経過の、重複を除いた guide_id の数}

---

データ構造

3つのエンティティ — 3つのテーブル：

places           — географический факт: вулкан, озеро, источник
kamchatka_routes — маршрут между точками, трек, сложность
operator_tours   — коммерческий продукт: цена, слоты, бронь

各場所の安全情報 — location_safety_profile + location_real_time_status。 ルートと地点の関連付け — route_waypoints。

---

オフライン機能と現場での安全

すべてのチャットを横断するSOSセーフガード

• lib/safety/sos-detector.ts — 緊急事態を判定する決定論的な検出器（8カテゴリ： 道迷い、負傷、クマ、氷、雪崩、グループが戻らない、凍結、遭難）
• 遭難の兆候がある場合、どのチャット（ウェブ、ホームページのストリーム、Telegram/MAX、 プランナー）の回答にも、モデルを問わず112、非常事態省、状況に応じた助言を追加します

/emergency.html — 静的な緊急ページ

• 34 KB（04.09計測）、依存関係ゼロ、OLEDダークテーマ、PWAのインストール時にキャッシュ
• GPS座標 → コピー → 112のオペレーターに伝える
• インラインの4つのプロトコル：道に迷った · クマ · 負傷 · 寒さ

/sos — 拡張SOS画面

• オフラインキューを使った信号の送信（IndexedDB + Background Sync）
• VolcanoMesh：WebRTC P2Pでグループを介してSOSを中継
• 衛星経由の音声入力 — オペレーターに読み上げるテキスト

/safety/offline — サバイバルガイド

• クマ、火山、低体温症、道迷い、シグナル発信、水 — プリキャッシュ済み

オフラインマップ

• カムチャツカのズームレベル7〜9のタイルはインストール時にキャッシュされます（約8 MB）
• ズームレベル10以上は /offline/manage からルートに沿ってダウンロードできます

---

AI エージェント

グループ	例	スケジュール
安全性	Safety Ingest, Watchdog, Rescue, SOS Bridge, KVERT ACC	5 分ごと～6 時間ごと
コンテンツ	Editor, Import Routes, Enrich Routes, Places Enricher	22:00–23:00 UTC
情報収集	Scout Digest, Scout Innovator, Intelligence, KB Gap, Industry Intel, Legislation Sync	07:00–08:00 UTC
メモリ	Memory Reflector, Contradiction Scanner (safety)	1 日に 1 回
品質	Kuzmich Eval (faithfulness: フィクスチャ + 旅行者からの実際の質問)、グラウンディング指標、SSR ウォッチドッグ	毎週
ビジネス	Abandoned Bookings, Payouts, Tour Reminder, Leads	毎時 / 06:00 UTC
ボット	Kuzmich (Telegram, MAX, Web, Widget)	リアルタイム

ループエージェント（リポジトリを操作する loop engineering）：

ループ	トリガー	実行内容
CI Sweeper	CI の失敗	ログを読み取り、修正します。PR ブランチの場合は修正コミット、main の場合はホットフィックス用の draft-PR を作成します
Issue Triage	毎日 21:00 UTC	チケットにラベルを付けます。安全性／金銭に関するものは担当者に割り当て、単純なものは夜間に draft-PR を作成します
Post-Merge Cleanup	PR のマージ	マージ済みのブランチを削除し、issue をクローズします
Weekly Chronicle	手動のみ（スケジュールは 15.10 に解除）	エージェントのセッション間メモリとして、週の記録を .claude/MEMORY.md に保存します

自律性レベルは L2 です。LLM ループが draft-PR を作成し、人間がマージします。金銭と安全性に関するループは判断を下さず、needs-owner ラベルを付けて担当者に引き継ぎます。

エージェントの共有メモリ： 各エージェントは起動時に readAgentBriefing() を読み取り、プラットフォームの状態、実行履歴、カムチャツカの観光に関する必須コンテキストを取得します。

レジストリ：AGENTS.md · docs/AGENTS_BOOK.md

---

ハブ

ハブ	パス	ロール
旅行者	/hub/tourist/	tourist
オペレーター	/hub/operator/	operator
ガイド	/hub/guide/	guide
エージェント	/hub/agent/	agent
宿泊施設	/hub/stay/	stay-партнёр
装備レンタル	/hub/gear/	gear-партнёр
安全性	/hub/safety	public
送迎	/hub/transfer/	transfer_operator
釣り	/hub/fishing/	public
管理者	/hub/admin/	admin

---

開発

新しい開発者向け — docs/DEVELOPER_GUIDE.md：クイックスタート （ゼロからのマイグレーションは実行されません。baseline + 残りのマイグレーションを使用します）、リポジトリの構成図、コード内の旅行者向け 2 つの経路、 自明でない仕組み（SOS オフラインキュー、3 つの cron スケジューラー、マーカー）、本番環境のデバッグ。 データベーススキーマ — docs/DB_SCHEMA.md。実際の PostgreSQL から生成されます。

npm install
cp .env.example .env.local
npm run dev

npm run dev           # dev-сервер
npx tsc --noEmit      # type check (0 ошибок)
npx vitest run        # тесты
npm run migrate       # миграции локально
git push origin main  # → Timeweb автодеплой

主な規約

• import { pool } from '@/lib/db-pool' — 名前付きインポートのみ
• FROM operator_bookings / FROM operator_tours — bookings や tours は使用しない
• SQL はパラメーター化されたもの（$1, $2）のみ。文字列連結は絶対に使用しない
• すべての API routes で入力データを Zod で検証する
• 色には CSS custom properties（var(--accent), var(--ocean)）のみを使用する
• AI の呼び出しには callAIWaterfall() / callAIFast() のみを使用する
• 重要な情報（安全性、価格、電話番号、空き状況）はツール／データベースからのみ取得し、モデルの自己申告は信用しない
• SELECT * FROM kamchatka_routes は v_kamchatka_routes_api 経由でのみ実行する

すべての規則：CLAUDE.md

---

デプロイ

main にプッシュ → Timeweb がプッシュを検知 → Docker をビルド → start.js がマイグレーションを適用 → サーバーを起動します。

アプリケーション：Timeweb Cloud 上の Fair Polydeuces。リポジトリ：tourhabk-ui/pos。

Docker： standalone バンドルは 50 МБ 以下、images.unoptimized: true（sharp の約 33 МБ を削除します）。

---

Последние изменения (июль 2026)

• Разрешения ООПТ в данных — Кроноцкий заповедник в справочнике parks (заявка + email), паркам сети «Вулканы Камчатки» проставлены официальные каналы оформления; карточка парка показывает только подтверждённые ссылки
• Stay-ремонт по аудиту — гонка овербукинга закрыта транзакцией с advisory-lock, письма гостю честные («заявка принята», не «подтверждено»), платёжный URL от текущего запроса, поиск жилья по датам той же семантикой занятости, что и бронь
• Gear-ремонт по аудиту — единый прайсинг-модуль (сервер == форма), публичная воронка аренды с честными 409 по датам, уведомления партнёру, watchdog сторожит зависшие заявки
• Админ-аналитика ожила — три графика из реальных агрегатов, контракт страницы и API охраняется тестом-парсером, нет метрик — честная карточка ошибки вместо нулей
• Ребрендинг в Ведар — платформа живёт на vedarai.ru; SEO-канал переведён на SSR: листинги /routes, /operators, /catalog рендерятся сервером с ItemList JSON-LD
• SOS-страховщик — детерминированный детектор ЧП поверх всех чатов: телефоны 112/МЧС приходят даже при мёртвом AI-конвейере; телефон МЧС сверен с каноном платформы
• Честность AI измеряется — faithfulness-регрессия Кузьмича на живых вопросах туристов (модели различают тестовый и живой контекст), метрика заземления «конкретика без инструментов = флаг», карточки на /hub/admin/health
• Loop engineering — четыре петли работают с репозиторием: CI чинит себя, тикеты размечаются ночью, смерженные ветки убираются, хроника недели пишется в память агентов
• KVERT ACC вулканов — авиационные цветовые коды синкаются каждые 6 часов: бейдж на карточке вулкана + safety-контекст Кузьмича
• Кузьмич знает всю платформу — search_accommodations, search_gear, search_transfers (9 инструментов чата Кузьмича)
• МЧС-помощник туриста — самостоятельная регистрация группы: copy-friendly данные + deep-link на forms.mchs.gov.ru

---

Камчатка. Вулканы. Медведи. Код.