Kurage
Kurage WikiKurageナレッジベース
Kurage.AIに聞く →
ホーム › Wiki › 概念 › 自己完結型PHPアプリ
概念

自己完結型PHPアプリ

1ファイルPHP+SQLiteで完結し、FTP配置だけで動くKurage製品群の共通設計パターン

自己完結型PHPアプリとは、単一のPHPファイル(または最小構成)で動作が完結するアプリケーション設計を指す。外部フレームワークやデータベースサーバーに依存せず、PHPが動くレンタルサーバーにFTPでアップロードするだけで運用を開始できる。

この設計は、kurage-app-store で販売・公開されるプロダクト群の基盤である。kurage-products は販売代理店向けの商品カタログであり、約100点の商品がソース同梱・MITライセンス・AIエージェントで改変拡張可能という共通形式で提供されている。カタログは大きく4つのファミリーに分かれる——(1) 自社開発の業務システム、(2) OSS日本語導入キット、(3) 公的オープンデータ×制度ナビ、(4) AI分析・AIチャット。このうち(1)と(3)の照会系、(4)の一部が自己完結型PHPの枠に収まり、(2)はPHP単一ファイルではないが「自社サーバーで持つ」思想を共有する。

価格は 5,500円/55,000円/110,000円/165,000円/220,000円/550,000円 の6段階に分かれる。5,500円はOSS日本語導入キット、55,000円は単機能の業務アプリと行政・介護・防災の照会ツール、110,000円は法案AIインタビュー・論点AIマップ・合意形成AI・陳情ナビ・EC(Vibe-Cart)・申請書アシスト・Track & GEO & SEO・NISA枠計算・設計支援(Architect)・セキュリティ監視・AI分析など規模の大きいもの、165,000円は防災判定セット、220,000円は重説チェックと防災AIチャット+判定セット、そしてAI分析(通話・広告)、550,000円は国会トラッカーと議員発言ログが占める。無料枠にはアプリランチャー、情報発信トラッカー、開発中(導入相談受付中)のAI相談チャット5本(補助金・出店商圏・土地・介護相談・給付金)がある。値付けは実装量ではなく、誤ると社会的損害が大きい領域ほど高い(重要事項説明220,000円、国会関連550,000円)という性格を持つ(social-impact-pricing)。

55,000円帯の商品説明には「PHP1ファイルとSQLiteだけで動き、データベースサーバーも常駐プロセスもポートも要りません」という一文が繰り返し現れ、これが販売上の共通の約束事になっている。実際、業務アプリの多くは1ファイルPHP+SQLite構成で、DBサーバーを必要とせず、共有レンタルサーバーにFTPで配置するだけで動作する。また、Python/FastAPIなどをバックエンドに持つKurageプロダクトでも、公開用の入り口は単一PHPファイルとして実装され、同じ発想が応用されている。取引先チェック(ktorihiki)と入札情報ナビ(knyusatsu)も、いずれも55,000円の1ファイルPHP+SQLite製品である。

主な特徴

商品カタログに見る実装パターン(kurage-products より)

カタログは価格帯と実装形態がおおむね対応している。55,000〜110,000円の業務・照会ツールは「1ファイルPHP+SQLite」、防災・商圏のような重い地理演算は「Python+SQLite」、大規模データの議会系は「PHP+SQLite(LLMなし)」、そして5,500円は「OSS導入キット」。どの帯にも共通するのは、月額課金を排し、データとロジックを顧客のサーバー内に置くという姿勢である(self-hosting)。

Kurage業務アプリ(55,000円・1ファイルPHP+SQLite)

これらは「1ファイルPHP・FTP配置・DB不要」を共通の基盤とし、config-declared-scope の発想で設定ファイルに操作範囲を集約している。多くの商品にはAIエージェントでの改変手順を示すマニュアルや vwork 教材が同梱され、購入者がそのままAIに設置・変更を任せられる構成になっている。

AI分析・自動日報(110,000〜220,000円・PHP+SQLite)

価格帯は高いが、実装の性格は55,000円帯の延長にある。取り込みと分析の骨格は規則で組み、AIは要約の差し替え部品に留める。

セキュリティ(55,000〜110,000円)

自己完結型PHPが「守る側」に回る用途。いずれも顧客のサーバー上で完結し、外部サービスにURLやファイルを渡さない。

政策・政治・行政のツール(55,000〜550,000円・PHP1ファイル+SQLite)

国会会議録や自治体の公表資料を素材にした道具が並ぶ。いずれも検索や判定にLLMを必須とせず、根拠や出典を画面に出す(deterministic-core / evidence-traceability / civic-tech)。

福祉・介護・障害の照会システム(55,000円・PHP1ファイル+SQLite)

住所や条件から国・自治体の公表データを引く照会ツール群も、PHP1ファイル+SQLiteで完結し、DBサーバーも常駐プロセスもポートも要らない(address-lookup-navigator)。共通するのは 「判定はコードが行い、LLMに当てさせない」「根拠とデータ時点を必ず添える」「分からないものを『該当なし』と書かない」 という自己完結の精神である(deterministic-core / evidence-traceability / unknown-vs-outside-distinction)。

