Skip to main content
KISS C#版YAGNI C#版SoC C#版ADR C#版HC/LC C#版DRY C#版Refactoring C#版テスト容易な設計 C#版TDD C#版エラーモデリング C#版レイヤー C#版MVC C#版依存関係ルール C#版DIP C#版DI C#版Is-a/Has-a C#版SOLID C#版GoF C#版Observer C#版CQS C#版状態機械 C#版不変条件 C#版Entity/VO C#版DDD C#版集約と境界 C#版ドメインイベント C#版モジュラーモノリス C#版ヘキサゴナル C#版クリーンアーキ C#版ACL C#版API Contract CSSemVer C#版DbC C#版冪等性 C#版CAPの肌感覚 C#版Outbox C#版Saga C#版CQRS C#版ES C#版境界づけられたコンテキスト C#版

第06章：ソリューション構成：Visual Studioで作る基本形🛠️🪟

今日のゴール🎯​

  • “増えても崩れない”置き場所を先に作っちゃう🏠🧩
  • Visual Studio上で、Host / Modules / Shared がスッと分かるSolution構成を作る✨
  • とりあえず ビルドして動く ところまで行く🚀

0) まず“完成イメージ”を見よう👀✨​

フォルダ構成（おすすめ最小形）📁​

Solution Structure

  • 迷子になりにくい「src」1本立てが強い💪
/MiniECommerce
  /src
    /Host
      MiniECommerce.Host.Api
    /Modules
      /Catalog
        MiniECommerce.Modules.Catalog
      /Ordering
        MiniECommerce.Modules.Ordering
      /Identity
        MiniECommerce.Modules.Identity
    /Shared
      MiniECommerce.Shared
  MiniECommerce.sln

いまは 1モジュール=1プロジェクト でOK👌（次章で“モジュール内レイヤー”を増やすよ🧅）

1) ありがちなダメ例😇💥 → どう壊れる？​

ダメ例：1プロジェクト巨大化モノリス🍝​

  • WebApp 1個だけ
  • 中身をフォルダで「Catalog」「Ordering」って分けてるつもり
  • でも…参照ルールが無いから、どこからでもどこでも呼べる😵

起きること

  • 変更の影響範囲が読めない😵‍💫
  • 「一応フォルダ分けしたのに、結局ぐちゃぐちゃ」になりがち🍝
  • テストもしんどい🧪💦

2) 良い例😎✨：SolutionとProjectで“境界”を作る🧱​

良い例：Host / Modules / Shared を物理的に分ける🏠📦​

  • Host：アプリの入口（Web API / UI / 起動）🚪
  • Modules：業務のまとまり（Catalog/Ordering/Identity）🛒🧾👤
  • Shared：本当に共有していい薄いものだけ🍱⚠️（増やしすぎ注意！）

効果

  • 依存関係が見える👀
  • 「ここ触ったらここまで影響」って読める📌
  • 追加機能も“置き場所”で迷わない🧭✨

3) Visual Studioで“骨組み”を作ろう🛠️✨（手順どおりでOK）​

3-1. Solutionを作成🏗️​

  1. Visual Studioで 新しいプロジェクトの作成
  2. テンプレ：空のソリューション（Blank Solution） を選ぶ（またはSolutionだけ作成できるテンプレ）
  3. Solution名：MiniECommerce（例）
  4. できたらSolution直下に src フォルダを作る📁

3-2. Solution Folderを作る📦（見た目を整える）​

Solution上で右クリック → 追加 → 新しいソリューション フォルダー

  • Host
  • Modules
  • Shared

これ、地味だけど超効くよ✨「どこに何があるか」が一瞬で分かる👀

3-3. Host（入口）プロジェクトを追加🚪🌐​

  1. Solution右クリック → 追加 → 新しいプロジェクト
  2. テンプレ：ASP.NET Core Web API
  3. プロジェクト名：MiniECommerce.Host.Api
  4. 場所：/src/Host/MiniECommerce.Host.Api
  5. Solution Folderの Host に入れる（ドラッグでOK）🧲

