左が最優先。タブを①から順に1つずつ片づける

今日の作業

左が最優先

2026年9月30日（水）

左から順に片づけます。①対応→②制作→③今日の予定→④更新期限→⑤終業前（バックアップ復旧＋反映確認）。

3残りの作業

⑤ 終業前

Cursorで終業前チェック

普段は閉じたままでOKです。毎日は「終業前」、月1回は「外付けHDD」、PC故障時は「復旧用」を開いてコピーしてください。

毎日 — 手順と終業前プロンプト

Cursorで シンプルセブン を開く（中に 中央管理システム）
New Agent を選ぶ
下の「終業前チェックをコピー」→ 貼り付け（A→B-1→B-2）
B-1: run_backup.py（MySQL + 金庫） / B-2: run_pc_sync.py --all（金庫も自動更新）

貼る場所: Cursor → New Agent の入力欄

【HWYS CENTRAL｜本日の作業終了前｜バックアップ（復旧）＋顧客向け文言の反映確認】
日付: 2026年9月30日

あなたは Cursor の Agent です。
ワークスペースは「シンプルセブン」配下の「中央管理システム」です。

## 目的（この2つをセットで最後まで）
1. **PCが壊れても復旧できるバックアップ** — CENTRAL・契約会社情報・弊社情報（MySQL＋ファイル）
2. **サービス内容・FAQの反映漏れゼロ** — 顧客画面と契約・法務の内容を揃える

作業を終える前に、下記 **A → B-1 → B-2** の順で実行し、成功を確認してから終了してください。途中で止めないでください。

---
## A. 顧客向け文言の反映確認

### いつ A をやるか（自動判定はない — 次のルールで判断）
**A をスキップしてよいのは、次の両方に「はい」と言えるときだけ:**
- 今日、契約・法務の画面を開いて**保存していない**
- 今日、`hwys_central/lib/` の PHP（料金・SLA・FAQ・labels 等）を**変えていない**

**迷ったら必ず A を実行する。**
契約・法務での保存は DB だけ更新され **git に出ない** ため、「触ったか忘れた」が一番危険です。

**補足（自動済み）:** 契約・法務→サービス内容の保存時、FAQ正本8件（表示順10〜80）はサーバ側で自動同期されます。ただし特商法・契約原本・コード正本・grep確認は A が必要です。

### A-1. 地図とルールを読む（省略禁止）
- `10_説明書/顧客向け文言_正本と反映先マップ.md`
- `.cursor/rules/customer-copy-sync-checklist.mdc`

### A-2. 変更内容を特定し、旧文言を grep する
変更前の数字・回数・時間・ラベルをリポジトリ全体検索（例: `15000` `月1回` `修正依頼`）。
ヒットしたファイルが「反映先候補」。地図と照合し、反映漏れをゼロにする。

### A-3. 正本から順に揃える（コード正本 > DB > 説明書）
| 変更 | 正本（最初に直す） | 必ず確認する反映先 |
|------|-------------------|-------------------|
| 料金数字 | `lib/service_pricing.php` | 契約・法務→サービス内容（DB）、`portal_service.php`、特商法ひな形、契約原本 |
| 納期・対応時間 | `lib/service_sla.php` | 上記＋FAQ正本 |
| サービス内容の行 | 契約・法務→サービス内容（DB）＋ `legal_service.php` | `portal_service.php`、必要なら「現行仕様に同期」 |
| FAQ（数字入り8件） | `lib/portal_faq.php` の `hwys_portal_faq_canonical_items()` | 下記 A-4 → `portal_request.php` / `portal_feedback.php` |
| 画面ラベル | `lib/labels.php` | grep で直書き残りがないか |
| 特商法・プライバシー | 契約・法務タブ ＋ `legal_tokusho.php` / `legal_privacy.php` | `portal_tokusho.php` 等（FAQに全文は載せない） |

### A-4. FAQ 正本を DB へ反映（契約・法務を触った日・PHPを変えた日は必須）
実行:
`python 08_PC連携/run_php_with_db.py hwys_central/cli/sync_portal_faq_canonical.php`
- 対象: 表示順 10〜80 の8件のみ上書き
- 表示順 100 以降の運営追加 FAQ は削除しない
- サービス内容の画面保存だけの日は自動同期済みでも、**PHPを変えた日は必ず実行**して確認する

### A-5. 契約上・内容として重要な変更があった場合（人の判断）
- 契約・法務 → サービス内容 → **「全社へ確認通知」**（版数・同意の記録）
- 黙って画面だけ変えない（顧客との認識ズレ防止）

