L-Core Mail Quota Manager 作業記録

Version 1.0 / 2026-11-14 / 設計・引き継ぎ記録

1. 目的

POP3等のクライアントでサーバー上のメールが削除されず、メールボックス容量が逼迫する事態に備える。利用者への事前通知、返信による中止、NASへの検証済み退避を経て、安全に容量を回復する。

2. 確定した基本方針

容量使用率80%以上で事前通知する。
返信による中止を受け付け、通知から72時間以上の猶予を設ける。期限は日本時間の正午に合わせる。
返信がなく期限を過ぎた場合のみ、対象メールをNASへ保存しSHA256照合した後に削除する。
削除後は doveadm quota recalc -u MAILBOX を実行し、実際の使用率が70%未満であることを確認して完了とする。
利用者への削除後通知は送らない。管理者への成功・失敗通知の宛先は quota-manager@dazoo.ne.jp。
cronは案件完了後も維持し、次回の80%超過を監視する。
既存のcron、状態ファイル、NASバックアップは、新版の検証・切替までは変更しない。

3. 現行パイロット

項目	V33	V34
対象	`ppal_sato@yoc.jpn.com`	`maeyama@tohoku-butsuryu.co.jp`
モード	IMAP拡張：サブフォルダーを含める	IMAP標準：INBOX、Spam、Junkを対象とし、Sentを保護
試験時クォータ	500 MiB	300 MiB
2026-11-06の削除結果	511通 / 125,314,415バイト	2,125通 / 86,183,103バイト
2026-11-14手動recalc後	56%	58%
既存状態	`COMPLETED`	`COMPLETED`

両パイロットのバックアップと削除は完了済み。既存案件を再実行したり、過去分の通知を新規送信したりしない。

4. 現行コードの問題

削除後に doveadm quota get するだけで、クォータ再計算がない。
再計算・70%未満確認前に COMPLETED を記録してしまう。
管理者への成功・失敗通知がない。
既存の COMPLETED 状態により、次回80%超過時の新規案件を開始できない。
ユーザーごとにPythonスクリプトとcronを増やす方式であり、共通化が必要。

5. V35の目標構成（未完成）

機能	設計
実行	共通エンジン1本、朝8時・正午の共通cron計2行を想定
対象管理	ユーザー別設定を分離。新規ユーザーの監視対象化と自動削除許可は区別
削除モード	POP3、IMAP標準、IMAP拡張
安全性	NASマウント検証、SHA256照合、返信確認、変更されたMaildirファイルの拒否
状態管理	案件単位の通知・待機・中止・削除・完了・障害記録。重複送信と二重削除を防ぐ
終了判定	quota recalc → 実使用率70%未満 → COMPLETED → 管理者通知

注意：V35統合版は設計段階。次回80%超過の自動再開、削除途中の障害復旧、通知再試行の完全な検証は未完了。候補コードの構文検証だけで本番投入しない。

6. ディレクトリ構成

/root/lc_mail_quota/
  bin/       実行コード
  config/    アカウント設定（今後）
  state/     新版状態管理（今後）
  logs/      ログ（今後）
  backup/    退避・バックアップ
  archive/   旧版スクリプトの保存

既存の状態ファイルは /root/lc_mail_quota_state/ に残す。NAS保存先は /mnt/nas_rsync/mail_archive/。旧状態の移動や初期化は行わない。

7. 現行cron（切替前）

/etc/cron.d/lc-mail-quota-manager
  08:00 V33 morning
  12:05 V33 noon
/etc/cron.d/lc-mail-quota-manager-v34
  08:00 V34 morning
  12:05 V34 noon

旧cronは自動的には消えない。新版が十分に検証されてから旧cronを停止し、共通cronへ切り替える。停止中の監視空白に注意する。

8. 今後の作業

V33/V34の削除対象の違いを維持した共通エンジンを作成。
アカウント設定と監視対象の登録方法を決定。
通知・返信・期限・バックアップ・削除・再計算・結果通知を模擬環境で検証。
削除途中のクラッシュ、NAS切断、部分削除、通知失敗、再実行の復旧試験。
既存COMPLETEDを保護しながら、新規80%超過を扱う案件更新方式を実装。
本番移行手順とロールバック手順を確定後、cronを切り替える。

9. 作業上の注意

s2はrootシェル前提。コマンドに sudo は使わない。
シェル出力の先頭見出し行だけを緑色・太字にする。
Bash変数名 GROUPS は使用しない。
現行の状態・削除ジャーナル・NASアーカイブを保護し、既存案件の再削除を防ぐ。
確定事項と未実装・未検証事項を混同しない。