読み込み中

mozaic.fm 実装ドキュメント

実装ドキュメント

ここは mozaic.fm というサイト自身の設計と実装の現状をまとめた場所である。 podcast の聴き方や購読方法を説明する場所ではない。読者として想定しているのは、 このサイトがどう作られているかを知りたい開発者と agent である。

内容は「今どうなっているか」を現在形で書く。変更の経緯や検討の記録は含めない。 したがってここに書かれていることは、常に動いている実装と一致しているべきものである。

section

  • アーキテクチャ

    runtime の構成、build pipeline、host の分担。リクエストが最初に触れるものから 順に、どこで何が起きるかを追える形で説明する。

  • デザイン

    色とタイポグラフィの設計。値をどう決めたかではなく、値がどう導出され、 何が機械的に検査されているかを説明する。

  • 運用

    VPS 上で source を書き換えずに配信物の検査、build、restart、2 層の起動確認を直列実行する deploy。型検査と test は開発端末で通す。

  • 決定

    対応ブラウザの基準と先端機能の採用条件、Web 経路を IPv6 only にする判断。

この site の位置づけ

mozaic.fm は web technology を扱う podcast であり、このサイトはその配信基盤である。 同時に「番組で扱った web の先端機能を、自分のサイトで実際に使ってみる場」でもある。 したがって実装には、安定性より先に実地で試すことを選んだ箇所がいくつかある。 そうした箇所は各ページで、なぜその判断をしたかとともに書く。

ブラウザ対応の基準は Baseline Newly available である。そのラインに達した機能は fallback なしで採用し、達していない機能は feature detection と graceful degradation を 書ける場合にだけ採用する。再生・字幕・検索という中核機能は、どの実験によっても壊さない。