convez.ai
MCP Server
pikuto1125-pixel

misho

pikuto1125-pixel/misho

Ver no GitHub
InicialPluginScore · de 0 a 100

実生(Misho)— 接ぎ木でなく、種から。日本の個人開発者向け Stripe 直販レール OSS(特商法・インボイス・凍結リスク機械チェック内蔵 / CF Workers + D1 + R2 / MCP + Claude Code skill)

Instalação

$npx convez-ai pikuto1125-pixel/misho

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

実生(みしょう / Misho)

接ぎ木でなく、種から。

野鍛冶 — Nokaji(個人の仕事道具を打つ工房)の道具のひとつ。

実生(みしょう)とは、接ぎ木ではなく種から自力で育った木のこと。 誰かの台木(プラットフォーム)に接がれて 22% を払い続けるのではなく、 自分の種から、自分の根で育つ商売を。

実生は、日本の個人開発者が自分の Stripe アカウントでデジタル商品を直販するための OSS レール。 「作る」は Claude Code が解決した。残った壁は「売る」—— Stripe 本番審査・アカウント凍結・特商法の住所公開・インボイス対応。 実生は checkout の配管と一緒に、日本の法対応を機械チェック可能な形で同梱する。

設計原則

  1. 金に触れない:決済は Stripe Checkout(ホスト型)のみ。カード情報はこのコードを一切通らない。hosted 版でも資金は Stripe が直接分配し、運営者の手元を通らない(資金移動業に該当しない構造)
  2. 二値で検証する:法対応は「適合か否か」。実在した審査落ち 13 パターンを負変異テストとして固定し、生成物が全パターンを検出できることを CI で保証する
  3. 管理画面を作らない:運用は MCP / Claude Code skill から自然言語で(「今月の売上見せて」「商品追加して」)
  4. ¥0 で動く:Cloudflare Workers + D1 + R2 の無料枠で完結
  5. 盛らない:「審査に必ず通る」とは言わない。通過事例のチェックリストを機械化しただけ。本プロジェクトは法的助言を提供しない

料金の考え方(手数料を選べるレール)

形態実生の取り分売り手の総コスト用途
self-host(自分で deploy)0%Stripe 3.6% のみ種から自分で育てる人
hosted(実生が運用)2%5.6%(= BOOTH 並みで自分の店)楽に始めたい人
hosted + 銀行振込ルート2%(月締め)2% のみ高単価・B2B(バーチャル口座 + Webhook 自動照合・v0.2)

比較:ココナラ 22% / note 約 15% / BOOTH 5.6%。

構成

core/
  src/
    keygen.js     ライセンスキー生成・検証(Crockford Base32 + checksum)
    token.js      署名付き DL トークン(HMAC-SHA256・期限付き)
    webhook.js    Stripe webhook 署名検証(fail-closed)+ 注文/ライセンス発行(冪等)
    receipt.js    領収書/適格請求書データ生成(インボイス 6 要件・JPY 整数演算)
    checkout.js   Checkout Session パラメータ生成 + 凍結リスク lint + Connect 手数料
    stripeform.js Stripe REST bracket 記法 encoder(依存ゼロ・Connect 対応)
    store.js      ストア interface(テスト用 in-memory / 本番 D1 アダプタ)
  legal/
    templates.js  特商法(通常/省略方式)・利用規約(AI 条項)・プライバシーポリシー生成
    checklist.js  機械コンプライアンスチェック(実在事故 13 パターン + 設定 lint)
worker/
  src/app.js      HTTP ルーター(DI 設計・起動時コンプライアンス gate・admin API)
  src/d1store.js  D1 アダプタ(UNIQUE 制約 + 条件付き UPDATE で race を DB 層で閉鎖)
  src/index.js    Cloudflare Workers エントリ
  schema.sql      D1 schema
mcp/              MCP server(売上・注文・コンプライアンスを Claude から操作)
skills/           Claude Code setup skill(非エンジニア向け対話セットアップ)

status

  • 需要・競合・法構造リサーチ(6 波)
  • 名称確定「実生(Misho)」— J-PlatPat 称呼照会 0 件・npm misho 空き(結/継/楔/締/実(みのり) は衝突検証で却下の系譜)
  • コア純関数層 + 機械テスト(負変異 19 本含む)
  • HTTP ルーター + 一連フロー E2E テスト + admin API
  • Stripe Connect 2% プラットフォーム手数料(hosted のみ・self-host は 0)
  • MCP server + setup skill
  • Cloudflare Workers エントリ + D1 schema
  • Stripe テストモード実 E2E(2026-06-12・wrangler dev + ローカル D1/R2 + 実 Stripe API) — checkout → Playwright 実ブラウザ 4242 決済 → 実署名 webhook → license 発行 → 署名付き DL(バイト一致)→ 領収書 → admin API → 再送冪等性 まで全通し — 発見バグ 1 件修正:配信失敗(R2 不在/例外)時に DL 枠を消費していた → restoreDownload で失敗時返却(実 D1 で障害シミュレーション検証済み)
  • 第一号テナント移管(テストモード):実キット PDF(660KB・日本語 filename RFC 5987 配信)で購入→DL 全通し
  • CF Workers 本番 deploy(2026-06-12・本番フル E2E 実証済・テストキー運用)
  • fresh-context 独立監査(2026-06-12・🔴 BLOCKING 0 件で GO。指摘 S-1 = インボイス config 参照パス不整合は修正済 + 回帰テスト追加)
  • Connect プラットフォーム申請の審査完了 → 本番キー切替(hosted 稼働前に必須)
  • 銀行振込 0% ルート(GMO あおぞら バーチャル口座 + Webhook)v0.2

テスト: npm test → 95 pass / 0 fail

⚠️ 観測メモ:wrangler dev(miniflare)の cold start 直後 1-2 リクエストでレスポンスボディが途切れる事象を 1 度観測(以後再現せず・本番 Workers とは別系統)。本番 deploy 後の verify で要再確認。

License

MIT

Ver o original no GitHub

Bom para

Relacionados