3.0 KiB
パスと説明（現状の骨格・日文注釈）
app/
Models/
BaseModel.php
共通ベースモデル（必要に応じて利用。既定のタイムスタンプ名など最小共通を集約）
Park.php
正式モデル（park テーブル）。新規コードはこちらを使用
PriceA.php
正式モデル（price_a テーブル）。料金・収容台数情報
Ptype.php
正式モデル（ptype テーブル）。車種分類
RegularContract.php
正式モデル（regular_contract テーブル）。定期契約
Device.php
デバイス情報（park リレーションは正式モデル Park を参照）
MailTemplate.php / Ope.php / Batch/BatchLog.php / User.php
既存機能のモデル（必要最小のみ記載）
Concerns/
HasSortable.php
共通ソート用 Trait（sort/sort_type を安全適用）
Legacy/
User.php
旧 user テーブル互換モデル。旧 Blade 等の互換のため残置
OperatorQue.php
旧 operator_que テーブル互換。定数/関連取得（getUser/getPark）を維持
Park.php
旧 park テーブル互換（旧表示向け）。新規コードは Models/Park を使用
Services/
UsingStatusService.php
利用率統計の共通入口（旧 Helper 機能を集約）
UserService.php
利用者検索・取得の共通入口（旧 User::search の最小互換）
OperatorQueService.php
オペレータキュー一覧の共通入口
CsvService.php / FileService.php
CSV 入出力／ファイルアップロードの共通サービス（Utils ラッパ）
ShjFourCService.php / ShjMailSendService.php
既存バッチ/メール機能のサービス（モデル参照は通用モデルに統一済）
Support/
Csv.php / Files.php
純粋な技術ユーティリティ（ビジネス非依存の小粒機能）
Enums/
QueueClass.php / QueueStatus.php
旧配列定数の移行先（段階的に Enum 化を推奨）
Providers/
AppServiceProvider.php
サービスの DI 初期化（ShjFourC/ShjMailSend の依存を正式モデルに更新済）
LegacyServiceProvider.php
旧 FQCN 互換（class_alias で \App* → \App\Legacy* を提供）
Utils.php
旧ユーティリティ。CSV/ファイルは Service 経由に収束予定（当面互換のため存置）
運用ルール（要点）
新規実装は必ず通用モデル（App\Models\Park/PriceA/Ptype/RegularContract）とサービス経由で実装
旧 Blade は Legacy モデルの互換でそのまま動作（新規で Legacy を直接参照しない）
“1テーブル＝1正式モデル” を維持。Legacy 側は互換専用と明記
統計/CSV/外部 I/F は Service に集約。Controller は薄く保つ