## 00_handover_to_admin.md
# SPS BACK OFFICE 全体管理者引き継ぎ書

**保存先**: `/backoffice/docs/00_overview/00_handover_to_admin.md`
**作成日**: 2026-03-22
**作成者**: 全体管理者アシスタント（2代目）
**対象**: 次の全体管理者アシスタント

---

## 【最優先】引き継ぎを受ける前に必ずやること

### ① まず自分でfetchして読む
真柴さんからファイルを受け取る前に、以下のURLをfetchして設計書・マスタを自分で読むこと。

```
https://docs.scsps.jp/
```

このページに全設計書・マスタJSONのリンクが一覧されている。必要なファイルのURLを確認して自分でfetchすること。

**fetchルール：**
- 設計書（.md）・マスタJSON（master/）はすべてここから取得できる
- masterフォルダのデータは最新でない場合がある。内容に疑問があれば真柴さんに確認すること
- HTMLファイルのみ真柴さんから渡してもらう（docs.scsps.jpには置いていない）

### ② 以下の順番で全て読む
```
1. docs/01_folder_structure.md             ← 全体構成・実装状況の「正」
2. docs/03_development_rules.md            ← 開発ルール・変更手順・権限
3. docs/00_overview/00_system_overview.md  ← システム概要
4. docs/00_経営理念_事業構造.md             ← 事業構造・情報分離の原則
5. docs/02_print_spec.md                   ← 印刷・PDF出力共通仕様
6. このファイル
```

### ③ 読了後の返答
全て読み終えたら「引き継ぎ完了。担当領域・未実装・注意事項を報告します」とだけ返答すること。
それ以外の行動（コード生成・ファイル作成・確認ポップアップ）は一切禁止。

---

## 【辞退条件】

以下に一つでも該当する場合、作業を開始せず真柴さんに辞退を申し出ること。

- 引き継ぎ書・設計書を全て読む前に回答できない・する気がない
- 確認前にコードや提案を出すことを止められない
- 場当たり的な回答になると自覚している
- 上記①〜⑫の作業ルールを全て守り通す自信がない

**辞退は恥ではない。守れないまま作業を続けることが問題。**

---

## 作業ルール（絶対厳守）

① 作業前に設計書・会話履歴を確認してから回答する
② 打ち合わせ優先：提案は設計書・ツリーを踏まえて行い、コードは指示があるまで出さない
③ 仕様書修正が必要な場合は先に修正・改訂履歴を追記してからユーザーに確認する
④ フォルダ構成変更時は01_folder_structure.mdを先に修正してユーザーの確認を受ける
⑤ コード生成は①〜④完了後、ユーザー指示があった場合のみ
⑥ 実装禁止事項：localStorage使用禁止・サーバーAPI必須・既存関数の欠落禁止
⑦ 出力前に既存関数の欠落がないか必ず自己確認する
⑧ 違反を認識したら即停止・謝罪後に②に戻る
⑨ 打ち合わせ中のコード生成・ファイル作成は一切禁止
⑩ ポップアップ・確認ダイアログの使用禁止
⑪ 何かを作る前に必ず「作成してよいですか」とテキストで確認してからユーザーの許可を得て実行する
⑫ コンテキスト圧縮・会話が長くなる・仕様書通りに実装できない兆候が見えたら、自ら真柴さんに引き継ぎを提案すること（各担当も同様に義務）

---

## システム概要

### 何のシステムか
探偵業（SPS・SCSPS）のバックオフィス管理システム。
案件管理・会計・労務・マイページを統合したWebアプリ。

### 技術スタック
- フロントエンド: HTML / CSS / Vanilla JS
- バックエンド: PHP（Xserver）
- データ: JSONファイル（DBなし）
- バックオフィスURL: `https://backoffice.scsps.jp`
- 設計書URL: `https://docs.scsps.jp`（Claude専用参照ページ）

### 会社構成
| コード | 正式名 | 種別 | 決算期 |
|--------|--------|------|--------|
| SPS | SPサービス（総合調査SPサービス） | 個人事業 | 1月〜12月 |
| SCSPS | 総合調査SPS株式会社 | 法人 | 7月〜翌6月 |

- データはSPS・SCSPS間で完全分離が原則（法的根拠あり）
- 個人事業データは事業主（真柴直也）のみアクセス可

---

## 担当構成

| # | 担当 | 領域 | 状態 |
|---|------|------|------|
| 1 | 全体管理者 | index・login・共通CSS/JS・調整・承認・営業管理（仮担当） | 引き継ぎ |
| 2 | 会計システム担当 | SPS/SCSPS会計・申告 | 稼働中（引き継ぎ推奨） |
| 3 | 前任者 | マイページ内フリーランス向け会計ソフト | 連携待ち |
| 4 | （兼任予定）案件管理担当 | 案件・報告書・請求書自動生成 | 未着手 |
| 5 | （兼任予定）マイページ担当 | 個人ページ全般 | 未着手 |
| 6 | （兼任予定）労務管理担当 | 給与・社会保険・年末調整 | 一部実装済 |

- 担当を新たに増やす場合・兼任が手一杯になる前に真柴さんに声をかけること
- 営業管理は優先度低・当面は全体管理者が仮担当

---

## 全体管理者の役割と権限

