バーコード/QR の読み取り・生成を提供する静的 WebUI + Lambda API。
公開サイト: GitHub Pages
https://uchimanajet7.github.io/scanforge/- fork で公開する場合は自分の Pages の URL を使用し、初回設定は
docs/GETTING_STARTED.mdの 1.1 に従ってください。
- オンライン: GitHub Pages
https://uchimanajet7.github.io/scanforge/。 - ローカル:
bash scripts/tools/web/start-local-web.sh。推奨です。file://直開きではカメラ権限や Web API 制約で動作しないことがあるためです。 - ネットワーク:
start-local-web.shはSWS_VERSION未指定の場合にstatic-web-serverの最新リリース情報を取得します。未配置の場合はtools/web/static-web-serverをダウンロードして配置します。オフラインで使う場合はSWS_VERSIONを固定し、tools/web/static-web-serverを事前に配置します。- 必要ツール:
curl/tar/lsof。start-local-web.shで使用します。 - アクセス:
http://localhost:8000/。既定ポートは8000です。ポートはSWS_PORTで変更できます。
- 必要ツール:
- 備考:
start-local-web.shはキャッシュ更新のためweb/index.html内のstyles.cssとapp.jsの参照に?v=を付与します。初回はweb/index.html.originalを作成します。
操作の要点: 抜粋
- スキャン: カメラで QR / バーコードを読み取り、履歴へ追加
- 生成: テキストから QR / バーコードを生成。例: Code 128/EAN-13/UPC-A/PDF417/Data Matrix。出力: PNG/SVG。
- エージェント連携: WebMCP 対応ブラウザーでは、同じ画面状態と既存製品処理を使うコード生成、成果物の直接受信、明示時のブラウザーダウンロード、権限判断を人に残したカメラ開始・1回スキャン・停止、履歴の読取り・JSON受信を10個のサイトツールとして利用できます。生成PNG・SVG・履歴JSONは会話へ直接受信でき、明示的なブラウザーダウンロードが停止した場合も、同一成果物を
transferIdで直接受信できます。DOM操作には切り替えず、画面ボタンは直接受信も利用できない場合の最終手段です。通常画面へWebMCP専用UIは追加しません。利用条件と通常利用による確認手順はdocs/WEB_DEV_GUIDE.mdを参照してください。
- 対話:
bash scripts/deploy/with_aws.sh -- bash scripts/deploy/deploy.sh。推奨です。 - 固定プロファイル:
bash scripts/deploy/with_aws.sh --mode profile --profile <WORK_PROFILE> -- bash scripts/deploy/deploy.sh - スモーク:
bash scripts/deploy/smoke.sh。デプロイ済みの状態で readiness →/encode→/decodeを確認します。
- 起動:
bash scripts/tools/api/start-local-api.sh。既定URLはhttp://127.0.0.1:8001です。- ネットワーク: 初回セットアップでは
lambda/requirements.txtの依存を pip で取得するため必要です。
- ネットワーク: 初回セットアップでは
- 必要ツール:
python3/pip/lsofはstart-local-api.shで使用します。curl/base64/jqはsmoke-api.shとstart-local-api.sh --autoで使用します。 - スモーク:
bash scripts/tools/api/smoke-api.sh。/encode→/decodeの往復を確認します。 - 自動:
bash scripts/tools/api/start-local-api.sh --auto。起動→スモーク→停止を一括で行います。
docs/DEV_SETUP.md- 例
bash scripts/tools/lint_shell.sh --strictbash scripts/tools/fmt_terraform.sh --checkbash scripts/tools/fmt_terraform.sh --validate
web/… WebUI: 静的配信 / GitHub Pageslambda/… API ハンドラー:handler.py。依存:requirements.txtinfra/terraform/… IaC: Terraformscripts/… 開発/デプロイ補助docs/… 仕様・ガイド
- はじめに:
docs/GETTING_STARTED.md - デプロイ手順・トラブルシュート:
docs/DEPLOY.md - 仕様: 構成/ラッパー仕様/API。
docs/SPEC.md - WebMCP 仕様:
docs/WEBMCP_SPEC.md - WebUI 開発・WebMCP 確認:
docs/WEB_DEV_GUIDE.md - バージョン運用:
docs/VERSIONS.md
- MIT License:
LICENSE
- ScanForge:WebUI でバーコード生成して AWS Lambda でスキャンする: https://uchimanajet7.hatenablog.com/entry/2025/12/21/150000