AI Database Sample 技術仕様書

1. システム概要

AI Database Sampleは、OpenAI APIとPHP/SQLiteを使用したAI駆動型顧客管理システムです。従来の手動CRUD操作に加えて、自然言語によるデータベース操作機能を提供します。

1.1 主要機能

顧客データのCRUD操作（作成・読取・更新・削除）
Webベースの直感的なユーザーインターフェース
AI チャット機能による自然言語でのデータ操作
セッション固有のデータベース管理
レスポンシブデザイン対応

2. システムアーキテクチャ

2.1 技術スタック

フロントエンド	HTML5, JavaScript (ES6+), Bootstrap 5
バックエンド	PHP 7.4+
データベース	SQLite 3
AI機能	OpenAI GPT API
Webサーバー	Apache/Nginx（PHP対応）

2.2 システム構成図

[ブラウザ] 
    ↓ HTTP Request
[index.html] 
    ↓ AJAX Request
[API Layer (PHP)]
    ├─ customers.php (CRUD API)
    ├─ chat.php (AI Chat API)
    └─ config.php (設定・DB接続)
    ↓ SQLite Connection
[SQLite Database (セッション固有)]
    ↓ External API Call
[OpenAI API]
            

3. ファイル構成

ai_db/
├── index.html          # メインUI・SPA
├── config.php          # 設定ファイル・データベース管理
├── database.sql        # データベース初期化スクリプト
├── api/
│   ├── customers.php   # 顧客CRUD API
│   └── chat.php        # AI チャットAPI
└── databases/          # セッション固有データベース格納フォルダ
    └── session_*.db    # セッション毎のSQLiteファイル
            

4. データベース設計

4.1 テーブル構成

customers テーブル

フィールド名	データ型	制約	説明
id	INTEGER	PRIMARY KEY, AUTOINCREMENT	顧客ID（自動採番）
customer_code	TEXT	NOT NULL, UNIQUE	顧客コード
customer_name	TEXT	NOT NULL	顧客名称
address	TEXT	NOT NULL	住所
created_at	DATETIME	DEFAULT CURRENT_TIMESTAMP	作成日時
updated_at	DATETIME	DEFAULT CURRENT_TIMESTAMP	更新日時

4.2 データベース管理機能

セッション固有のSQLiteデータベース
24時間経過した古いデータベースファイルの自動削除
新規セッション時の自動テーブル作成とサンプルデータ投入

5. API仕様

5.1 顧客管理API（/api/customers.php）

GET 全顧客取得

URL: /api/customers.php
Response: 顧客配列（JSON）

GET 特定顧客取得

URL: /api/customers.php/{id} または /api/customers.php?id={id}
Response: 顧客オブジェクト（JSON）

POST 新規顧客作成

URL: /api/customers.php
Request Body:

{
  "customer_code": "CUST004",
  "customer_name": "新規顧客株式会社",
  "address": "東京都新宿区1-1-1"
}

Response: 作成された顧客オブジェクト（JSON）

PUT 顧客更新

URL: /api/customers.php/{id}
Request Body: 更新フィールドのみ指定可能

{
  "customer_name": "更新された顧客名"
}

Response: 更新された顧客オブジェクト（JSON）

DELETE 顧客削除

URL: /api/customers.php/{id}
Response: 削除完了メッセージ（JSON）

5.2 AI チャットAPI（/api/chat.php）

POST 自然言語操作

URL: /api/chat.php
Request Body:

{
  "message": "IDが3の顧客を削除して"
}

Response:

{
  "success": true,
  "message": "操作が完了しました",
  "data": {...},
  "ai_action": {...},
  "user_message": "..."
}

6. AI機能詳細

6.1 AI処理フロー

ユーザーからの自然言語入力を受信
OpenAI APIに処理指示を送信
AIがデータベース操作アクションを判定
判定されたアクションに基づきデータベース操作を実行
結果をユーザーに返却

6.2 対応操作種別