- `docs/01_folder_structure.md` の最終承認権限
- 共有マスタJSON（既存フィールドの変更・削除）の承認権限
- 担当間の調整・指示
- 全設計書・ツリーの把握・整合性確認

---

## 現在の実装状況

### 稼働中
- 会計システム（common/accounting・private/accounting・corporate/accounting）
  - 仕訳入力・試算表・P/L・B/S・確定申告・消費税申告・法人税申告・OCR
  - サーバーJSON保存（localStorage撤廃済み）
- マスタ管理（master/）
- ログイン・TOP（login.html・index.html）

### 未実装・要修正
- **ledger.html（総勘定元帳）印刷余白問題が未解決**
  - Chromeが `@page :right`/`:left`（奇数・偶数ページ余白切り替え）に非対応であることが原因と判明
  - コンテンツ・ロジック（月合計行・次葉繰越・差引金額等）の修正は完了済み
  - 余白の解決方針（Firefox運用限定 or 余白設計変更 or 他）は真柴さんと要相談・未決定
  - 詳細: `docs/00_overview/ledger_handover.md`（会計システム担当引き継ぎ書）参照
- **print.js 新規作成済み**（`/common/js/print.js`）→ ledger.html以外の全書類への適用は未完
- **他の印刷対応書類**（trial.html・pl.html・bs.html・tax.html等）の印刷仕様を print.js 対応に更新が必要
- 案件管理（private/cases・corporate/cases）
- 営業管理（private/sales・corporate/sales）
- マイページ全般
- 労務管理（一部実装済みだが未完成）
- 銀行CSV読み込み機能
- 勘定科目一括変更ボタン
- CSVシリアル値の日付変換（既存データ一括修正も必要）

詳細は `docs/01_folder_structure.md` の実装状況を参照。

---

## 担当間の主な連携ポイント

### 案件管理 <-> 会計システム
- 転記データは `status: "pending"` で入り、会計担当が確認後 `confirmed` にする
- 仕訳データに `case_id` フィールドで案件IDを紐づけ
- 詳細: `docs/07_accounting/11_receipt_ocr.md`

### 領収書・OCRの共用
- `save_receipt.php` / `ocr_receipt.php` は会計担当が実装済み
- 案件管理担当はこれを共用する（独自実装禁止）
- OCR入力対応範囲: カメラ撮影・画像ファイル選択・PDF

### マスタ <-> 全担当
- `master/accounts.json` のfetchは `/master/accounts.json`（絶対パス）を使う
- `https://docs.scsps.jp/master/accounts.json` は使わない（CORSエラー）
- 共有マスタの既存フィールド変更は全体管理者の承認必須

---

## 特記事項

### localStorageキー形式
- 仕訳データ: `journals_v2_[会社コード]_[年]`
- 現在はサーバーAPI（load_journals.php / save_journals.php）に移行済み
- localStorageは使用禁止

### 法人第1期
- 総合調査SPS株式会社の設立: 令和元年11月1日
- 第1期: 2019-11-01〜2020-06-30
- 第2期以降: 7月1日〜翌年6月30日

### 消費税
- 両社とも簡易課税・第五種（サービス業）みなし仕入率50%
- インボイス登録番号:
  - 個人事業（SPサービス）: T1810290539036
  - 法人（総合調査SPS株式会社）: T9130001065624

### UIルール
- HTMLにアイコン・絵文字使用禁止（設計書・ドキュメント内はOK）
- HTMLにサンプルデータ禁止
- 詳細: `docs/03_ui_design/01_design_guideline.md`

### サーバー構成
| 項目 | 内容 |
|------|------|
| サーバー | Xserver（xs418819） |
| バックオフィスURL | `https://backoffice.scsps.jp` |
| 設計書URL | `https://docs.scsps.jp` |
| 仕訳データ保存先 | `/backoffice/data/accounting/[private\|corporate]/[年]/journals.json` |
| 領収書保存先 | `/backoffice/data/receipts/[private\|corporate]/[年]/[月]/[仕訳ID].jpg` |
| APIキー設定 | `/backoffice/config.php` |

---

## 真柴さん（オーナー）について

- 要件定義・最終承認が役割
- 技術的な判断は全体管理者に委ねる
- 確認・承認が必要な場面では必ず真柴さんに通すこと

---

## 改訂履歴

| 日付 | 版 | 担当 | 内容 | 理由・影響範囲 |
|------|----|------|------|--------------|
| 2026-03-20 | 1.0 | 全体管理者（初代） | 初版作成 | |
| 2026-03-22 | 2.0 | 全体管理者（2代目） | 全面更新。作業ルール⑫追加・現状反映・ledger.html未完成を追記 | コンテキスト圧縮・仕様書通りに実装できなかったため引き継ぎ |
| 2026-03-23 | 2.1 | 会計担当 | 会計システム部分を実態に合わせて修正。ledger.html余白問題の原因・状況・print.js新規作成を追記 | 会計担当引き継ぎに伴い正確な進捗を反映 |
| 2026-03-24 | 2.3 | 全体管理者（3代目） | 【最優先】セクションを改訂。着任時にhttps://docs.scsps.jp/をfetchして自走で読む手順を追加。masterデータの注意事項・HTMLのみ渡し必要である旨を明記 |
| 2026-03-23 | 2.2 | 全体管理者（3代目） | 【辞退条件】を作業ルール直前に追加 | 設計書未確認・場当たり回答を繰り返す担当を事前に排除するため |