地域通貨決済アプリ

Capacitor + バニラ JavaScript で構成した、地域通貨の送金・受取アプリです。
QRコードを表示/スキャンして送金・受取を行います。

LETS（Local Exchange Trading System）とは

LETS は、地域の参加者どうしが「相互の信用」をもとに取引を行う地域通貨の仕組みです。
法定通貨の現金を直接やり取りしなくても、地域内で提供した価値（サービス・モノなど）を記録し、 必要なときに別の参加者から価値を受け取れるようにすることを目的としています。

仕組み

• 参加者ごとに取引記録（台帳）を持つ
• 取引時に「渡した側はプラス」「受け取った側はマイナス」として残高を更新する
• 単なる二者間の物々交換ではなく、ネットワーク全体で価値を循環させる
• 通常は地域内で使える範囲やルール（上限・用途など）を決めて運用する

このアプリでは、上記の考え方を学習・体験しやすい形にして、QRコードで送金/受取を記録します。

概要

LETS の狙いは、地域内の助け合いを可視化し、資源やスキルの循環を促進することです。
一般的なポイント制度と異なり、参加者間の取引そのものを中心に設計される点が特徴です。

歴史

LETS は 1980 年代前半、カナダのマイケル・リントン（Michael Linton）による実践が広く知られています。
その後、英国・豪州・欧州などに考え方が広がり、地域経済の補完手段としてさまざまな形で運用されてきました。
近年は、紙の台帳や手書き記録に加え、デジタル台帳やモバイルアプリを使った地域通貨の試みも増えています。

機能

• 残高表示
• 取引履歴表示
• 送金QRを表示（相手がスキャンして受取）
• 受取QRを表示（相手がスキャンして送金）
• QRスキャンによる送金/受取（ネイティブ時は ML Kit を利用）
• QR画像の保存

技術スタック

• Capacitor
• バニラ JavaScript
• HTML / CSS
• QRCode（CDN読み込み）
• @capacitor-mlkit/barcode-scanning

セットアップ

npm install

Webで起動

npm run dev

http://localhost:5173 を開いて動作確認します。

iOS / Android での実行

npx cap add ios
npx cap add android
npm run cap:sync
npm run cap:open:ios
npm run cap:open:android

画面

• ホーム: 残高・履歴
• 送金: 送金QRの作成・保存
• 受取: 受取QRの作成・保存
• スキャン: カメラスキャン/手動入力

注意

• 初期残高は 10000 LC です。
• データは localStorage に保存されます。
• 実運用向けの署名検証・改ざん対策・サーバー連携は未実装です。

画面ScreenShot

ライセンス

本アプリは「独自ライセンス」に基づき公開しています。

ライセンス内容

• 利用・複製・改変：自由に行えます。
• 配布・再配布：禁止します。
• 商用利用：禁止します。
• 著作権表示：本アプリの著作権表示を削除しないでください。
• 無保証：本アプリの利用によるいかなる損害も、作者は一切責任を負いません。

詳細説明

本アプリのソースコードおよび成果物は、個人または組織内での利用・複製・改変は許可しますが、 第三者への配布や再配布、または商用目的での利用・販売・公開は禁止します。 また、著作権表示および本ライセンス文は削除せず、必ず残してください。

ご不明点があれば、リポジトリ管理者までご連絡ください。

貢献

プルリクエストを歓迎します。大きな変更の場合は、まずissueを開いて変更内容を議論してください。