とんペディアへようこそ

はじめに

とんペディアに入ってくれてありがとうございます。

このドキュメントは、あなたが 「自分でアプリを作れるエンジニア」になるための指針 です。
6月下旬には、自分で考えたアプリを動かして発表してもらいます。
今は難しく感じても大丈夫。一緒に進んでいきましょう。

とんペディアというサークルについて

東北大学の学生が開発・運用している学生向けアプリ「とんペディア」を中心に活動するサークルです。

大事にしていること：

• 学び合い — 詰まったら一人で抱え込まず、メンターや仲間に相談する
• 切磋琢磨 — お互いの成長を刺激し合う
• まず動かす — 理解してから動かすより、動かしながら理解する

このドキュメントの使い方

進め方の基本

各ページは 「読む → 手を動かす → 確認する」 の流れになっています。
ページを読んで満足するのではなく、必ず手を動かしてください。

このドキュメントは「薄い」ことがある

各ページの説明は、あえてすべてを書いていません。
「これはどういう意味だろう？」「なぜこう書くんだろう？」と思ったら、自分でAIや検索で調べてみてください。

実際の開発では、誰も全部教えてくれません。
自分で調べて、試して、動かす——この習慣を、このドキュメントを通じて身につけてほしいと思っています。

調べ方のコツ: エラーメッセージはそのままコピーしてAIや検索にかける。「〇〇 使い方」よりも「〇〇 で△△したい」と具体的に聞く方が解決が早いです。

ドキュメントのとおりに動かないことがある

このドキュメント自体にも、バグや古い情報が含まれているかもしれません。
それはこのドキュメントだけの話ではなく、公式ドキュメントや技術記事でも同じです。

• ライブラリのバージョンが上がって、書き方が変わっている
• 自分の環境（OS・Node.jsのバージョンなど）によって挙動が違う
• 書いた時点では正しかったが、今は古くなっている

こういうことは、プロのエンジニアでも日常的に遭遇します。
「ドキュメントのとおりにやったのに動かない」は、あなたのせいではありません。

そのときにやること：

1. エラーメッセージをそのままAIや検索にかける
2. 公式ドキュメントの最新版を確認する（バージョンに注意）
3. 「〇〇 動かない」「〇〇 エラー」で検索すると同じ問題にぶつかった人の記録が見つかることが多い
4. それでも解決しなければ、メンターに相談する

「動かないのはおかしい」ではなく、「動かないのが普通。どう直すか」という姿勢が、エンジニアとして成長するための第一歩です。

AIを積極的に使おう

Claude や GitHub Copilot などの AI ツールを積極的に使ってください。
現代のエンジニアは AI と一緒に開発するのが当たり前です。
使い方は AIとの付き合い方 を読んでください。

メンターについて

あなたには専属のメンターが1人つきます。
詰まったら30分以内に相談してください。 一人で悩み続けるのは時間のムダです。
「調べてもわからない」「AIに聞いても解決しない」というときは、迷わず相談してください。

スキップしていい箇所

各ページの冒頭に以下のような表示がある場合、すでに知っている人はスキップしてOKです。

知っている人へ: 「確認しよう」のチェックリストだけやって次に進んでください。

全体のスケジュール

コースを選ぼう

まだ選んでいない人は、メンターと相談して決めてください。

最初にやること

1. 環境構築（Windows） または 環境構築（Mac） を完了させる
2. メンターに「環境構築できました！」と連絡する
3. AIとの付き合い方 を読む

さあ、始めましょう。