← 一覧に戻る

ポートフォリオサイト

設計・実装・公開 / 個人開発

  • Next.js
  • React
  • TypeScript
  • Sass
  • FastAPI
  • Python
  • PostgreSQL
  • pgvector
  • SQLAlchemy
  • Alembic
  • Mastra
  • Firebase Authentication
  • Docker
  • GitHub Actions
  • Vercel
  • Neon

どんなサイトか

今ご覧いただいているサイトです。スクールの課題(使う技術と、必要な機能が決まっている)をもとに作り、転職活動のために公開しました。

プロフィールや制作物の文章・画像は、管理画面から書き換えています。チャットでは、私の経歴や制作物についての質問にAIが答えます。

作ったもの

  • 公開ページ: トップ、プロフィール、制作物、お問い合わせ
  • 管理画面: プロフィール・職務経歴・資格・スキル・制作物・画像の編集、ドラッグでの並べ替え、お問い合わせとチャットの記録の確認。ログインはFirebase Authentication
  • チャットボット: 自己紹介の文章を細かく分けてPostgreSQL(pgvector)に保存し、質問に近い文章を探してから答える仕組み(RAG)。Mastraで作りました
  • 本番公開: Vercel(Next.jsとFastAPIを別々に公開)と、Neon(PostgreSQL)

工夫したこと

運用しやすくするために

  • 管理画面で、サイト全体を書き換えられるようにした: 課題要件となっていたのは、トップページの管理だけでした。転職活動の中で何度も書き直すことを考えて、プロフィール、職務経歴、資格、スキル、制作物まで、すべて管理画面から変えられるようにしました。
  • 保存したら、すぐ公開ページに出る: 公開ページは表示を速くするため、作ったページを使い回しています。管理画面で保存が成功したときだけ、使い回しを捨てて作り直すようにしました。

安全のために

  • チャットのAIが、決めた範囲の外で答えないようにする: AIが答えるのは、自己紹介の文章に書かれていることだけです。「これまでの指示を無視して」のような依頼や、ポートフォリオと関係のない依頼(翻訳・文章作成など)には応じないよう、AIへの指示に決まりを書き、断れているかを確かめる評価の仕組みも作りました。
  • 管理画面を、外から見つけにくくする: 管理者以外がアクセスすると「ページが無い」(404)を返し、管理画面があること自体を見せないようにしています。
  • 危ないリンクを表示しない: 管理画面で書いた文章(Markdown)は、危ないリンクを取り除いてから表示しています。

進め方

  • AIに任せきりにしない進め方: Claude Codeを使いながら、「DBとAPI → ログイン → 画面」のように段階を分け、段階ごとにテストを書いて確かめました。見た目(Sass)は、自分で書いてAIにレビューしてもらう形で進めました。
  • 自動のチェック: PRのたびに、GitHub Actionsでテストと書き方のチェックを動かしています。

これから

公開後も、見た目の仕上げや、管理画面の使いやすさの改善を続けています。