Skip to content

ShibaInuChan/local-community

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

地域コミュニティポイントシステム

地域コミュニティ向け・超ローコスト地域通貨システム(開発中)

概要

ボランティアや街のお手伝い活動への貢献を「感謝ポイント」として可視化し、コミュニティ内のサービスオプションを解放するシステムです。

ユーザーは LINE だけで操作でき、ブロックチェーンなどの技術的な複雑さは一切露出しません。

メンバー:「残高確認」と送る
Bot     :「🥇 あなたの感謝ポイント / 残高: 120pt / ランク: Silver」と返す

現在の状態

⚠️ モックプロトタイプ(開発中)

  • ポイントの発行・残高確認・ランク表示はLINE上で動作します
  • ブロックチェーン接続は未実装(サーバー再起動でリセットされます)
  • 本番運用には対応していません

システム設計

3つの持続可能な設計原則

① 法務リスクをゼロにする ポイントの役割を「コミュニティ内の権限解放」に限定し、円への換金・物品購入は不可とすることで資金決済法の対象外にします。

② インフラコストを極限まで下げる Polygon(パブリックブロックチェーン)を直接利用。1回あたり数円以下のガス代のみで動作します。

③ LINEで操作を完結させる メンバーはウォレットやブロックチェーンを意識する必要がありません。

ランク制度

ランク 必要ポイント 特典
🥉 Bronze 0〜99pt 基本メンバー
🥈 Silver 100〜499pt 共有備品の優先レンタル権
🥇 Gold 500〜1999pt お手伝い依頼の優先マッチング
💎 Platinum 2000pt〜 コミュニティ運営への参加権

技術スタック

レイヤー 技術
ユーザーUI LINE Messaging API
バックエンド Node.js / Express
ブロックチェーン連携 ethers.js v6
スマートコントラクト Solidity 0.8.20 / OpenZeppelin ERC-20
ネットワーク(予定) Polygon(Amoy testnet → mainnet)
クラウド(予定) Railway
管理者向け(予定) Google スプレッドシート連携

LINEコマンド一覧

メンバー向け

コマンド 説明
残高確認 現在のポイントとランクを表示
ステータス ランク特典の一覧を表示
登録 [お名前] 自分の名前を登録する(例:登録 田中
使い方 コマンド一覧を表示

管理者向け

コマンド 説明
ありがとう [お名前] [活動内容] ポイントを付与する(例:ありがとう 田中さん 草むしり
減価設定 [周期日数] [減価率%] [通知日数] 減価パラメータを変更する(例:減価設定 30 10 3
減価確認 現在の減価設定を表示

セットアップ

必要なもの

  • Node.js v18以上
  • LINE Developers アカウント(Messaging API チャネル)

手順

# リポジトリをクローン
git clone https://github.com/shibainuchan/local-community.git
cd local-community/backend

# 依存関係をインストール
npm install

# 環境変数を設定
cp ../.env.example .env
# .env を編集して LINE_CHANNEL_ACCESS_TOKEN と LINE_CHANNEL_SECRET を設定

# サーバーを起動(CONTRACT_ADDRESS 未設定でモックモードで動作)
node index.js

ロードマップ

  • LINEコマンドの基本実装(残高確認・ポイント付与・ランク表示)
  • メンバー名前登録・対象者特定ロジック
  • スマートコントラクト減価設計(decayPeriod / decayRate / decayNotifyDays
  • Polygon Amoy テストネットへのデプロイ
  • クラウド移行(Railway)
  • マルチコミュニティ対応(複数地域・複数LINE チャネル)
  • Google スプレッドシート連携(管理者向けメンバー一覧)
  • 管理者向けWebダッシュボード

ライセンス

MIT

About

A LINE-based community points system where residents earn "gratitude points" for volunteer activities, with rank tiers and privilege unlocks — built on Polygon blockchain with near-zero infrastructure cost.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors