## 01_folder_structure.md # SPS BACK OFFICE フォルダ構成（実装状況付き） ## ⚠️ このファイルの修正ルール（最優先） このファイルはプロジェクトの「正」です。以下のルールを厳守してください。 ### 修正が必要な場合 - ✅ 実装済 → 🔄 修正済 に変えるとき - ⬜ 未実装 → ✅ 実装済 に変えるとき - 新しいファイルを追加するとき - ファイル名や日本語補足を変更するとき ### 修正手順 1. **必ず先に** このファイルを修正する 2. 修正後、ユーザーの確認を受ける 3. 確認が取れてから実際のファイル操作を行う ### 禁止 - このファイルを確認せずにファイル操作をしない - ユーザー確認なしで勝手に修正しない --- ## 設計原則（全担当必読） ### 3層構造 このシステムのフォルダ構成は以下の3層で設計する。 | 層 | 場所 | 内容 | |----|------|------| | システム実行基盤 | `master/` `master/api/` | 認証・権限・拠点・部署・職務・契約。システムを動かすための定義。全体管理者が管理 | | 業務マスタ | 各担当フォルダ配下 | 顧客区分・案件種別・給与マスタ等。業務データを作るための選択肢。各担当が管理 | | 業務データ | `data/` 配下 | 顧客情報・案件情報・仕訳データ等。業務の実体・記録 | ### 業務マスタの置き場ルール - 業務マスタは「誰が管理するか（indexを持つ担当）」で置き場を決める - 営業担当が管理するもの → `clients/` 配下 - 案件担当が管理するもの → 案件配下 - 人事担当が管理するもの → `employees/` 配下 - 会計担当が管理するもの → 会計配下 ### データの重複保存禁止 - 物理ファイルは必ず一箇所に保存する - 複数のシステムから参照が必要な場合はIDで紐づけて参照する（重複保存禁止） - 例：領収書画像は `data/receipts/` に一元保存し、案件からは `case_id` で参照する ### `data/` 配下の拡張方針 - 業務拡張に合わせて `data/` 配下にフォルダを追加していく - 新規フォルダ追加時は必ず先にこのファイルを修正して全体管理者の承認を受けること --- ## ルートディレクトリ ``` /backoffice/ ├── index.html # TOPページ 🔄 修正済（get_session.php連携・sessionStorage除去） ├── login.html # ログイン画面 🔄 修正済（login.php連携・sessionStorage除去） │ ├── config.php # API設定ファイル（APIキー管理）✅ 新規作成 ├── api/ # API用フォルダ ✅ 実装済 ├── sales/ # 営業管理 ✅ 実装済 │ ├── common/ │ ├── accounting/ │ │ ├── index.html # 会計TOP 🔄 修正済 │ │ ├── journal.html # 仕訳入力 🔄 修正済（サーバー保存・OCR実装・レスポンシブ対応） │ │ ├── ledger.html # 総勘定元帳 🔄 修正済 │ │ ├── trial.html # 試算表 🔄 修正済 │ │ ├── pl.html # 損益計算書 🔄 修正済 │ │ ├── bs.html # 貸借対照表 🔄 修正済 │ │ └── settings.html # 勘定科目設定 🔄 修正済（サーバーAPI保存・localStorage撤廃・レスポンシブ対応） │ │ │ ├── css/ │ │ └── dark-theme.css # ダークモード設定 ✅ 実装済 │ │ │ ├── js/ │ │ ├── accounting_core.js # 会計共通集計エンジン ⬜ 未実装 │ │ ├── print.js # 印刷・PDF出力共通処理 ✅ 新規作成 │ │ └── session.js # セッション確認・ユーザー情報共通処理 ✅ 新規作成 │ │ │ └── images/ │ ├── logo/ │ │ ├── bologo.png # SPS BACK OFFICE ロゴ ✅ 実装済 │ │ ├── corporate/ # 法人用ロゴ ⬜ 未実装 │ │ └── spservice/ # 個人事業用ロゴ ⬜ 未実装 │ └── stamps/ │ ├── company/ # 法人用印鑑 ⬜ 未実装 │ └── individual/ # 個人事業用印鑑 ✅ 実装済 │ └── individual_seal.png │ ├── private/ │ ├── accounting/ │ │ ├── tax.html # 確定申告 🔄 修正済 │ │ ├── monthly.html # 月別売上内訳 🔄 修正済 │ │ ├── consumption_tax.html # 消費税申告書 🔄 修正済 │ │ ├── schedule.html # 勘定科目内訳書 ✅ 新規作成 │ │ └── depreciation.html # 減価償却計算 ✅ 新規作成 │ ├── cases/ ⬜ 未実装 │ │ ├── index.html │ │ ├── view.html │ │ └── input.html │ └── sales/ ⬜ 未実装（別担当） │ ├── corporate/ │ ├── accounting/ │ │ ├── corporate.html # 法人税申告 🔄 修正済 │ │ ├── consumption_tax.html # 消費税申告書 ✅ 新規作成 │ │ ├── monthly.html ⬜ 未実装 │ │ ├── schedule.html ⬜ 未実装 │ │ ├── fixed_asset.html ⬜ 未実装 │ │ └── cashflow.html ⬜ 未実装 │ ├── cases/ ⬜ 未実装 │ │ ├── index.html │ │ ├── view.html │ │ └── input.html │ └── sales/ ⬜ 未実装（別担当） │ ├── employees/ # 従事者管理 🔄 master/より移動（v2.6） │ ├── index.html # 従事者一覧 ⬜ 未実装（master/employees.htmlより移動） │ ├── edit.html # 従事者編集 ⬜ 未実装（master/employee_edit.htmlより移動） │ └── api/ │ └── save_employee.php # 従事者情報保存 🔄 master/api/より移動（v2.6） │ ├── clients/ # 顧客管理 ⬜ 予約のみ・未実装（営業管理担当着手時に実装） │ ├── hr/ # 人事・組織 │ ├── index.html # 人事・組織閲覧 ⬜ 未実装 │ └── labor/ # 🔄 master/labor/より移動（v2.6） │ ├── social_insurance_export.html # 社会保険CSV出力 🔄 修正済 │ └── year_end_adjustment.html # 年末調整 🔄 修正済（準備中表示） │ ├── master/ │ ├── index.html # マスタ管理トップ ★新規作成 ⬜ │ ├── permission_edit.html # 権限マスタ管理 ★新規作成 ⬜ │ ├── branch_edit.html # 拠点マスタ管理 ★新規作成 ⬜ │ ├── department_edit.html # 部署マスタ管理 ★新規作成 ⬜ │ ├── contract_edit.html # 契約マスタ管理 ★新規作成 ⬜ │ ├── position_edit.html # 職務マスタ管理 ★新規作成 ⬜ │ ├── backup.html # バックアップ管理 ★将来実装 ⬜ │ ├── company_info.html # 事業者情報閲覧 ✅ 実装済 │ ├── company_edit.html # 事業者情報編集 🔄 修正済 │ │ │ ├── api/ # システム実行基盤API（現状維持） │ │ ├── login.php # 認証・PHPセッション生成 ✅ 新規作成 │ │ ├── get_session.php # セッション確認・ユーザー情報返却 ✅ 新規作成 │ │ ├── logout.php # セッション破棄・ログアウト ✅ 新規作成 │ │ ├── save_permission.php # 権限マスタ保存 ★新規作成 ⬜ │ │ ├── save_branch.php # 拠点マスタ保存 ★新規作成 ⬜ │ │ ├── save_department.php # 部署マスタ保存 ★新規作成 ⬜ │ │ ├── save_contract.php # 契約マスタ保存 ★新規作成 ⬜ │ │ ├── save_position.php # 職務マスタ保存 ★新規作成 ⬜ │ │ ├── save_company.php # 事業者情報保存 ✅ 実装済 │ │ ├── save_receipt.php # 領収書画像保存 ✅ 新規作成 │ │ ├── ocr_receipt.php # Google Vision OCR ✅ 新規作成 │ │ ├── move_receipt.php # 領収書画像移動・ログ記録 ✅ 新規作成 │ │ ├── save_journals.php # 仕訳データ保存 ✅ 新規作成 │ │ ├── load_journals.php # 仕訳データ読込 ✅ 新規作成 │ │ ├── save_accounts.php # 勘定科目マスタ保存 ✅ 新規作成 │ │ ├── save_fixed_assets.php # 固定資産マスタ保存・読込 ✅ 新規作成 │ │ ├── save_user_data.php # ユーザー固有手動入力データ保存 ✅ 新規作成 │ │ ├── generate_pdf.php # PDF生成API（全帳票共通） ✅ 新規作成 │ │ ├── save_case.php # 案件保存API ⬜ 未実装 │ │ ├── load_case.php # 案件読込API ⬜ 未実装 │ │ ├── case_number.php # 案件番号自動採番API ⬜ 未実装 │ │ ├── ai_convert.php # AI変換API（将来拡張）⬜ 未実装 │ │ └── lib/ │ │ └── mpdf/ # mPDFライブラリ（手動設置） ⬜ 未設置 │ │ │ ├── accounts.json # 勘定科目マスタ ✅ 実装済（会計担当管理） │ ├── fixed_assets.json # 固定資産マスタ ✅ 新規作成（会計担当管理） │ ├── company_info.json # 事業者情報マスタ ✅ 実装済 │ ├── branches.json # 拠点マスタ ✅ 実装済 │ ├── permissions.json # 権限マスタ ✅ 実装済 │ ├── departments.json # 部署マスタ ✅ 実装済 │ ├── positions.json # 職務マスタ ✅ 実装済 │ ├── contracts.json # 契約マスタ ✅ 実装済 │ └── salaries.json # 給与マスタ ✅ 実装済 │ ├── data/ │ ├── accounting/ │ │ ├── private/[年]/ │ │ └── corporate/[期]/ │ ├── receipts/ ✅ 実装済 │ │ ├── private/[年]/[月]/[仕訳ID].jpg │ │ └── corporate/[年]/[月]/[仕訳ID].jpg │ ├── cases/ ✅ 実装済 │ │ └── [案件番号]/ │ │ ├── case.json │ │ ├── files/ │ │ ├── reports/ │ │ └── invoices/ │ ├── employees/ 🔄 新設（v2.6） │ │ ├── employees.json # 従事者マスタ 🔄 master/より移動 │ │ ├── users.json # ログインユーザー 🔄 master/より移動 │ │ └── counters/ # 🔄 master/counters/より移動 │ │ └── employee_counter.json # 従事者ID連番 │ ├── sessions/ ✅ 新規作成 │ │ └── active_sessions.json # アクティブセッション管理 │ ├── logs/ │ │ ├── case_transfer.json ✅ 新規作成 │ │ └── access_log.json ✅ 新規作成 │ └── user_data/ │ └── [key].json │ └── docs/ ├── 00_経営理念_事業構造.md ├── 01_folder_structure.md ├── 02_print_spec.md ├── 03_development_rules.md │ ├── 00_overview/ │ ├── 00_handover_to_admin.md │ ├── 00_system_overview.md │ ├── 02_development_process.md │ └── 03_login_session.md │ ├── 01_code_definition/ │ ├── 01_company_codes.md │ ├── 02_business_codes.md │ ├── 03_id_generation.md │ ├── 04_contracts.md │ ├── 05_user.md │ ├── 06_departments.md │ ├── 07_positions.md │ └── 08_salary.md │ ├── 02_data_definition/ │ ├── 01_employee_table.md │ ├── 02_client_table.md ⬜ │ └── 03_company_info.md │ ├── 03_ui_design/ │ ├── 01_design_guideline.md │ └── 02_master_management.md │ ├── 04_business_flow/ │ ├── case_management/ │ │ ├── 01_case_management.md │ │ ├── 02_case_data_structure.md │ │ ├── 03_case_type_master.md │ │ ├── 04_case_input_screens.md │ │ ├── 05_case_ai_conversion.md │ │ ├── 06_case_photo_report.md │ │ ├── 07_case_document_generate.md │ │ ├── 08_case_permission.md │ │ ├── 09_case_accounting_link.md │ │ ├── 10_case_export.md │ │ ├── 11_case_mail.md │ │ └── 12_case_sales_link.md │ └── labor_management/ │ └── 01_labor_management.md ⬜ │ ├── 05_master_management/ │ └── 01_master_handover.md │ ├── 06_permission/ │ └── 01_permission_design.md │ ├── 07_accounting/ │ ├── 00_handover.md │ ├── 01_system_design.md │ ├── 02_journal_spec.md │ ├── 03_tax_audit_mode.md │ ├── 04_export_import.md │ ├── 05_tax_return.md │ ├── 06_schedule.md │ ├── 07_accounts_master.md │ ├── 08_fixed_asset.md │ ├── 09_consumption_tax.md │ ├── 10_accounting_core_spec.md │ └── 11_receipt_ocr.md │ └── 08_pdf_engine/ └── 00_handover.md ⬜ 未作成 ``` ## 凡例 - ✅ 実装済・作成済 - 🔄 修正済（実装済だが修正が入ったもの） - ⬜ 未実装 - ★ 今回新規追加予定 --- ## v2.6 変更サマリー（担当向け） ### 移動・新設されたもの | 変更前 | 変更後 | 備考 | |--------|--------|------| | `master/employees.html` | `employees/index.html` | 従事者一覧 | | `master/employee_edit.html` | `employees/edit.html` | 従事者編集 | | `master/api/save_employee.php` | `employees/api/save_employee.php` | 従事者保存API | | `master/employees.json` | `data/employees/employees.json` | 従事者マスタ | | `master/users.json` | `data/employees/users.json` | ログインユーザー | | `master/counters/` | `data/employees/counters/` | 採番カウンター | | `master/labor/` | `hr/labor/` | 労務関連画面 | | `master/case_types.json` | 案件担当配下（着手時に決定） | 案件種別マスタ | | （新設）`clients/` | `clients/` | 顧客管理（予約のみ） | ### 影響を受ける担当と対応 | 担当 | 対応内容 | |------|---------| | マスタ管理担当 | `login.php` / `get_session.php` のemployees.jsonパス修正 | | 会計担当 | パス変更なし（master/api/は現状維持） | | 案件管理担当 | `case_types.json` の置き場を着手時に決定 | --- ## 改訂履歴 | 日付 | 版 | 担当 | 内容 | 理由・影響範囲 | |------|----|------|------|--------------| | 2026-04-07 | 2.6 | 全体管理者（11代目） | 設計原則（3層構造）追加。`employees/`フォルダ新設・関連ファイル移動。`clients/`フォルダ新設（予約）。`hr/labor/`整理。`master/case_types.json`を案件担当配下へ移動。`master/api/`は現状維持 | マスタ＝定義・選択肢、データ＝業務の実体の設計原則確定に伴う大規模整理 |