3-4. Modules（業務）プロジェクトを追加🧩​

同じ要領で クラスライブラリ を3つ作る📚

  • MiniECommerce.Modules.Catalog → /src/Modules/Catalog/...
  • MiniECommerce.Modules.Ordering → /src/Modules/Ordering/...
  • MiniECommerce.Modules.Identity → /src/Modules/Identity/...

Solution Folderの Modules の下に置く（さらに Catalog/Ordering/Identity のSolution Folderを作ってもOK）📦✨

3-5. Shared（共有）を1つだけ追加🍱​

  • テンプレ：クラスライブラリ
  • MiniECommerce.Shared → /src/Shared/MiniECommerce.Shared

4) いちばん大事：参照ルール（今日の最小ルール）🚦📌​

この章では、いったん これだけ守ればOK でいくよ😊✨

ルール（最小）✅​

  • ✅ Host は Modules を参照してOK（入口だから）
  • ✅ Modules は Shared を参照してOK（必要最小だけ）
  • ❌ Modules 同士は参照しない（Catalog→Orderingみたいなの禁止）🙅‍♀️
  • ❌ Shared は Modules を参照しない（逆流禁止）🚫

Visual Studioで参照を追加する場所🧷​

  • MiniECommerce.Host.Api を右クリック → 依存関係 → プロジェクト参照の追加 → MiniECommerce.Modules.* をチェック✅

「Modules同士参照しない」は、後々めちゃ効くよ…！✨ “横に広がる依存”が始まると、雪だるま式に壊れる☃️💥

5) 手を動かす（C#）⌨️✨：とりあえず動いた！を作る🚀​

5-1. 各モジュールに “自己紹介” を置く🧩​

それぞれのモジュールに ModuleInfo.cs を作ってね😊

// src/Modules/Catalog/MiniECommerce.Modules.Catalog/ModuleInfo.cs
namespace MiniECommerce.Modules.Catalog;

public static class ModuleInfo
{
    public const string Name = "Catalog";
}
// src/Modules/Ordering/MiniECommerce.Modules.Ordering/ModuleInfo.cs
namespace MiniECommerce.Modules.Ordering;

public static class ModuleInfo
{
    public const string Name = "Ordering";
}
// src/Modules/Identity/MiniECommerce.Modules.Identity/ModuleInfo.cs
namespace MiniECommerce.Modules.Identity;

public static class ModuleInfo
{
    public const string Name = "Identity";
}

5-2. Hostに「読み込んでるモジュール一覧」APIを作る📣​

MiniECommerce.Host.Api の Program.cs に1本だけ追加しよう✨ （Minimal APIの書き方だよ〜😊）

using MiniECommerce.Modules.Catalog;
using MiniECommerce.Modules.Identity;
using MiniECommerce.Modules.Ordering;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/modules", () =>
{
    var modules = new[]
    {
        ModuleInfo.Name, // Catalog
        MiniECommerce.Modules.Ordering.ModuleInfo.Name,
        MiniECommerce.Modules.Identity.ModuleInfo.Name
    };

    return Results.Ok(modules);
});

app.Run();

✅ これで「HostがModulesを参照している」状態が目で分かる！👀✨ ブラウザで /modules を開いて ["Catalog","Ordering","Identity"] が出たら勝ち🏆🎉

6) VS Code併記：フォルダ構成の見え方👀🧰​

Visual StudioはSolution Folderで整うけど、VS Codeは実フォルダが正義📁✨ さっきの src/Host src/Modules src/Shared がそのまま効くよ😊

dotnet CLIで作る版（VS Code派向け）🧪​

dotnet new sln -n MiniECommerce
mkdir -p src/Host src/Modules/Catalog src/Modules/Ordering src/Modules/Identity src/Shared

