feat: PostgreSQL を primary DB に移行する

[strnh]

方針

PostgreSQL を primary DB とし、SQLite は移行元・legacy 用途として扱う。

複数PC・複数利用者での運用、ロック制御、厳密な型、PostgreSQL を採用する既存システムとの連携を考慮し、SQLite を運用DBの最終形にはしない。

SQLite の既存データ・バックアップをただちに廃止するものではない。SQLite は移行元および既存環境の互換用として維持し、DB driver ごとのバックアップ／リストアを提供する。SQLite と PostgreSQL のSQL dumpは相互に復元せず、DB間のデータ移行にはJSONバックアップを使用する。

完了済み

• PostgreSQL 開発環境の起動スクリプトと .env.pgsql.example を追加（PR feat: PostgreSQL移行の第一段階 — 開発環境・migration互換・テストプロファイル (#62) #66）
• PostgreSQL で migration を実行できるよう既存migrationの互換性を確認・修正（PR feat: PostgreSQL移行の第一段階 — 開発環境・migration互換・テストプロファイル (#62) #66）
• PostgreSQL 用 PHPUnit プロファイル（composer run test:pgsql）を追加（PR feat: PostgreSQL移行の第一段階 — 開発環境・migration互換・テストプロファイル (#62) #66）
• 稼働中DB（sqlite / pgsql）をUIで識別できるようにした（PR feat: 稼働中DBがsqlite3/pgsqlのどちらかを表示するインジケータ機能 (#67) #68）
• フルバックアップ／リストアをDB driver別実装へ分離し、PostgreSQL の pg_dump / psql 経路を追加（PR feat: PostgreSQL向けフルバックアップ・リストアを実装する (#63) #71）
• JSONリストア後にPostgreSQL sequenceを同期する（PR fix: JSONリストア後にPostgreSQLのsequenceをリセットする (#70) #72）
• PostgreSQLプロファイルでFeature testを実行できることを確認

現在の設計

• DB_CONNECTION=pgsql を本番運用の接続として使用する。
• SQLite／PostgreSQLのバックアップは各driverのSQL形式で作成・復元し、cross-driver restoreは明示的に拒否する。
• SQLiteからPostgreSQLへの業務データ移行は、アプリのJSON export/import経路で行う。
• 開発・テストではSQLiteも継続して使用できる。これは本番primary DBの方針と矛盾しない。

残作業

• PostgreSQLを使うproduction環境の配備・監視・バックアップ運用を整備する（nginx + PHP-FPM production配備スクリプト群を整備する #55）
• SQLite既存データをJSON export/importでPostgreSQLへ移す手順をrunbook化し、実データ相当で検証する
• PostgreSQLを使う本番切替時の停止手順、ロールバック方針、バックアップ世代管理を確定する
• SQLite legacy環境をどの期間・用途までサポートするかを決める
• backup/restoreのブラウザE2EをSQLite / PostgreSQLの責務に分けて追加する（test: backup/restore の E2E を追加 #49）

関連

• feat: postgresql 対応 db plugin の検討 #27: SQLite FDWによる接続案は本Issueに包含する。primary DB移行の方式としては採用しない。
• backup: 差分バックアップ方式の仕様確定と実装 #48: 差分バックアップはPostgreSQL primary後の要件として方式を再検討する。
• nginx + PHP-FPM production配備スクリプト群を整備する #55: production配備はPostgreSQL primary前提に更新する。
• feat: バージョンの表示ページ #59: UI build version、DB driver、migration/schema version、バックアップ互換性の表示をこの方針と整合させる。

[strnh]

スコープ明文化（2026-07-10 調査に基づく）

方針: PostgreSQL を primary DB とし、SQLite は移行元 / legacy 扱いに寄せる。

DB_CONNECTION=pgsql への切り替えだけでは完結せず、バックアップ/リストア設計の置き換えが主作業になる。

現状整理

• config/database.php には pgsql 接続定義が既にある
• SQLite 前提の箇所: .env.example / scripts/init.sh / scripts/init-test.sh / phpunit.xml / README.md
• SQLite 専用実装（sqlite3 .dump・sqlite_schema・PRAGMA 前提のため PostgreSQL へ流用不可）:
  • app/Services/SqliteFullBackup.php
  • app/Services/SqliteFullRestore.php
  • app/Services/BackupStorage.php
  • app/Console/Commands/BackupSqliteDump.php

移行計画（段階）

1. .env.pgsql.example と PostgreSQL 起動スクリプト（podman/docker）の追加
2. PostgreSQL で php artisan migrate:fresh を通す（2026_07_01_000000_create_customer_signatures_table.php の selectRaw + having は互換性確認が必要）
3. Feature test を PostgreSQL で実行するプロファイルの追加
4. バックアップ/リストアを DB ドライバ別実装へ分離
5. JSON リストア後の sequence reset（setval()）— 既存リストアは明示 ID を insert するため、PostgreSQL では必須

最初の実装単位は 1〜3（PostgreSQL で migrate:fresh と Feature test を通す）とする。

関連

• feat: postgresql 対応 db plugin の検討 #27（postgresql 対応 db plugin の検討）は本 Issue のスコープに包含される想定