これらのツールに共通する設計判断が、facility-data-churn(公表データから消えた事業所を、理由を断定せず数える)と administrative-data-publication-gap(自治体ごとに公表の有無・形式が違うことを前提に組む)である。

法規制・制度・生活手続きのツール(55,000円)

感染症・選挙のマップ(55,000円)

行政・防災系システム(55,000〜220,000円・Python+SQLiteが中心)

もう一方の柱が、自治体オープンデータを判定エンジンに変える防災系の商品群である。これらは「外部の有料APIを使わず、外部LLMにも依存せず、データを自社サーバー内で完結させる」という自己完結の精神を共有するが、実装はPHP単一ファイルではなく Python+SQLite である点で業務アプリ群と性格を異にする。PostGISもDockerも不要で、判定は決定的(deterministic-core)、根拠と時点は結果に添えられる(evidence-traceability)。

共通の設計原則は unknown-vs-outside-distinction(区域外・データなし・未収録を区別し、黙って「該当なし」と答えない)、hazard-map-judgment、そしてオープンデータの利用条件をコードに持つ open-data-license-compliance である。

一方、単一PHP・FTP配置が成立しない範囲も明示されている。kurage-fillout(申請書記入アシスト)はローカルLLMとMCPを使うため共有レンタルサーバーでは動かずVPS・専用サーバーが要ると明記され、karchitect もPython環境とOllama互換LLMを要求する。LLM常駐型・重い地理演算型は、自己完結型PHPの枠の外に置かれている。

日本語導入キット(5,500円・SaaS代替OSSのセットアップ)

これらのキット自体は必ずしも単一PHPではないが、「月額SaaSに依存せず自分のサーバーで持つ」self-hosting の思想と、日本語化によるOSS導入障壁の低減(oss-japanese-localization)を共有しており、自己完結型PHPアプリのエコシステムの一部を成している。

無料枠・開発中のAI相談チャット

kurage-app-store には無料枠も置かれている。kclauncher と情報発信トラッカーが稼働品、そして補助金(kurage-subsidy-navi のAI版)・出店商圏(kshoken のAI版)・土地(ktochi)・介護相談(kurage-ai-soudan-chat)・給付金(kkyufu)の5本は「現在開発中で、導入のご相談を受け付けています」という状態で公開されている。いずれも「公開データから規則で絞り込み、その結果をAIが説明する」という構図で、自己完結型の判定とAIの言い換えを分ける設計を踏襲している。

表示専用PHP・課金PHP(kurl2gr の例)

kurl2gr は、バックエンドをFastAPIで持つが、顧客サイトに置く部品は単一の表示専用PHPとして実装している。

公開用PHPゲートウェイ

バックエンドをAPIとして持つプロダクトでは、認証済みユーザー名と共有トークンをAPIへ渡す単一PHPが公開口として使われる。ブラウザにAPIトークンを公開しない(kurage-php-gateway)。

これらは「単一PHP + FTP配置」の利点を、大規模システムのエッジでも活かすパターンと言える。

記事索引から見る実践例(kurage-articles-index より)

kurage-articles-index に収録された記事には、自己完結型PHPアプリの考え方をさらに広げる事例が登場する。

これらの記事は、自己完結型PHPアプリが「表示」「課金」「i18n」「トラッキング」「AI改変」といった幅広い用途に適用できることを示している。

想定顧客と販売様式

カタログの想定顧客は、中小企業、自治体・議員事務所・政党支部、制作会社、士業・クリニック・サロン・保育園・動物病院など。販売代理店向けに、デモURLとログイン情報、そしてAIエージェント用の構築指示書を添える点が共通の販売様式になっている。ACEが「フォルダごとClaude CodeやCodexに渡せば、AIが手順書を読んで構築まで進む」と書くように、自己完結型PHPの読みやすさは販売チャネルの設計にも効いている(ai-readable-manual / sales-partner-system)。

関連する考え方

自己完結型PHPアプリは、「小さく、読みやすく、どこでも動き、AIで育てられる」という、現代的なレンタルサーバー向け業務システムの一形態である。同時に、大規模システムの公開エッジを軽量に保つための実践的なパターンでもある。約100点のカタログ全体を見渡すと、この枠がよく効く領域(CRM・勤怠・請求・予約・掲示板・カレンダー・NISA計算・アンケート等の業務アプリと、住所から公表データを引く介護・福祉・行政・防災の照会ツール、そして自社サーバーを守るセキュリティ監視)と、あえて枠外に置かれる領域(LLM常駐型の申請書アシストや設計スタジオ、Python+SQLiteの防災判定エンジンや商圏分析)とが意識的に切り分けられている点が、設計判断として際立っている。AI分析製品のように価格が高くても「規則で判定し、AI要約は差し替え可能な追加部品」という構図を崩さないことが、この設計系列の一貫性を示している。

Related Documents

See also: kurage-sites

See also: kurage-articles-index

See also: kurage-lps

「自己完結型PHPアプリ」についてもっと知りたいですか?
Kurage.AI に質問する