dotnet new webapi -n MiniECommerce.Host.Api -o src/Host/MiniECommerce.Host.Api
dotnet new classlib -n MiniECommerce.Modules.Catalog -o src/Modules/Catalog/MiniECommerce.Modules.Catalog
dotnet new classlib -n MiniECommerce.Modules.Ordering -o src/Modules/Ordering/MiniECommerce.Modules.Ordering
dotnet new classlib -n MiniECommerce.Modules.Identity -o src/Modules/Identity/MiniECommerce.Modules.Identity
dotnet new classlib -n MiniECommerce.Shared -o src/Shared/MiniECommerce.Shared

dotnet sln MiniECommerce.sln add src/Host/MiniECommerce.Host.Api/MiniECommerce.Host.Api.csproj
dotnet sln MiniECommerce.sln add src/Modules/Catalog/MiniECommerce.Modules.Catalog/MiniECommerce.Modules.Catalog.csproj
dotnet sln MiniECommerce.sln add src/Modules/Ordering/MiniECommerce.Modules.Ordering/MiniECommerce.Modules.Ordering.csproj
dotnet sln MiniECommerce.sln add src/Modules/Identity/MiniECommerce.Modules.Identity/MiniECommerce.Modules.Identity.csproj
dotnet sln MiniECommerce.sln add src/Shared/MiniECommerce.Shared/MiniECommerce.Shared.csproj

dotnet add src/Host/MiniECommerce.Host.Api/MiniECommerce.Host.Api.csproj reference \
  src/Modules/Catalog/MiniECommerce.Modules.Catalog/MiniECommerce.Modules.Catalog.csproj \
  src/Modules/Ordering/MiniECommerce.Modules.Ordering/MiniECommerce.Modules.Ordering.csproj \
  src/Modules/Identity/MiniECommerce.Modules.Identity/MiniECommerce.Modules.Identity.csproj

7) 今どき情報📌✨（“いま”の土台）​

  • 現時点で .NET 10 はLTS で、2025-11-11にリリース、2028-11-14までサポート（Active）だよ📅🛡️ (Microsoft)
  • C# 14 は .NET 10 対応で、Visual Studio 2026 に .NET 10 SDK が含まれる案内になってるよ🧠✨ (Microsoft Learn)
  • Visual Studio 2026 は 2026-01-13 の更新（例：18.2.0）が公開されてるよ🛠️✨ (Microsoft Learn)

8) ミニ演習📝✨（15〜30分）​

  1. Modules/Shipping を追加してみよう🚚
  • MiniECommerce.Modules.Shipping（クラスライブラリ）を作る
  • ModuleInfo.Name = "Shipping" を追加
  • Hostの /modules にも追加して表示してみる
  1. 参照ルールチェック🚦
  • ShippingからOrderingのクラスを参照しようとして、やめる🙅‍♀️
  • 「横参照したくなる気持ち」を味わうのが目的😆（次章以降で上手に解決するよ✨）

9) AI活用プロンプト例🤖✨（コピペOK）​

9-1. 構成レビューしてもらう👀​

「このSolution構成（Host/Modules/Shared）をモジュラーモノリスとして運用したいです。 現状の参照関係のリスクと、初心者でも守れる“最小ルール”を箇条書きで提案して。」

9-2. 追加モジュールの雛形を作ってもらう🧩​

「MiniECommerce.Modules.Shipping を追加します。 ModuleInfo と、Host側の /modules に追加する差分パッチを出して。」

9-3. 命名を整えてもらう🧼​

「プロジェクト名とフォルダ名を、規則（MiniECommerce.Host.* / MiniECommerce.Modules.* / MiniECommerce.Shared）に沿って一覧で提案して。迷いやすいポイントも教えて。」

まとめ（覚える1行）📌✨​

“置き場所（Solution/Project）を先に決めると、モジュールは増えても迷子にならない” 🧭🏠🧩

次の第7章では、このModulesの中を Domain / Application / Infrastructure に分けて、さらに気持ちよくしていくよ〜🧅✨