Files
pages/docs/design/ja/mail.md
T
Anya Tokugawa c1175d389f Implement Knowledge City platform, organizer and DAV integration
Capture accumulated application, UI, CLI, regression tests and design documentation changes, including task project mapping and default CalDAV list naming.

Keep deployment data, backups, local credentials and build artifacts out of Git. Move the Compose enrollment token to an ignored local environment file.
2026-09-27 14:44:43 +09:00

34 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 16. IMAP取り込みとメールからWikiへの保存
状態:設計案。初期はメール原本を変更しない読取専用取り込み。SMTP送信は別機能。
## データと識別
account、mailbox、UIDVALIDITY、UIDを組み合わせてremote identityを持ちます。Message-IDは重複・欠落があるため補助情報に留めます。UIDVALIDITY変更は新しい世代として再照合し、UIDだけで別のメールを上書きしません。[IMAP4rev2](https://www.rfc-editor.org/rfc/rfc9051)。
原MIME/EMLは不変Documentとして保存し、headers、本文part、添付、thread候補を派生metadataへ分けます。メールは私的collectionに属し、必要なものだけWiki Pageへコピーします。メールアドレスとローカルPrincipalを自動同一視しません。
## 初回取り込みと増分
フォルダ・期間・件数・サイズを選んでpreviewします。UID範囲を小batchで取得し、Documentとmetadata確定後にcheckpointを進めます。既読を付けない取得方式を使い、初期実装ではSTORE、MOVE、EXPUNGE等の変更操作を行いません。本文取得には非既読化の `BODY.PEEK` 等の意味を検証します。[IMAP仕様](https://www.rfc-editor.org/rfc/rfc9051)。
切断・timeoutは再試行し、外部の削除とは扱いません。IMAP4rev1互換、OAuth、サーバー固有のlabel/folder挙動は対象providerを選んだ上でfixtureにします。IDLEを採用しても定期照合を残し、全accountで無制限な接続を保持しません。
## 表示
既存EML parser/viewerを再利用し、HTMLはinert処理または分離表示にします。remote画像は既定で読み込まない案です。CID参照はそのメールの添付へ限定し、別のprivate Documentを指せません。添付名のPath traversal、巨大multipart、圧縮bombを制限します。
## Wikiへコピーする操作
確認画面で、宛先Path、題名、本文形式、添付の選択、出典リンク、公開見込みを表示します。共有メールでも自動公開はしません。`copy_receipt(account,message,destination,request_id)` 等で再送を識別し、Page・Revision・固定添付参照・監査を原子的に確定する案です。
コピーした後、元メールが消えてもWiki Pageを消しません。逆にmirrorの保持期限削除で、Wikiから参照されるDocumentをGCしません。コピーは既読・移動・削除・返信を同時に実行する操作ではありません。
privateメールをautomatic公開範囲へ入れると公開されるため、宛先policy versionを確認時と書込時で照合します。公開範囲が変化したら409等で再確認させます。本文を読めることと、外部へ公開できることを混同しません。
## 運用とTODO
MAIL-1:read-only小規模fixtureとcheckpoint。MAIL-2:EML表示・添付境界。MAIL-3:copy-to-Wikiとpolicy競合。MAIL-4:保持・export・account解除。双方向既読同期やメール送信は後続の明示選択です。
認証失敗のbackoff、accountごとの予算、暗号化secret、ログのheader/body秘匿、再取得上限を設けます。UIは最終成功と遅延・失敗を表示し、未取得を「メール0件」としません。