From 22051f6c18258cbb629049c634bdf67150052955 Mon Sep 17 00:00:00 2001
From: gitadmin <imdoubao@gmail.com>
Date: Fri, 15 Aug 2025 09:29:33 +0900
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20README.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 59 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 58 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 92de72f..6a2e574 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,58 @@
-krgm.so-manager-dev.com
\ No newline at end of file
+ドメイン：<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
+        共通ソート用 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 は薄く保つ
\ No newline at end of file