社内グループウェア（Kurage Vibe Groupware Core）

このアプリについて

■ 何のためのものか

グループウェアを入れようとすると、月額のSaaSか、数百万円の受託開発か、Excelで我慢するかの三択になりがちです。kintone は最低10ユーザー契約・スタンダード1ユーザー月1,800円（税抜・公式表示）なので、最小構成でも年216,000円。5人の会社でも、使っていない5人分を払い続けます。

このシステムは四つ目の道です。認証と権限と社員管理という「土台」だけを買い切りで用意し、業務アプリは必要な分だけ足していきます。お使いのレンタルサーバーに置くので、追加の月額はゼロです。

■ 入っているもの（Coreの範囲）

・ユーザー認証 … 社員番号＋パスワード／Google Workspace／Microsoft 365 を設定1語で切替
・ユーザー管理 … アカウントの発行・役割の変更・停止・削除、権限の棚卸し画面
・社員管理 … 社員マスタ（社員番号・氏名・カナ・部署・役職・入社日・退職日・在籍状態）
・共有スケジュール … 全員に公開。iPhone・Androidの標準カレンダーに取り込める

業務アプリ（日報・点検記録・経費精算など）は入っていません。必要なものを足す設計です。

■ 業務アプリの増やし方

apps/ にファイルを1枚置くと、そのままアプリになります。中身はPHPの配列です。

return array(
'key' => 'tenken', 'name' => '設備点検記録', 'icon' => '🔧',
'approval' => true,
'fields' => array(
array('key'=>'date','label'=>'点検日','type'=>'date','required'=>true),
array('key'=>'result','label'=>'判定','type'=>'radio',
'options'=>array('良','要観察','不良')),
),
'permissions' => array(
'staff' => array('create'=>true,'read'=>'own','update'=>'own'),
'chief' => array('create'=>true,'read'=>'dept','update'=>'dept','approve'=>'dept'),
'admin' => array('*'=>'all'),
),
);

これだけで、入力フォーム・一覧・検索・CSV出力・入力検証・権限・承認フローが動きます。同梱の手順書には、Claude や ChatGPT にそのまま貼れる指示文を載せてあります。あなたがPHPを書く必要はありません。

デモに入っている4本（社内お知らせ・日報・設備点検記録・経費精算）は、すべてこの方法で作りました。本体のコードは1バイトも変えていません。定義はそれぞれ33〜39行です。

■ 権限の考え方

役割は担当・責任者・管理者の3つ、範囲は own（自分の分だけ）・dept（同じ部署）・all（全部）の3語だけです。増やせるようにすると権限表が読めなくなり、読めない権限表は必ず設定を間違え、間違いは情報漏えいとして現れます。3つで足りないときは部署を分けてください。

判定はコードの1か所（kv_can）にしかありません。画面側では判定していないので、URLを直接叩かれても抜けません。

■ 社員とアカウントを分けています

人事の実体（社員）と、ログインする権利（アカウント）は別々に持ちます。部署は社員が、役割はアカウントが持ちます。

・アカウントを持たない社員も登録できます（現場・パートの方など）
・在籍状態を「退職」にすると、アカウントが有効のままでもログインできなくなります
・記録が残っている社員は削除できません（過去の日報の作成者が消えないように）

■ スマホ

画面はスマホのブラウザで使えます。共有スケジュールは購読URLを配る方式で、iPhone・Androidの標準カレンダーにそのまま取り込めます（専用アプリは不要）。購読URLは人ごとに違い、その人が見られる範囲だけを配信します。

■ 動作環境

・PHPが動くレンタルサーバー（PHP 7.0以上、8.x推奨）
・データベース不要（JSONファイルに flock で書きます）
・外部ライブラリ不要（Composer も npm も使いません）
・FTPでアップロードするだけ。常駐プロセスもポートも使いません

■ 同梱物

・ソースコード一式（MITライセンス。商用利用・改変・再配布・再販が自由です）
・導入・運用手順書 全10ファイル・約1,350行
　　入手／設置／設定（Google Workspace連携を含む）／運用開始／アプリの増やし方
　　＋設計解説・改造レシピ・AIエージェント向けの作業手順と鉄則
・動作検証スクリプト（214件）。改造したあと、壊していないかを自分で確認できます

■ 検証について

scripts/check_kvgwc.php に214件の検証が入っています。特に「他人の記録は書き換えられない」「退職者はログインできない」「Google の認証情報の検証」は、緩むと実害が出る箇所なので、改造後は必ず通してください。

■ ソースコードについて

本体のコードは MIT ライセンスで GitHub にも公開しています。この商品は、コードに加えて手順書を同梱し、すぐ始められる形にまとめたものです。お客様の会社に設置して納品しても、複数社に設置しても構いません（手順書そのものの再配布・転売はできません）。

■ こんな使い方ができます

・自社の社内システムとして（月額ゼロ）
・お客様への納品物として（何社に設置しても自由）
・「まずグループウェアを入れて、あとから業務アプリを足す」段階導入の土台として