### A-6. コードを変えたら本番反映（A-4 の後）
`09_本番反映/deploy_safe.cmd --skip-pc-sync`
（本番反映の前に MySQL バックアップも走る。B-1 と重複しても問題ない）

### A-7. ブラウザで警告ゼロ確認（英語 Warning/Notice が出たまま終了しない）
最低限:
- 顧客ポータル「サービス内容・料金」
- 「修正・打合せ依頼」「ご要望・改善」（FAQ検索含む）
- 運営「契約・法務」該当タブ
ベース URL: `https://tyuoukanri.hwysgroup.com`（トークンはチャットに書かない）

### A の完了条件
- [ ] 地図の反映先をすべて更新した（grep で旧文言が残っていない）
- [ ] FAQ 同期を実行または自動同期済みを確認した
- [ ] 重要な変更は確認通知の要否を判断した
- [ ] 本番反映とブラウザ確認まで完了した（該当する場合）

完了したら「顧客向け文言の反映確認完了」と箇条書きで報告する。

---
## B-1. 復旧用バックアップ（毎日必須・PC故障時の本命）

### 目的
- Xserver 上の **MySQL 全体**を PC に保存し、同時に **暗号化金庫**を Xserver `_vault/` へ更新
- 金庫の中身: `.env`・`config.php`・**全顧客の credentials / deploy / api_keys / SSH鍵**・MySQL スナップショット
- リポジトリ（コード）も ZIP 保存

### 手順
1. 作業場所が `…/シンプルセブン/中央管理システム` であることを確認
2. `.env` に `HWYS_SECRETS_VAULT_PASS=…` があることを確認（チャットに書かない）
3. 実行: `python 09_本番反映/run_backup.py`
   （時間がない日は `--mysql-only` でも可。週1回はフル推奨）
4. 結果確認:
   - `Documents\HWYS_SimpleSeven_backups\latest_backup.txt` が今日の時刻
   - CENTRAL「復旧用シークレット」画面で顧客フォルダ件数が更新されている

### B-1 の完了条件
- [ ] `run_backup.py` が成功した
- [ ] `latest_backup.txt` が更新された
- [ ] 復旧用シークレット画面に金庫の更新日時が出ている

---
## B-2. 顧客フォルダ同期（毎日必須・制作・Cursor作業用）

### 目的
- 各契約会社の `顧客情報管理ファイル/` を最新化
- `_hwys_cursor/` を更新
- 本番 `_secrets_clients/` へ秘密を同期
- **成功後、暗号化金庫も自動更新**（`HWYS_SECRETS_VAULT_PASS` があるとき）

### 手順
1. 実行: `py -3 "08_PC連携/run_pc_sync.py" --all`
2. 結果確認: 失敗件数 0、`08_PC連携/.last_pc_sync.json` が更新
3. 失敗時は DB接続・トンネル・`.env` を確認して再実行

### B-2 の完了条件
- [ ] `run_pc_sync.py --all` が成功した
- [ ] 同期スタンプが更新された
- [ ] 顧客フォルダ側に `_hwys_cursor` がある

---
## 最終報告
A（実施した場合）・B-1・B-2 の結果をまとめ、バックアップファイルのパスと FAQ 同期の有無を書いて「終業前チェック完了」と報告して終了してください。

B-1: run_backup.py / B-2: run_pc_sync.py --all

月1回 — 外付けHDDへ全データ保存

サーバーが壊れたときの保険です。既定の保存先は D:\HWYS_SimpleSeven_monthly（別ドライブは HWYS_EXTERNAL_HDD_ROOT か --dest=）。

外付けHDDを接続する
Cursor で シンプルセブン を開く → New Agent
下の「月次HDDをコピー」→ 貼り付け → Agent が backup_to_external_hdd.py --fresh を実行
「外付けHDD月次バックアップ完了」が出たらOK

貼る場所: Cursor → New Agent の入力欄

【HWYS CENTRAL｜月1回｜外付けHDDへ全データ保存】
日付: 2026年9月30日（対象月: 2026年9月）

あなたは Cursor の Agent です。
ワークスペースは「シンプルセブン」配下の「中央管理システム」です。

**これは毎日の終業チェックとは別です。** ユーザーが外付けHDDを接続したあと、「月次バックアップ」「外付けHDD」と言ったときだけ実行してください。

---
## 人が先にやること（Agent 実行前）

1. **外付けHDDを PC に接続**する
2. 保存先フォルダを用意（無ければスクリプトが作る）:
   - 既定: `D:\HWYS_SimpleSeven_monthly`
   - 違うドライブなら `.env` に `HWYS_EXTERNAL_HDD_ROOT=E:\HWYS_SimpleSeven_monthly` など
