krgm.so-manager-dev.com/README.md
gitadmin 22051f6c18
All checks were successful
Deploy krgm (auto) / deploy (push) Successful in 10s
更新 README.md
2025-08-15 09:29:33 +09:00

58 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

ドメイン:<a href="krgm.so-manager-dev.com">krgm.so-manager-dev.com</a>
パスと説明(現状の骨格・日文注釈)
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
共通ソート用 Traitsort/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 は薄く保つ