この記事を作った動機 2025/10/16 から、2025/10/23 に至るまでの間で OneNote 代替に関して、実装をするなど研究を進めているうちにわかったことなどを簡易的に記録する。
動作の様子 (フロントエンド) TODOs TODOs 2025/10/23 になる間やる項目たち。やりきれなかった分は次に持ち越し。
主な項目 編集機能、データセーブ(更新)の実装
別のページを開いても未保存のデータのバッファが管理されるように各ページタイプを実装する 内部構造を説明する図とかドキュメントを作る
フロントエンド drawio で説明する図を作る 他人が構造の理解に必要な分を記録できたか バックエンド(更新) 新たに追加した、task の仕組みについて、ドキュメントを整備する。 free ページの実装
フロントエンド 共通のUIについて、使い方の説明について、ドキュメントを書いた。 overlayWindow messagebox toolsbar page オブジェクト変形用に汎用的なコンポーネントを定義する。カーソルがオブジェクトをホバーしているときに出現するようにする。タッチでは、一回タップで出現。(サイズ変更、移動) 移動について実装 リサイズ機能についての実装 右下について実装 (とりあえずこれだけにするかも) 下について実装 右について実装 左上について実装 (正しくitemを更新できないバグありで解消中) 左について実装 上について実装 左下について実装 右上について実装 編集モードを各アイテムの要素の種類ごとに実装。汎用的には、ダブルクリックされた場合に編集モードに移行するようにする。タッチではダブルタッチで移行する. フロントエンドを拡張するうえで重要そうな zustand のデータストアの仕様リストを作り、記録を行う。 バックエンド selector の改善
Selector に未保存の表示を行う OverlayWindow において、リサイズやサイズ制限をオプションで付ける。デフォルトでは無効にして、とりあえず selector においてそれが機能するようにする。
Free ページの要素について、基本要素の項目にアイテムの色をRGBAで設定できるようにする。
とりあえず、まだ色を変更するUIがないが、RGBAとしてCSSスタイルを設定してアイテムごとの色を反映するようにFreeページの実装を更新はした。 色を設定するUIや項目へのアクセスボタンを実装する。 全体的な未保存、保存、バッファーの管理について考える
pageType などは現状のままで、増やさず、free と markdown に専念する
tasks -> jobs で定期的に実行されるバックエンドの関数群において、pageCleaner.py を実装する。各ノートにある、参照が消され、deleted.json に記録されていて、一定期間たったページを時期が来たら本当にファイルシステム上から削除する実装をする。コード自体は、tasks.py の設定に依存し、現状では10秒ごとに消す時が来ていないかポーリングする簡易的な実装である。
バックエンド割り込みの実装
バックエンドからフロントエンドの方向の割り込みをすでにドキュメントである程度定義したとおりに実装する。例えば、ページ内容に変更があったら通知したりする。 helper.commonとして、sendIntteruptを実装する。 割り込みが必要なコマンド群から、割り込みを送るようにする。また各コマンドのドキュメントに割り込みについて説明を書く。これに伴いテンプレートも割り込みについて記述するように、更新を行う。 -> 割り込みについては、専用のドキュメントページを作り、そこに記述する フロントエンド側を割り込みを受けつけるように、改修していく。自動的に、フロントエンドが、バックエンドの割り込みによって連動して機能することを確認する。例えば、ページが作成されたとき、内容が変更されたとき、ノートブックが削除された時などに、データサーバが接続しているすべてのフロントエンドに、その通知が行く。各コンポーネントが、必要な割り込みイベントを、listen するような形をとる。 割り込みの仕組みについてのドキュメントの記述が見つからない場合、新たに定義し、それをもとに実装を進める。 ドキュメントに書いた割り込みが実際に機能するよう、各コマンドに割り込みを送るように実装していく。 再接続機能が正しく機能しない場合を検証する
WebSokcet が正常に閉じられなかった場合、自動的にそれを検出して再接続するようにフロントエンドを改修する。 WebSocket が正常に閉じられていないとき、誤作動を起こす件について、データサーバ側を改修することで、ある程度改善を行った。再接続機能改善の試みを詳細は参考にすること。 except asyncio.CancelledError が mainLoop 内で機能していない可能性について調べる。 実はなんか思ってるのと違う WebSocket の閉じ方をしているかもしれないことについて調べる。 opening handshake failed Traceback (most recent call last): File "C:\Users\username\AppData\Roaming\Python\Python312\site-packages\websockets\http11.py", line 138, in parse request_line = yield from parse_line(read_line) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "C:\Users\username\AppData\Roaming\Python\Python312\site-packages\websockets\http11.py", line 309, in parse_line line = yield from read_line(MAX_LINE_LENGTH) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "C:\Users\username\AppData\Roaming\Python\Python312\site-packages\websockets\streams.py", line 46, in read_line raise EOFError(f"stream ends after {p} bytes, before end of line") EOFError: stream ends after 0 bytes, before end of line The above exception was the direct cause of the following exception: Traceback (most recent call last): File "C:\Users\username\AppData\Roaming\Python\Python312\site-packages\websockets\server.py", line 545, in parse request = yield from Request.parse( ^^^^^^^^^^^^^^^^^^^^^^^^^ File "C:\Users\username\AppData\Roaming\Python\Python312\site-packages\websockets\http11.py", line 140, in parse raise EOFError("connection closed while reading HTTP request line") from exc EOFError: connection closed while reading HTTP request line The above exception was the direct cause of the following exception: Traceback (most recent call last): File "C:\Users\username\AppData\Roaming\Python\Python312\site-packages\websockets\asyncio\server.py", line 356, in conn_handler await connection.handshake( File "C:\Users\username\AppData\Roaming\Python\Python312\site-packages\websockets\asyncio\server.py", line 207, in handshake raise self.protocol.handshake_exc websockets.exceptions.InvalidMessage: did not receive a valid HTTP request 他の事項 File API 周りの実装 マルチメディアの対応 selector を複数ページ選択に対応させる ...