メインコンテンツへスキップ
見出し画像

【個人開発】GitHubアカウントを整理しました & 現在開発中の独自基盤「Project Honjin」のご紹介

    今年、フリーのソフトウェア開発エンジニアとしていくつか目標を掲げていましたが、先日公開したポートフォリオに続き、個人のGitHubアカウントもようやく整備できました。

    用意したリポジトリは、とりあえず個人開発として取り組んでいる2案件です。一つは2021年に開発したLaravelベースのオリジナルCMSですが、こちらはドキュメントが全く整備できておらず、ここ数年野放しなので一旦放置します(笑)。

    そしてもう一つが、今年から開発着手した、その名も「Project Honjin(プロジェクト本陣)」です。

    これは具体的な単一プロダクトを作るものではないです。
    日本の戦国武将たちが戦況の変化に即座に対応して陣形を組み替えて戦ったように、柔軟かつ強靭なシステムを目指して「Project Honjin」と名付けました。

    以前、取材先で知見を得た「洋上プラント(石油プラットフォーム)」の構造や保守・運用の形態からヒントを得ています。まずはシステムの中核となる「堅牢で汎用的な土台(本陣)」を構築し、そこへ後から必要に応じた業務機能やモジュールを柔軟にアドオンしていく「マイクロカーネル・アーキテクチャ」を採用しました。

    そしてバックエンドはPython(FastAPI)、フロントエンドはReact(Vite / TypeScript)によるSPAを採用しています。将来的にはAWSへの移行も視野に入れていますが、今回の本番環境(基盤)は、あえて自宅のSynology NAS上にDockerを用いて構築しています。

    画像
    Project Honjin の全体イメージ。現在は中央を作り込み中

    実は、NASでのDockerフルスタック開発には特有のニッチな制約が多く潜んでいました。例えば、NAS本体のシステム(DSM)が内部でPostgreSQL(ポート5432)を占有しているため、そのままではポート競合が起きてしまいます。これはホスト側のポートを15432にずらすことで回避しました。

    また、NASの共有フォルダ上で直接npm installを実行すると、ファイルシステムの相性により依存関係ツリーが崩壊するバグにも悩まされました。これに対しては、Nodeモジュールを含めない状態でファイルを配置し、Dockerのビルド工程内(NASのボリュームマウントの影響を受けない領域)でインストールを完了させる手法をとることで完全に回避しています。

    現在はリバースプロキシ(Traefik)をネットワークの司令塔として据え、フロントエンドとバックエンドがシームレスに連携する構成を組んでいます。

    そうそう、今回の開発では、以下のテーマを設けて取り組んでいます。

    • 低コストかつ安全に、短時間でバグ改修やバージョンアップ、機能追加を行えるシステム、開発手法を模索する

    • 不正アクセスが発生する事に備え、ゼロトラストな考え方による設計思想を導入

    • 生成AIを用いた開発手法を学習する

    • 本案件を一つの資産として捉え、今後、他の開発案件で使えるものがあれば、容易に転用できるようにする

    開発はまださわりの段階ですので、WEB上で実際に動く画面をお見せできる状態になったら、あらためて「公開」のお知らせをしたいと思っています。将来的には他のフロントエンドスクリプトやゲームエンジン、Raspberry Piとの連携などにも対応できるよう拡張していく予定です。

    本リポジトリはポートフォリオおよび個人的な開発の記録として公開しているため、現時点では他者からのPull Requestなどは受け付けていません。隙間時間で開発しているので進捗は遅いと思いますが、ご興味があれば、気が向いた時にでも覗いて頂けると嬉しいです。


     
     
    横浜で18年ほど修行したフリーランスの50代WEBエンジニア。 2025年7月に実家の広島県にUターンしました。 こちらはITやプログラミング、仕事、ビジネス、私生活で起こった事、やってみた事、考えた事の備忘録となります。 あくまで自分のためですが、何かの参考になるなら幸いです。

    あなたへのおすすめ