3. 金庫の復旧用パスワードは **パスワードマネージャー** にあり、HDD には「パスワードそのもの」をチャットに書かない

---
## Agent の手順（この順・途中で止めない）

### M-1. 日次バックアップを最新化してから HDD へコピー
作業場所が `…/シンプルセブン/中央管理システム` であることを確認し、実行:

```text
py -3 09_本番反映/backup_to_external_hdd.py --fresh
```

- `--fresh` … 先に `run_backup.py`（MySQL + コードZIP + 金庫）を走らせてからコピー
- ドライブが見つからないとき: 接続を確認し、`--dest=E:\HWYS_SimpleSeven_monthly` のように指定して再実行
- 顧客フォルダが巨大で時間がかかる場合のみ、ユーザー同意のうえで `--skip-customers` 可（非推奨）

### M-2. 結果確認
- コンソールに「外付けHDD月次バックアップ完了」と保存先パスが出る
- `Documents\HWYS_SimpleSeven_backups\last_external_hdd_backup.txt` が今日の日時
- HDD 側に `monthly_YYYYMM\` があり、中に:
  - `HWYS_SimpleSeven_backups\`
  - `顧客情報管理ファイル\`（スキップしていなければ）
  - `secrets_hint\`（あれば）
  - `MONTHLY_BACKUP_STAMP.txt` / `README_月次バックアップ.txt`

### M-3. 秘密をチャットに出さない
`.env`・パスワード・APIキーの中身は報告しない。「コピー済み」「パスのみ」で報告する。

---
## 完了条件
- [ ] `backup_to_external_hdd.py --fresh` が成功した
- [ ] HDD 上に今月の `monthly_YYYYMM` フォルダがある
- [ ] `last_external_hdd_backup.txt` が更新された
- [ ] 秘密の値をチャットに書いていない

## 最終報告
「外付けHDD月次バックアップ完了」と、保存先フルパス・`--fresh` の成否・顧客フォルダの有無を箇条書きで報告して終了する。

HDD接続後に実行。中身: PCバックアップ + 顧客フォルダ + secrets_hint

PC故障時 — 新PCの工程と復旧プロンプト

復旧用シークレット（.env 取得） — 新PCでは先にここでパスワード入力 → .env 保存 → その後プロンプトを Agent へ。

新PC → Cursor インストール → シンプルセブン/中央管理システム/ 作成
上のボタンで .env をダウンロードしてフォルダに保存（チャットに貼らない）
Cursor で シンプルセブン を開く → 下の「復旧用をコピー」→ Agent

貼る場所: Cursor → New Agent の入力欄

【HWYS CENTRAL｜PC故障・データ消失時の復旧】
日付: 2026年9月30日

あなたは Cursor の Agent です。
ワークスペースは「シンプルセブン」配下の「中央管理システム」です。

**これは平常の終業チェックとは別の指示です。** ユーザーが「PCが壊れた」「CENTRALを戻したい」「復旧して」と言ったときだけ実行してください。

---
## 新PCから完全復旧 — 工程（この Agent を動かす前に、人がやること）

1. **新PC**を用意し、**Cursor** をインストールする
2. デスクトップにフォルダを作る（空フォルダだけでは不十分）:
   ```
   シンプルセブン/
   └── 中央管理システム/    ← この中に .env を置く
   ```
3. ブラウザで **CENTRAL にログイン** → **「復旧用シークレット」** 画面を開く  
   （今日の作業 → 終業前 タブ内のリンク。顧客一覧から入ればトークンは自動）
4. **復旧用パスワード**を入力 → **「.env をダウンロード」**（必要なら「一式 ZIP」も）
5. ダウンロードした `.env` を `シンプルセブン/中央管理システム/.env` に保存  
   （メモ帳で保存してリネームでも可。**チャットに貼らない**）
6. **一式 ZIP** を取得したら、Cursor ターミナルで（パスは実際のダウンロード先に合わせる）:
   ```text
   py -3 08_PC連携/restore_from_xserver.py --zip=（ZIPのフルパス）
   ```
   → `.env`・`config.php`・各社 `_secrets/`（credentials / deploy / api_keys / SSH鍵）を展開し、本番 `_secrets_clients` で補完 → `run_pc_sync --all`
7. **Cursor** でフォルダ **`シンプルセブン`** を開く
8. この復旧用プロンプトを Agent に貼り、**R-1 以降**を確認する

**PC故障直後も止まらないもの（Xserver 本番が無事なら）:**
- 各顧客の HP（顧客各自の Xserver DB）
- CENTRAL・顧客ポータル・弊社 HP（本番 MySQL + PHP）
- 本番 `_secrets_clients/` 経由の投稿・デプロイ（最後の PCへ反映 以降）

**新PCで戻すもの:** Cursor 作業環境・各社 `_secrets` 原本・SSH 鍵 → **暗号化金庫 ZIP** + **本番 DB 同期**

**重要（秘密キー）:** この指示文に **パスワード・APIキーを書き込まない**。Agent は **`中央管理システム/.env` をローカルファイルとして読む**（チャットに貼らせない）。

---
## R-0. Xserver から情報を引き出す（PC故障時・本番が無事なら最初にここ）

**目的:** バックアップが古い／PCだけ壊れたとき、**Xserver を正として**最新データと設定を PC に戻す。

### R-0-1. 接続の準備（`.env` は手順どおり復元済みであること）
1. `シンプルセブン/中央管理システム/.env` が存在することを確認（CENTRAL の復旧用シークレットから取得済みが望ましい）
2. 無い場合のみ: Xserver パネル＋`08_PC連携/dotenv.remote.pc.sample.env` で **ユーザーが手入力**（復旧用シークレット ZIP が最優先）
3. 接続テスト: `py -3 08_PC連携/mysql_run.py -q "SELECT 1"`
4. FTP用: `.vscode/sftp.json` を戻すか、パネルの FTP 情報で再設定

### R-0-2. Xserver から CENTRAL の DB を PC に取る（読取）
```text
python 09_本番反映/run_backup.py --mysql-only
```
→ `Documents\HWYS_SimpleSeven_backups\HWYS_mysql_*.sql` が最新になる（**本番からの取得＝バックアップ作成**）

### R-0-3. Xserver からプログラム・config を取る
1. FTP で本番から `hwys_central/config.php` をダウンロード → ローカル `hwys_central/config.php` に保存  
   （`config.sample.php` ではなく **本番の実ファイル**）
2. コード全体が無い場合: `HWYS_files_*.zip` を展開、または git clone 後に `deploy_safe` で本番と照合
3. **config.php の内容をチャットに貼らない**（報告は「取得済み」のみ）

### R-0-4. 顧客フォルダと Cursor 作業環境を本番から再生成
`restore_from_xserver.py` 実行後、または `.env` 復元後に:
```text
py -3 "08_PC連携/run_pc_sync.py" --all
```
→ `顧客情報管理ファイル/_hwys_cursor/` が本番 DB から再生成される  
→ 各社 `_secrets/` は **金庫 ZIP に含まれる**（credentials / deploy / api_keys / `*.key`）。不足分は本番 `_secrets_clients/` から自動補完

### R-0-5. Xserver API（任意・キーが .env にある場合のみ）
```text
py -3 09_本番反映/xserver_cli.py ping
py -3 09_本番反映/xserver_cli.py db-list
```
`XSERVER_API_KEY` が `.env` に無い場合はスキップ（パネル操作に切り替え）

### R-0 の完了条件
- [ ] `.env` またはパネル由来の接続で MySQL に繋がった
- [ ] 本番 `config.php` を FTP で取得した
- [ ] `run_backup.py --mysql-only` または `run_pc_sync --all` で本番データを PC に取った
- [ ] 秘密の値をチャット・ログに出力していない

---

## 前提（どこから何を戻すか）

| 優先 | 復旧元 | 中身 |
|------|--------|------|
| 1 | **弊社 Xserver 本番** | 稼働中 MySQL・PHP・`_secrets_clients/`・`_vault/secrets_vault.enc`（暗号化金庫） |
| 2 | CENTRAL「復旧用シークレット」ZIP | `.env`・config・全社 `_secrets`・SSH鍵・（あれば）`backup/mysql_latest.sql` |
| 3 | `run_pc_sync --all` | DB から `_hwys_cursor`・顧客フォルダ構成を再生成 |
| 4 | `Documents\HWYS_SimpleSeven_backups\` | ローカル MySQL ダンプ・コード ZIP（補助） |
| 5 | **外付けHDD 月次**（`D:\HWYS_SimpleSeven_monthly\monthly_YYYYMM\`） | PCバックアップ一式＋顧客フォルダ＋secrets（**サーバー全損時の本命**） |

**PCだけ壊れて Xserver が無事なとき:** 金庫 ZIP → `restore_from_xserver.py` → `run_pc_sync --all` が最短。MySQL インポート（R-2）は **CENTRAL の DB も壊れたときだけ**。

---
## 平常時 — 弊社 Xserver へ何を載せているか（復旧の正本）

| 保管場所 | 内容 | セキュリティ |
|----------|------|--------------|
| 本番 MySQL | 顧客データ・契約・ヒアリング・投稿キュー | Xserver DB 権限 |
| 本番 PHP | CENTRAL・ポータル・弊社 HP | 公開ディレクトリ |
| `_secrets_clients/{id}.env` | 投稿・外部ログイン用（PCへ反映で同期） | 非公開ディレクトリ |
| `_vault/secrets_vault.enc` | **暗号化金庫**（全社 secrets + SSH鍵 + .env + config + MySQLスナップショット） | AES + 復旧用パスワードのみ復号 |

**復旧用パスワードだけは Xserver に保存しない**（漏洩防止）。パスワードマネージャーに控える。

---
## 秘密情報の保管（プロンプトに鍵を埋め込まない理由）

| 方法 | 可否 | 理由 |
|------|------|------|
| ダッシュボードの指示文に鍵を埋め込む | **× 禁止** | 本番HTML・Cursor履歴・スクショで漏れる |
| チャットに鍵を貼って復旧 | **× 禁止** | ログに残る |
| 外付けHDDの `.env` を戻して Agent が読む | **○** | 補助（正本は Xserver 金庫） |
| Xserver FTP で `config.php` を取る | **○ 推奨** | 本番に実ファイルがある |
| パスワード管理ツール／暗号化USB | **○ 推奨** | PC故障でも別経路で復元 |

**個人用:** 暗号化USBに「秘密情報の所在メモ」（変数名とファイルパスだけ。値はパスワードマネージャー）を置く。ダッシュボードには載せない。

---
## 秘密情報（PC以外にも複製必須）

バックアップ ZIP には **意図的に入れていません**（漏洩防止）。次を **PC以外にも** 保管しておくこと:

| ファイル | 中身 | 推奨する複製先（PC以外） |
|----------|------|--------------------------|
| リポジトリ直下 `.env` | PCからDB接続・APIキー | 暗号化USB／社内クラウド／パスワード管理ツール |
| `hwys_central/config.php` | サーバ側DB設定 | **Xserver上に本番コピーあり**（FTPで取得可）＋別途バックアップ |
| 各社 `_secrets/*.env` と SSH `*.key` | 顧客サーバ接続 | **暗号化金庫**（`backup_secrets_vault.py`）＋本番 `_secrets_clients` |

**終業前 B-1** で `HWYS_SECRETS_VAULT_PASS` を設定し `run_backup.py` を実行すると、金庫が Xserver に更新されます。

---
## 復旧手順（この順）

**R-1. 新しいPCの準備**
1. `シンプルセブン/中央管理システム` を用意（`HWYS_files_*.zip` 展開 or git）
2. `.env` を PC以外の保管場所から戻す（無い場合: Xserverパネル＋`.env`の雛形から再作成）
3. `hwys_central/config.php` を Xserver FTP から取得するか、バックアップから戻す
4. Python・PHP が使えることを確認

**R-2. MySQL を戻す（XserverのDBも壊れた／古いときのみ）**
1. **事前:** Xserver パネルで現状DBのバックアップを1つ取る
2. Xserver パネル → phpMyAdmin → CENTRAL用 DB を選択
3. 「インポート」→ `HWYS_mysql_*.sql`（`latest_backup.txt` にパス）を実行
4. エラーなく完了することを確認（秘密の値はチャットに貼らない）

**R-3. コードを本番に揃える**
1. `09_本番反映/deploy_safe.cmd --skip-pc-sync`（コードが古い場合）
2. migration 確認: `apply_pending_migrations.php` または CLI

**R-4. 顧客フォルダを戻す**
1. `restore_from_xserver.py --zip=…` で金庫 ZIP を展開（推奨）、または
2. `py -3 "08_PC連携/run_pc_sync.py" --all`（DB復旧後に本番から再取得）
3. 各社 `_secrets/` は金庫に含まれる。SSH 鍵が無い社のみ Xserver パネルから再取得

**R-5. 動作確認（英語 Warning/Notice ゼロ）**
- 運営: `index.php`・契約・法務
- 顧客: ポータル・サービス内容・料金・FAQ
- ベース URL: `https://tyuoukanri.hwysgroup.com`

---
## 復旧完了の報告
「復旧完了」と、使ったバックアップの日時・MySQLインポートの要否・秘密情報の復元元・確認URLを箇条書きで報告する。

上部の「新PCの工程」を済ませてから実行