list: 顧客一覧取得
get: 特定顧客取得
create: 新規顧客作成
update: 顧客情報更新
delete: 顧客削除

6.3 AI プロンプト設計

システムプロンプトにより、AIに以下の役割を定義：

顧客データベース操作アシスタント
自然言語からAPI操作への変換
JSON形式での操作指示生成

7. セキュリティ仕様

7.1 データベースセキュリティ

セッション固有データベースによるデータ分離
SQLインジェクション対策（プリペアドステートメント使用）
古いセッションデータの自動削除（24時間経過）

7.2 API セキュリティ

CORS設定による適切なクロスオリジン制御
HTTPメソッド制限
入力データバリデーション
エラーハンドリングと適切なHTTPステータスコード

8. パフォーマンス仕様

8.1 データベース最適化

SQLiteインメモリ処理
外部キー制約の適切な設定
インデックス設定（必要に応じて）

8.2 フロントエンド最適化

Bootstrap CDNの活用
非同期通信（fetch API使用）
レスポンシブデザインによるマルチデバイス対応

9. 運用要件

9.1 システム要件

PHP 7.4以上
SQLite 3対応
cURL拡張モジュール
セッション機能対応

9.2 必要な設定

                注意: config.php内の設定項目（データベースディレクトリパス、セッション設定、CORS設定）の適切な設定が必要です。
            

9.3 メンテナンス機能

古いデータベースファイルの自動削除機能
エラーログ出力機能
データベース初期化機能

10. 拡張性

10.1 機能拡張ポイント

新しいテーブル・エンティティの追加
AI操作コマンドの拡張
ユーザー認証機能の追加
複数データベース対応

10.2 技術拡張ポイント

データベースエンジンの変更（MySQL, PostgreSQL等）
AIモデルの変更・アップグレード
キャッシュ機能の追加
API認証機能の追加

11. 制限事項

11.1 技術的制限

セッション固有データベースのため、データ永続化には制限あり
シングルユーザー対応（マルチユーザー未対応）
リアルタイム同期機能なし

11.2 AI機能制限

OpenAI APIの利用制限に準拠
自然言語解釈の精度はAIモデル依存
複雑なクエリの処理には制限あり

12. エラーハンドリング

12.1 データベースエラー

接続エラー時のHTTP 500応答
制約違反時の適切なエラーメッセージ
PDO例外の適切なキャッチと処理

12.2 API エラー

不正なリクエスト時のHTTP 400応答
リソース未発見時のHTTP 404応答
メソッド不許可時のHTTP 405応答

12.3 AI API エラー

OpenAI API呼び出し失敗時の代替処理
レスポンス解析エラー時のエラー表示
ネットワークエラー時のタイムアウト処理

AI Database Sample 技術仕様書

目次

1. システム概要

1.1 主要機能

2. システムアーキテクチャ

2.1 技術スタック

2.2 システム構成図

3. ファイル構成

4. データベース設計

4.1 テーブル構成

customers テーブル

4.2 データベース管理機能

5. API仕様

5.1 顧客管理API（/api/customers.php）

GET 全顧客取得

GET 特定顧客取得

POST 新規顧客作成

PUT 顧客更新

DELETE 顧客削除

5.2 AI チャットAPI（/api/chat.php）

POST 自然言語操作

6. AI機能詳細

6.1 AI処理フロー

6.2 対応操作種別

6.3 AI プロンプト設計

7. セキュリティ仕様

7.1 データベースセキュリティ

7.2 API セキュリティ

8. パフォーマンス仕様

8.1 データベース最適化

8.2 フロントエンド最適化

9. 運用要件

9.1 システム要件

9.2 必要な設定

9.3 メンテナンス機能

10. 拡張性

10.1 機能拡張ポイント

10.2 技術拡張ポイント

11. 制限事項

11.1 技術的制限

11.2 AI機能制限

12. エラーハンドリング

12.1 データベースエラー

12.2 API エラー

12.3 AI API エラー