misho
pikuto1125-pixel/misho
実生(Misho)— 接ぎ木でなく、種から。日本の個人開発者向け Stripe 直販レール OSS(特商法・インボイス・凍結リスク機械チェック内蔵 / CF Workers + D1 + R2 / MCP + Claude Code skill)
Instalação
npx convez-ai pikuto1125-pixel/misho1 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
README
A tradução para o português deste README ainda está na fila.
実生(みしょう / Misho)
接ぎ木でなく、種から。
野鍛冶 — Nokaji(個人の仕事道具を打つ工房)の道具のひとつ。
実生(みしょう)とは、接ぎ木ではなく種から自力で育った木のこと。 誰かの台木(プラットフォーム)に接がれて 22% を払い続けるのではなく、 自分の種から、自分の根で育つ商売を。
実生は、日本の個人開発者が自分の Stripe アカウントでデジタル商品を直販するための OSS レール。 「作る」は Claude Code が解決した。残った壁は「売る」—— Stripe 本番審査・アカウント凍結・特商法の住所公開・インボイス対応。 実生は checkout の配管と一緒に、日本の法対応を機械チェック可能な形で同梱する。
設計原則
- 金に触れない:決済は Stripe Checkout(ホスト型)のみ。カード情報はこのコードを一切通らない。hosted 版でも資金は Stripe が直接分配し、運営者の手元を通らない(資金移動業に該当しない構造)
- 二値で検証する:法対応は「適合か否か」。実在した審査落ち 13 パターンを負変異テストとして固定し、生成物が全パターンを検出できることを CI で保証する
- 管理画面を作らない:運用は MCP / Claude Code skill から自然言語で(「今月の売上見せて」「商品追加して」)
- ¥0 で動く:Cloudflare Workers + D1 + R2 の無料枠で完結
- 盛らない:「審査に必ず通る」とは言わない。通過事例のチェックリストを機械化しただけ。本プロジェクトは法的助言を提供しない
料金の考え方(手数料を選べるレール)
| 形態 | 実生の取り分 | 売り手の総コスト | 用途 |
|---|---|---|---|
| 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