Files
Anya Tokugawa 7fe64113c7
Build and publish container images / images (push) Failing after 7m31s
feat: add previewed atomic OPML subscription import and export
2026-11-08 04:39:54 +09:00

4.0 KiB
Raw Permalink Blame History

21. 決定事項・矛盾の整理・未決事項

状態:既存設計の統合と、新規構想の判断台帳。設計案を実装完了に読み替えません。

原資料の読み替え

古い記述・混在 現在の読み方
OIDCは形だけ、UserInfoだけを根拠にする 署名・claim・state/nonce等のhardeningが入っている。詳細契約を優先
CookieをやめてBearer一本にする ブラウザCookieとAPI Bearerを目的分離して併用
匿名ナビゲーション・RSSは未実装 限定公開条件で実装済み。全metaや全依存物の公開ではない
匿名公開はすべて毎Revision再承認 手動公開はそのまま。確認したStreet/Spotのみlive-head自動公開可能
個別記事の一覧登録だけが投稿方法 原子的な新規投稿APIと独立画面を追加済み
同じCampusなら任意ノードでブログ射影 現行の参照型記事射影は同一インスタンスまで
resourceはブラウザを開いたときだけ記録 背景イベントで保存。表示更新と保存間隔は別
groupプロフィールのnamespaceが設計のみ 実装側にgroup画面・APIあり。機能ごとの完了度で読む
Asset名はinstance全体の名前 mutable Asset名はDomain-local、Document hashは不変content identity
イベントキューがあるのでoutboxも完成 queue、個別journal、transactional outbox配送は異なる
すべての文書はHTML正本 文章の正本HTMLと、バイナリ/固有形式の正本を区別

古い文書は削除せず、初期思想・変更理由・実装の追跡用に保持します。本書とコードが違う場合はまず差分を確認し、設計を理由に現在の安全制約を外しません。

新規ADRの案

ID 提案 状態・決めるための条件
ADR-O1 organizerはtyped metadataと任意Page参照 タスク初版は専用表+既存CAS Document Store(2026-09-24)。通常のObject閲覧・リンク・削除の権限境界を拡大せず、個人所有を確実に分離する。DBは捨てられる索引ではない。実装契約
ADR-O2 task共通部+ticket workflow 提案。番号・外部依頼者・遷移権限の要件確認
ADR-O3 ICS/vCard入出力→read-only DAV→双方向 推奨順。対象サーバー/clientを選んで互換表を作る
ADR-O4 簡易利用は内蔵正本、本格運用はFreshRSS正本+PagesWiki connector+newsboat 2026-11-08利用者指定で採用。内蔵・FreshRSS読取・共通UI・OPML入出力まで実装。source単位で正本を分離し、自動fallbackや二重管理はしない。外部書戻しは残件。実環境の接続先・版・資格情報は別途指定
ADR-O5 IMAP read-only、Wikiコピーは明示操作 初期設計方針。providerとsampleが実装前提
ADR-O6 HTMLパーツを先行し全面WYSIWYGは保留 提案。round-tripと操作改善の評価でgo/no-go
ADR-O7 Wiki Pathと外部UID/hrefを分離 共通の設計制約。rename fixtureを全connectorで実施
ADR-O8 外部stateの変更は別段階の明示権限 共通の設計制約。既読・削除・送信の監査と確認

未決事項

利用するFreshRSSの接続先・版・資格情報、対象CalDAV/CardDAV client、IMAP provider、taskの共有単位、ticketの依頼者公開範囲、保持期限、外部接続を許可するhost、RPO/RTO、WYSIWYG採用基準です。これらが未決でもlocal fixtureと設計は進められますが、外部サービスを勝手に立ち上げたり資格情報を流用したりしません。

文書運用

新しい決定には理由・代案・互換影響・試験を残します。変更履歴ledgerと現状の説明を分けます。日本語統合版から詳細原資料へ辿れる対応表を維持し、英語版は同じchapter IDで追従させます。