1つのシナリオが、チュートリアルにも、マニュアルにも、テストにもなる。
tessvia は、サービス横断のチュートリアル配信・自動マニュアル生成・E2Eテストを、単一のシナリオ正本から導出する基盤です。
アーキテクチャで見る tessvia
シナリオから導出される投影（tutorial・manual・scenario-test）
コアパッケージ構成（core・react・adapter）
シナリオの単一正本（immutable revision 管理）
コア機能
配信・UI・実行基盤をパッケージごとに分離し、React非依存のコアロジックを中心に構成しています。
utt-core（React非依存コア）
シナリオ schema（zod）と TutorialEngine による start/next/skip/complete のステップ制御、audience/trigger 判定を提供します。
utt-react（UI層）
TutorialProvider・useTutorial フックと、Overlay / Spotlight / Tooltip / CenterModal / BottomSheet などの UI コンポーネント一式を提供します。
utt-adapter
data-tutorial-target 解決・アクション registry・進捗 store（remote/local）・HTTP サービスクライアントを提供する React 非依存アダプタです。
tutorial-service（配信API）
Node 標準 http のみで実装した配信・進捗管理サービス。シナリオ CRUD とサービス別の配信・進捗記録を DynamoDB で管理します。
なぜ tessvia か
サービスごとの再実装をなくす
promptflow など複数サービスが SDK を組み込むだけで、同じ配信基盤・進捗管理の仕組みを再利用できます。
1つのシナリオから複数の成果物
オーサリングしたシナリオが、アプリ内チュートリアル・自動生成マニュアル・E2Eテストとして同時に導出されます（単一正本設計）。
DOMセレクタを配信JSONに含めない設計
targetId をアプリ側の Target Registry で解決するため、配信データが DOM 構造に直接依存しません。
Onion SSOによるセキュアな認証
オーサリング・管理画面は Onion（OAuth 2.0 + PKCE）でログインします。
AIコストを統制した自動生成
マニュアルの自動生成は Anthropic 従量課金 API を使わず、コスト上限の設定や社内ローカル LLM（$0 構成）を含む複数プロバイダで運用します。
こんな人におすすめ
サービス横断でオンボーディング・マニュアル・テストを扱うチームに向いています。
プロダクトチーム / PM
複数サービスのオンボーディングやアプリ内ガイドを一元管理したいチーム。
フロントエンドエンジニア
utt-react / utt-adapter を SDK として組み込み、自社アプリにチュートリアルを追加したい開発者。
QA / テスト管理者
チュートリアルシナリオをそのまま E2E テスト（Playwright）として再利用したいチーム。
マニュアル作成担当
操作シナリオから自動生成されたマニュアルを管理・公開したい担当者。
配信JSONにセレクタを持たせない。それが、変化に強いチュートリアル基盤の土台になる。
よくある質問
utt-adapter の HTTP サービスクライアントが中央の tutorial-service（配信API）と通信し、サービスごとにシナリオ・進捗を配信します。
tessvia を使ってみる
SDK を組み込んで、1つのシナリオからチュートリアル・マニュアル・E2Eテストを配信しましょう。