{"id":3344,"date":"2026-09-07T12:35:17","date_gmt":"2026-09-07T03:35:17","guid":{"rendered":"https:\/\/qol-kk.com\/wp2\/?p=3344"},"modified":"2026-09-07T13:46:03","modified_gmt":"2026-09-07T04:46:03","slug":"20260901-00mti53y","status":"publish","type":"post","link":"https:\/\/qol-kk.com\/wp2\/blog\/2026\/09\/07\/20260901-00mti53y\/","title":{"rendered":"Django \u3067\u30af\u30ea\u30fc\u30f3\u30a2\u30fc\u30ad\u30c6\u30af\u30c1\u30e3\u3092\u5c0e\u5165\u3059\u308b\uff08\u5168\u4f53\u8a2d\u8a08\u7de8\uff09"},"content":{"rendered":"<h2>\u6982\u8981<\/h2>\n<p>Django \u306f\u300cFat Model \/ Fat View\u300d\u306b\u306a\u308a\u3084\u3059\u3044\u30d5\u30ec\u30fc\u30e0\u30ef\u30fc\u30af\u3067\u3059\u3002ORM \u304c\u5f37\u529b\u3067\u3001\u30d3\u30b8\u30cd\u30b9\u30ed\u30b8\u30c3\u30af\u3092\u3069\u3053\u306b\u3067\u3082\u66f8\u3051\u3066\u3057\u307e\u3046\u304b\u3089\u3067\u3059\u3002\u5c0f\u898f\u6a21\u306a\u3046\u3061\u306f\u554f\u984c\u3042\u308a\u307e\u305b\u3093\u304c\u3001\u30c9\u30e1\u30a4\u30f3\u304c\u8907\u96d1\u5316\u3059\u308b\u3068\u300c\u3053\u306e\u8a08\u7b97\u30ed\u30b8\u30c3\u30af\u306f\u3069\u3053\u306b\u3042\u308b\u306e\u304b\u300d\u300c\u30c6\u30b9\u30c8\u306e\u305f\u3073\u306b DB \u3092\u7acb\u3061\u4e0a\u3052\u306a\u3044\u3068\u3044\u3051\u306a\u3044\u300d\u3068\u3044\u3063\u305f\u75db\u307f\u304c\u8868\u9762\u5316\u3057\u307e\u3059\u3002<\/p>\n<p>\u672c\u8a18\u4e8b\u306f\u3001Django \u306b\u30af\u30ea\u30fc\u30f3\u30a2\u30fc\u30ad\u30c6\u30af\u30c1\u30e3\uff08\u304a\u3088\u3073\u305d\u306e\u767a\u60f3\u306e\u5143\u306b\u3042\u308b DDD \u306e\u5b9f\u88c5\u30d1\u30bf\u30fc\u30f3\uff09\u3092\u5c0e\u5165\u3059\u308b\u3068\u304d\u306e<strong>\u5168\u4f53\u8a2d\u8a08<\/strong>\u3092\u6271\u3046\u8003\u5bdf\u8a18\u4e8b\u3067\u3059\u3002\u500b\u5225\u30ec\u30a4\u30e4\u306e\u5b9f\u88c5\u8a73\u7d30\u3067\u306f\u306a\u304f\u3001\u300c\u3069\u3053\u3067\u5c64\u3092\u5207\u308a\u3001\u3069\u3053\u3067\u59a5\u5354\u3059\u308b\u304b\u300d\u3068\u3044\u3046\u8a2d\u8a08\u5224\u65ad\u306b\u7126\u70b9\u3092\u5f53\u3066\u307e\u3059\u3002<\/p>\n<h2>\u306a\u305c Django \u3067\u30af\u30ea\u30fc\u30f3\u30a2\u30fc\u30ad\u30c6\u30af\u30c1\u30e3\u306a\u306e\u304b<\/h2>\n<p>\u30af\u30ea\u30fc\u30f3\u30a2\u30fc\u30ad\u30c6\u30af\u30c1\u30e3\u306e\u672c\u8cea\u306f\u300c\u4f9d\u5b58\u306e\u65b9\u5411\u3092\u5185\u5074\uff08\u30d3\u30b8\u30cd\u30b9\u30eb\u30fc\u30eb\uff09\u306b\u5411\u3051\u3066\u56fa\u5b9a\u3059\u308b\u300d\u3053\u3068\u3067\u3059\u3002\u30d5\u30ec\u30fc\u30e0\u30ef\u30fc\u30af\u30fbDB\u30fbWeb \u306f\u6700\u3082\u5916\u5074\u306e\u8a73\u7d30\u3067\u3042\u308a\u3001\u30d3\u30b8\u30cd\u30b9\u30eb\u30fc\u30eb\u306f\u305d\u308c\u3089\u3092\u77e5\u3063\u3066\u306f\u3044\u3051\u307e\u305b\u3093\u3002<\/p>\n<p>Django \u3068\u306e\u76f8\u6027\u304c\u60aa\u3044\u3068\u8a00\u308f\u308c\u308b\u6700\u5927\u306e\u7406\u7531\u306f <strong>ActiveRecord \u578b\u306e ORM<\/strong> \u3067\u3059\u3002<code>models.Model<\/code> \u3092\u7d99\u627f\u3057\u305f\u77ac\u9593\u306b\u3001\u30c9\u30e1\u30a4\u30f3\u30e2\u30c7\u30eb\u304c DB \u30b9\u30ad\u30fc\u30de\u3068 Web \u30ea\u30af\u30a8\u30b9\u30c8\u306e\u90fd\u5408\u306b\u7e1b\u3089\u308c\u307e\u3059\u3002\u3053\u306e\u7d50\u5408\u3092\u3069\u3046\u6271\u3046\u304b\u304c\u8a2d\u8a08\u306e\u809d\u306b\u306a\u308a\u307e\u3059\u3002<\/p>\n<p>\u73fe\u5b9f\u7684\u306a\u9078\u629e\u80a2\u306f 2 \u3064\u3042\u308a\u307e\u3059\u3002<\/p>\n<ol>\n<li><strong>Django Model \u3092\u305d\u306e\u307e\u307e\u30c9\u30e1\u30a4\u30f3\u3068\u3057\u3066\u6271\u3044\u3001\u5c64\u3060\u3051\u8584\u304f\u5207\u308b<\/strong>\uff08\u73fe\u5b9f\u89e3\uff09<\/li>\n<li><strong>Django Model \u3092\u6c38\u7d9a\u5316\u5c02\u7528\u306b\u3057\u3001\u7d14\u7c8b\u306a\u30c9\u30e1\u30a4\u30f3\u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u3092\u5225\u306b\u6301\u3064<\/strong>\uff08\u7406\u60f3\u5bc4\u308a\uff09<\/li>\n<\/ol>\n<p>\u3069\u3061\u3089\u304c\u6b63\u89e3\u3068\u3044\u3046\u3053\u3068\u306f\u3042\u308a\u307e\u305b\u3093\u3002\u30c1\u30fc\u30e0\u306e\u898f\u6a21\u3068\u30c9\u30e1\u30a4\u30f3\u306e\u8907\u96d1\u3055\u3067\u9078\u3073\u307e\u3059\u3002\u672c\u8a18\u4e8b\u3067\u306f\u4e21\u65b9\u3092\u6271\u3044\u3064\u3064\u3001\u6bb5\u968e\u7684\u306b\u7406\u60f3\u3078\u5bc4\u305b\u308b\u8a2d\u8a08\u3092\u63a8\u5968\u3057\u307e\u3059\u3002<\/p>\n<h2>\u30ec\u30a4\u30e4\u69cb\u6210<\/h2>\n<p>\u4f9d\u5b58\u306f\u5fc5\u305a\u5185\u5411\u304d\uff08\u4e0b\u304b\u3089\u4e0a\u3078\u306e\u77e2\u5370\u306f\u5b58\u5728\u3057\u307e\u305b\u3093\uff09\u3002<\/p>\n<pre class=\"lang:default decode:true\">\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502  Presentation (Django View \/ DRF \/ CLI)      \u2502  \u2190 \u30d5\u30ec\u30fc\u30e0\u30ef\u30fc\u30af\u4f9d\u5b58\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502  Application (UseCase \/ Service)             \u2502  \u2190 \u30e6\u30fc\u30b9\u30b1\u30fc\u30b9\u306e\u624b\u9806\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502  Domain (Entity \/ ValueObject \/ Repository IF)\u2502  \u2190 \u30d3\u30b8\u30cd\u30b9\u30eb\u30fc\u30eb\uff08\u7d14\u7c8b\uff09\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502  Infrastructure (Repository \u5b9f\u88c5 \/ ORM)       \u2502  \u2190 \u8a73\u7d30\u3002Domain \u306e IF \u3092\u5b9f\u88c5\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<\/pre>\n<p>\u30dd\u30a4\u30f3\u30c8\u306f <strong>Repository \u306e\u30a4\u30f3\u30bf\u30fc\u30d5\u30a7\u30fc\u30b9\u3092 Domain \u5c64\u306b\u7f6e\u304d\u3001\u5b9f\u88c5\u3092 Infrastructure \u5c64\u306b\u7f6e\u304f<\/strong>\u3053\u3068\uff08\u4f9d\u5b58\u6027\u9006\u8ee2\uff09\u3067\u3059\u3002Application \u306f\u300cRepository \u3068\u3044\u3046\u62bd\u8c61\u300d\u306b\u3057\u304b\u4f9d\u5b58\u305b\u305a\u3001\u305d\u308c\u304c Django ORM \u3067\u52d5\u3044\u3066\u3044\u308b\u304b\u3001\u5916\u90e8 API \u3067\u52d5\u3044\u3066\u3044\u308b\u304b\u3092\u77e5\u308a\u307e\u305b\u3093\u3002<\/p>\n<h2>\u30c7\u30a3\u30ec\u30af\u30c8\u30ea\u8a2d\u8a08<\/h2>\n<p>Django \u306e\u300c\u30a2\u30d7\u30ea\uff1d\u6a5f\u80fd\u5358\u4f4d\u300d\u306e\u601d\u60f3\u3092\u6d3b\u304b\u3057\u3064\u3064\u3001\u30a2\u30d7\u30ea\u5185\u90e8\u3092\u5c64\u3067\u5206\u5272\u3057\u307e\u3059\u3002<\/p>\n<pre class=\"lang:default decode:true\">myproject\/\n\u251c\u2500\u2500 config\/                  # settings, urls, wsgi\n\u2514\u2500\u2500 apps\/\n    \u2514\u2500\u2500 billing\/\n        \u251c\u2500\u2500 domain\/\n        \u2502   \u251c\u2500\u2500 entities.py        # \u30c9\u30e1\u30a4\u30f3\u30a8\u30f3\u30c6\u30a3\u30c6\u30a3\uff08Django\u975e\u4f9d\u5b58\uff09\n        \u2502   \u251c\u2500\u2500 value_objects.py\n        \u2502   \u2514\u2500\u2500 repositories.py    # Repository \u306e\u62bd\u8c61\uff08Protocol \/ ABC\uff09\n        \u251c\u2500\u2500 application\/\n        \u2502   \u2514\u2500\u2500 use_cases.py\n        \u251c\u2500\u2500 infrastructure\/\n        \u2502   \u251c\u2500\u2500 models.py          # Django Model\uff08\u6c38\u7d9a\u5316\u5c02\u7528\uff09\n        \u2502   \u251c\u2500\u2500 orm_repositories.py\n        \u2502   \u2514\u2500\u2500 mappers.py         # Model \u21c4 Entity \u5909\u63db\n        \u2514\u2500\u2500 presentation\/\n            \u251c\u2500\u2500 views.py\n            \u2514\u2500\u2500 urls.py<\/pre>\n<h2>Domain \u5c64\uff1a\u30d5\u30ec\u30fc\u30e0\u30ef\u30fc\u30af\u3092\u77e5\u3089\u306a\u3044\u30b3\u30a2<\/h2>\n<p>\u30a8\u30f3\u30c6\u30a3\u30c6\u30a3\u306f Django \u306b\u4e00\u5207\u4f9d\u5b58\u3057\u307e\u305b\u3093\u3002dataclass \u3067\u5341\u5206\u3067\u3059\u3002<\/p>\n<pre class=\"lang:default decode:true\"># apps\/billing\/domain\/value_objects.py\nfrom dataclasses import dataclass\nfrom decimal import Decimal\n\n\n@dataclass(frozen=True)\nclass Money:\n    amount: Decimal\n    currency: str = \"JPY\"\n\n    def __post_init__(self):\n        if self.amount &lt; 0:\n            raise ValueError(\"\u91d1\u984d\u306f\u8ca0\u6570\u306b\u3067\u304d\u307e\u305b\u3093\")\n\n    def add(self, other: \"Money\") -&gt; \"Money\":\n        if self.currency != other.currency:\n            raise ValueError(\"\u901a\u8ca8\u304c\u4e00\u81f4\u3057\u307e\u305b\u3093\")\n        return Money(self.amount + other.amount, self.currency)<\/pre>\n<pre class=\"lang:default decode:true\"># apps\/billing\/domain\/entities.py\nfrom dataclasses import dataclass, field\nfrom decimal import Decimal\nfrom .value_objects import Money\n\n\n@dataclass\nclass Invoice:\n    id: int | None\n    customer_id: int\n    lines: list[Money] = field(default_factory=list)\n    issued: bool = False\n\n    def issue(self) -&gt; None:\n        if self.issued:\n            raise ValueError(\"\u3059\u3067\u306b\u767a\u884c\u6e08\u307f\u3067\u3059\")\n        if not self.lines:\n            raise ValueError(\"\u660e\u7d30\u306e\u306a\u3044\u8acb\u6c42\u66f8\u306f\u767a\u884c\u3067\u304d\u307e\u305b\u3093\")\n        self.issued = True<\/pre>\n<p>\u3053\u306e\u30b3\u30fc\u30c9\u306f DB \u3082\u30ea\u30af\u30a8\u30b9\u30c8\u3082 import \u3057\u3066\u3044\u307e\u305b\u3093\u3002\u3060\u304b\u3089 <strong>pytest \u3067 DB \u306a\u3057\u306b\u4e00\u77ac\u3067\u30c6\u30b9\u30c8\u3067\u304d\u307e\u3059<\/strong>\u3002\u3053\u308c\u304c\u30af\u30ea\u30fc\u30f3\u30a2\u30fc\u30ad\u30c6\u30af\u30c1\u30e3\u3067\u5f97\u3089\u308c\u308b\u6700\u5927\u306e\u5b9f\u5229\u3067\u3059\u3002<\/p>\n<p>Repository \u306e\u62bd\u8c61\u306f Domain \u5c64\u306b\u7f6e\u304d\u307e\u3059\u3002Python \u306a\u3089 <code>typing.Protocol<\/code> \u304c\u8efd\u304f\u3066\u826f\u3044\u3067\u3059\u3002<\/p>\n<pre class=\"lang:default decode:true\"># apps\/billing\/domain\/repositories.py\nfrom typing import Protocol\nfrom .entities import Invoice\n\n\nclass InvoiceRepository(Protocol):\n    def get(self, invoice_id: int) -&gt; Invoice | None: ...\n    def save(self, invoice: Invoice) -&gt; Invoice: ...<\/pre>\n<h2>Application \u5c64\uff1a\u30e6\u30fc\u30b9\u30b1\u30fc\u30b9\u306e\u624b\u9806\u66f8<\/h2>\n<p>\u30e6\u30fc\u30b9\u30b1\u30fc\u30b9\u306f\u300c\u4f55\u3092\u3059\u308b\u304b\u300d\u3092\u5ba3\u8a00\u7684\u306b\u66f8\u304f\u5834\u6240\u3067\u3042\u308a\u3001\u30d3\u30b8\u30cd\u30b9\u30eb\u30fc\u30eb\uff08\uff1d\u3069\u3046\u5224\u65ad\u3059\u308b\u304b\uff09\u306f\u30a8\u30f3\u30c6\u30a3\u30c6\u30a3\u306b\u59d4\u306d\u307e\u3059\u3002\u30c8\u30e9\u30f3\u30b6\u30af\u30b7\u30e7\u30f3\u5883\u754c\u306f\u3053\u3053\u3067\u5f15\u304d\u307e\u3059\u3002<\/p>\n<pre class=\"lang:default decode:true\"># apps\/billing\/application\/use_cases.py\nfrom dataclasses import dataclass\nfrom ..domain.repositories import InvoiceRepository\n\n\n@dataclass\nclass IssueInvoiceUseCase:\n    repo: InvoiceRepository\n\n    def execute(self, invoice_id: int) -&gt; None:\n        invoice = self.repo.get(invoice_id)\n        if invoice is None:\n            raise LookupError(\"\u8acb\u6c42\u66f8\u304c\u898b\u3064\u304b\u308a\u307e\u305b\u3093\")\n        invoice.issue()          # \u2190 \u30eb\u30fc\u30eb\u306f\u30a8\u30f3\u30c6\u30a3\u30c6\u30a3\u5074\n        self.repo.save(invoice)<\/pre>\n<p>UseCase \u306f\u5177\u8c61\u306e <code>InvoiceRepository<\/code> \u3092\u77e5\u308a\u307e\u305b\u3093\u3002<code>Protocol<\/code> \u3092\u6e80\u305f\u3059\u4f55\u304b\u3092\u53d7\u3051\u53d6\u308b\u3060\u3051\u3067\u3059\u3002\u30c6\u30b9\u30c8\u3067\u306f\u30a4\u30f3\u30e1\u30e2\u30ea\u5b9f\u88c5\u3092\u6e21\u305b\u3070\u5341\u5206\u3067\u3059\u3002<\/p>\n<h2>Infrastructure \u5c64\uff1aDjango ORM \u3092\u9589\u3058\u8fbc\u3081\u308b<\/h2>\n<p>\u3053\u3053\u3067\u521d\u3081\u3066 <code>models.Model<\/code> \u304c\u767b\u5834\u3057\u307e\u3059\u3002Django Model \u306f<strong>\u6c38\u7d9a\u5316\u306e\u305f\u3081\u306e\u30c6\u30fc\u30d6\u30eb\u5b9a\u7fa9<\/strong>\u3068\u5272\u308a\u5207\u308a\u307e\u3059\u3002<\/p>\n<pre class=\"lang:default decode:true\"># apps\/billing\/infrastructure\/models.py\nfrom django.db import models\n\n\nclass InvoiceRecord(models.Model):\n    customer_id = models.IntegerField()\n    issued = models.BooleanField(default=False)\n\n    class Meta:\n        db_table = \"invoice\"<\/pre>\n<p>Model \u3068 Entity \u306e\u5909\u63db\u306f Mapper \u306b\u96c6\u7d04\u3057\u307e\u3059\u3002\u3053\u3053\u3092 View \u3084\u30ed\u30b8\u30c3\u30af\u306b\u6563\u3089\u304b\u3059\u3068\u7d50\u5c40\u7d50\u5408\u304c\u6f0f\u308c\u307e\u3059\u3002<\/p>\n<pre class=\"lang:default decode:true\"># apps\/billing\/infrastructure\/orm_repositories.py\nfrom ..domain.entities import Invoice\nfrom .models import InvoiceRecord\nfrom .mappers import to_entity\n\n\nclass DjangoInvoiceRepository:\n    def get(self, invoice_id: int) -&gt; Invoice | None:\n        record = InvoiceRecord.objects.filter(id=invoice_id).first()\n        return to_entity(record) if record else None\n\n    def save(self, invoice: Invoice) -&gt; Invoice:\n        record, _ = InvoiceRecord.objects.update_or_create(\n            id=invoice.id,\n            defaults={\"customer_id\": invoice.customer_id, \"issued\": invoice.issued},\n        )\n        return to_entity(record)<\/pre>\n<p><code>DjangoInvoiceRepository<\/code> \u306f <code>InvoiceRepository<\/code> \u30d7\u30ed\u30c8\u30b3\u30eb\u3092\u69cb\u9020\u7684\u306b\u6e80\u305f\u3057\u3066\u3044\u308b\u306e\u3067\u3001UseCase \u306b\u305d\u306e\u307e\u307e\u6ce8\u5165\u3067\u304d\u307e\u3059\u3002<\/p>\n<h2>Presentation \u5c64\uff1a\u7d44\u307f\u7acb\u3066\u3060\u3051\u3092\u62c5\u3046<\/h2>\n<p>View \u306f\u300c\u5165\u529b\u3092\u53d7\u3051\u53d6\u308a\u3001UseCase \u3092\u7d44\u307f\u7acb\u3066\u3001\u7d50\u679c\u3092\u8fd4\u3059\u300d\u3060\u3051\u306e\u8584\u3044\u5c64\u306b\u3057\u307e\u3059\u3002<\/p>\n<pre class=\"lang:default decode:true\"># apps\/billing\/presentation\/views.py\nfrom rest_framework.views import APIView\nfrom rest_framework.response import Response\nfrom django.db import transaction\n\nfrom ..application.use_cases import IssueInvoiceUseCase\nfrom ..infrastructure.orm_repositories import DjangoInvoiceRepository\n\n\nclass IssueInvoiceView(APIView):\n    def post(self, request, invoice_id: int):\n        use_case = IssueInvoiceUseCase(repo=DjangoInvoiceRepository())\n        with transaction.atomic():\n            use_case.execute(invoice_id)\n        return Response({\"status\": \"issued\"}, status=200)<\/pre>\n<p>\u4f9d\u5b58\u306e\u7d44\u307f\u7acb\u3066\uff08DI\uff09\u3092 View \u3067\u76f4\u66f8\u304d\u3057\u3066\u3044\u308b\u70b9\u306f\u59a5\u5354\u3067\u3059\u3002\u898f\u6a21\u304c\u5927\u304d\u304f\u306a\u3063\u305f\u3089 DI \u30b3\u30f3\u30c6\u30ca\uff08<code>punq<\/code>\u3001<code>dependency-injector<\/code> \u7b49\uff09\u306b\u5bc4\u305b\u307e\u3059\u3002<\/p>\n<h2>\u8a2d\u5b9a\u8abf\u6574\uff1amodels \u3092 infrastructure \u306b\u7f6e\u304f<\/h2>\n<p>Django \u306f <code>app\/models.py<\/code> \u3092\u81ea\u52d5\u691c\u51fa\u3057\u307e\u3059\u3002<code>infrastructure\/models.py<\/code> \u306b\u7f6e\u304f\u5834\u5408\u306f\u660e\u793a import \u304c\u5fc5\u8981\u3067\u3059\u3002<\/p>\n<pre class=\"lang:default decode:true\"># apps\/billing\/models.py  \u2190 \u4e92\u63db\u306e\u305f\u3081\u306e\u518d\u30a8\u30af\u30b9\u30dd\u30fc\u30c8\nfrom .infrastructure.models import InvoiceRecord  # noqa<\/pre>\n<p>\u3053\u3046\u3057\u3066\u304a\u3051\u3070 <code>makemigrations<\/code> \/ <code>migrate<\/code> \u306f\u901a\u5e38\u3069\u304a\u308a\u52d5\u304d\u307e\u3059\u3002<\/p>\n<h2>\u30c6\u30b9\u30c8\u6226\u7565<\/h2>\n<p>\u5c64\u3092\u5207\u308b\u6700\u5927\u306e\u898b\u8fd4\u308a\u306f\u30c6\u30b9\u30c8\u30d4\u30e9\u30df\u30c3\u30c9\u304c\u7d20\u76f4\u306b\u7d44\u3081\u308b\u3053\u3068\u3067\u3059\u3002<\/p>\n<ul>\n<li><strong>Domain \u30c6\u30b9\u30c8<\/strong>\uff1aDB \u306a\u3057\u3002\u30a8\u30f3\u30c6\u30a3\u30c6\u30a3\u306e\u30eb\u30fc\u30eb\u3092\u7d14\u7c8b\u306b\u30c6\u30b9\u30c8\uff08\u5927\u91cf\u30fb\u9ad8\u901f\uff09<\/li>\n<li><strong>Application \u30c6\u30b9\u30c8<\/strong>\uff1a\u30a4\u30f3\u30e1\u30e2\u30ea Repository \u3092\u6ce8\u5165\u3002\u30e6\u30fc\u30b9\u30b1\u30fc\u30b9\u306e\u624b\u9806\u3092\u691c\u8a3c<\/li>\n<li><strong>Infrastructure \u30c6\u30b9\u30c8<\/strong>\uff1a\u5b9f DB\uff08pytest-django\uff09\u3067 Repository \u306e SQL \u3092\u691c\u8a3c\uff08\u5c11\u6570\uff09<\/li>\n<li><strong>E2E\/View \u30c6\u30b9\u30c8<\/strong>\uff1a\u30a8\u30f3\u30c9\u30dd\u30a4\u30f3\u30c8\u758e\u901a\u306e\u62c5\u4fdd\uff08\u6700\u5c0f\u9650\uff09<\/li>\n<\/ul>\n<pre class=\"lang:default decode:true\">class InMemoryInvoiceRepo:\n    def __init__(self): self._store = {}\n    def get(self, i): return self._store.get(i)\n    def save(self, inv): self._store[inv.id] = inv; return inv\n\n\ndef test_issue_invoice():\n    repo = InMemoryInvoiceRepo()\n    repo.save(Invoice(id=1, customer_id=10, lines=[Money(Decimal(\"100\"))]))\n    IssueInvoiceUseCase(repo).execute(1)\n    assert repo.get(1).issued is True<\/pre>\n<h2>\u30a2\u30f3\u30c1\u30d1\u30bf\u30fc\u30f3\u3068\u843d\u3068\u3057\u7a74<\/h2>\n<ul>\n<li><strong>Entity \u306b Django \u306e QuerySet \u3092\u6301\u305f\u305b\u308b<\/strong> \u2014 \u7d50\u5408\u304c\u6f0f\u308c\u308b\u3002Repository \u306e\u5185\u5074\u3067\u5b8c\u7d50\u3055\u305b\u308b<\/li>\n<li><strong>Mapper \u3092\u7701\u7565\u3057\u3066 Model \u3092\u305d\u306e\u307e\u307e Application \u3078\u6e21\u3059<\/strong> \u2014 DB \u30b9\u30ad\u30fc\u30de\u5909\u66f4\u304c\u30e6\u30fc\u30b9\u30b1\u30fc\u30b9\u307e\u3067\u6ce2\u53ca\u3059\u308b<\/li>\n<li><strong>\u5c64\u3092\u5207\u308b\u3053\u3068\u304c\u76ee\u7684\u5316\u3059\u308b<\/strong> \u2014 CRUD \u753b\u9762\u307e\u3067 4 \u5c64\u306b\u3059\u308b\u3068\u4fdd\u5b88\u30b3\u30b9\u30c8\u3060\u3051\u5897\u3048\u308b<\/li>\n<li><strong>\u5faa\u74b0 import<\/strong> \u2014 <code>domain<\/code> \u304c <code>infrastructure<\/code> \u3092 import \u3057\u305f\u77ac\u9593\u306b\u8a2d\u8a08\u304c\u58ca\u308c\u308b\u3002import \u306e\u5411\u304d\u306f import-linter \u7b49\u3067\u6a5f\u68b0\u691c\u8a3c\u3059\u308b\u3068\u5b89\u5168<\/li>\n<\/ul>\n<h2>\u6bb5\u968e\u5c0e\u5165\u306e\u6307\u91dd<\/h2>\n<p>\u5168\u90e8\u3092\u6700\u521d\u304b\u3089\u3084\u308b\u3068\u632b\u6298\u3057\u307e\u3059\u3002\u63a8\u5968\u3059\u308b\u9806\u5e8f\u306f\u6b21\u306e\u3068\u304a\u308a\u3067\u3059\u3002<\/p>\n<ol>\n<li><strong>\u307e\u305a Application \u5c64\uff08UseCase\/Service\uff09\u3060\u3051\u5207\u308b\u3002<\/strong> View \u304b\u3089\u751f\u30ed\u30b8\u30c3\u30af\u3092\u8ffd\u3044\u51fa\u3059<\/li>\n<li><strong>\u6b21\u306b Repository \u62bd\u8c61\u3092\u5c0e\u5165\u3002<\/strong> DB \u30a2\u30af\u30bb\u30b9\u3092 UseCase \u304b\u3089\u96a0\u3059<\/li>\n<li><strong>\u6700\u5f8c\u306b Entity \u3092 Django Model \u304b\u3089\u5206\u96e2\u3002<\/strong> \u30b3\u30b9\u30c8\u304c\u9ad8\u3044\u306e\u3067\u3001\u30c9\u30e1\u30a4\u30f3\u304c\u672c\u5f53\u306b\u8907\u96d1\u306a\u6a5f\u80fd\u30a2\u30d7\u30ea\u3060\u3051\u306b\u9069\u7528\u3059\u308b<\/li>\n<\/ol>\n<p>\u5168\u30a2\u30d7\u30ea\u3092\u7d14\u7c8b Entity \u306b\u3059\u308b\u5fc5\u8981\u306f\u3042\u308a\u307e\u305b\u3093\u3002<strong>CRUD \u3067\u6e08\u3080\u7ba1\u7406\u753b\u9762\u306f\u7d20\u306e Django\u3001\u8907\u96d1\u306a\u30c9\u30e1\u30a4\u30f3\u306f\u5206\u96e2<\/strong>\u3068\u3044\u3046\u5272\u308a\u5207\u308a\u304c\u3080\u3057\u308d\u5065\u5168\u3067\u3059\u3002\u30af\u30ea\u30fc\u30f3\u30a2\u30fc\u30ad\u30c6\u30af\u30c1\u30e3\u306f\u76ee\u7684\u3067\u306f\u306a\u304f\u3001\u5909\u66f4\u5bb9\u6613\u6027\u3092\u5f97\u308b\u305f\u3081\u306e\u624b\u6bb5\u3067\u3059\u3002<\/p>\n<h2>\u307e\u3068\u3081<\/h2>\n<ul>\n<li>\u30af\u30ea\u30fc\u30f3\u30a2\u30fc\u30ad\u30c6\u30af\u30c1\u30e3\u306e\u6838\u5fc3\u306f\u300c\u4f9d\u5b58\u306e\u65b9\u5411\u3092\u5185\u5074\u306b\u56fa\u5b9a\u3059\u308b\u300d\u3053\u3068\u3067\u3042\u308a\u3001Django \u3067\u306f ORM \u306e\u6271\u3044\u304c\u6700\u5927\u306e\u8ad6\u70b9<\/li>\n<li>Repository \u62bd\u8c61\u3092 Domain \u306b\u3001\u5b9f\u88c5\u3092 Infrastructure \u306b\u7f6e\u304f\u300c\u4f9d\u5b58\u6027\u9006\u8ee2\u300d\u304c\u80cc\u9aa8\u306b\u306a\u308b<\/li>\n<li>\u7d14\u7c8b Entity \u5316\u306f\u30b3\u30b9\u30c8\u304c\u9ad8\u3044\u306e\u3067\u3001<strong>\u8907\u96d1\u306a\u30c9\u30e1\u30a4\u30f3\u3060\u3051<\/strong>\u306b\u6bb5\u968e\u9069\u7528\u3059\u308b\u306e\u304c\u73fe\u5b9f\u89e3<\/li>\n<li>\u5f97\u3089\u308c\u308b\u6700\u5927\u306e\u5b9f\u5229\u306f\u300cDB \u3092\u7acb\u3066\u305a\u306b\u9ad8\u901f\u3067\u30eb\u30fc\u30eb\u3092\u30c6\u30b9\u30c8\u3067\u304d\u308b\u300d\u3053\u3068<\/li>\n<li>\u5c64\u3092\u5207\u308b\u3053\u3068\u81ea\u4f53\u3092\u76ee\u7684\u306b\u3057\u306a\u3044\u3002\u5909\u66f4\u5bb9\u6613\u6027\u3068\u3044\u3046\u898b\u8fd4\u308a\u304c\u5272\u306b\u5408\u3046\u6a5f\u80fd\u306b\u3060\u3051\u9069\u7528\u3059\u308b<\/li>\n<\/ul>\n<p>\u6b21\u56de\uff08\u5b9f\u88c5\u7de8\uff09\u3067\u306f\u3001DI \u30b3\u30f3\u30c6\u30ca\u306e\u5c0e\u5165\u3001\u30c8\u30e9\u30f3\u30b6\u30af\u30b7\u30e7\u30f3\u5883\u754c\u306e\u8a73\u7d30\u3001\u96c6\u7d04\u3092\u307e\u305f\u3050\u6574\u5408\u6027\u306e\u6271\u3044\u3092\u6398\u308a\u4e0b\u3052\u308b\u4e88\u5b9a\u3067\u3059\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Django \u306f\u300cFat Model \/ Fat View\u300d\u306b\u306a\u308a\u3084\u3059\u3044\u30d5\u30ec\u30fc\u30e0\u30ef\u30fc\u30af\u3067\u3059\u3002ORM \u304c\u5f37\u529b\u3067\u3001\u30d3\u30b8\u30cd\u30b9\u30ed\u30b8\u30c3\u30af\u3092\u3069\u3053\u306b\u3067\u3082\u66f8\u3051\u3066\u3057\u307e\u3046\u304b\u3089\u3067\u3059\u3002\u5c0f\u898f\u6a21\u306a\u3046\u3061\u306f\u554f\u984c\u3042\u308a\u307e\u305b\u3093\u304c\u3001\u30c9\u30e1\u30a4\u30f3\u304c\u8907\u96d1\u5316\u3059\u308b\u3068\u300c\u3053\u306e\u8a08\u7b97\u30ed\u30b8\u30c3\u30af\u306f\u3069\u3053\u306b\u2026<\/p>\n","protected":false},"author":1,"featured_media":3368,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"sns_share_botton_hide":"","vkExUnit_sns_title":"","_vk_print_noindex":"","sitemap_hide":"","_veu_custom_css":"","veu_display_promotion_alert":"","vkexunit_cta_each_option":"","_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"jetpack_post_was_ever_published":false},"categories":[38],"tags":[914,814,166,1195,369,1141,1188,472],"class_list":["post-3344","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-python-memorandum","tag-crud","tag-django","tag-model","tag-pytest","tag-view","tag-1141","tag-1188","tag-472"],"veu_head_title_object":{"title":"","add_site_title":""},"jetpack_publicize_connections":[],"jetpack-related-posts":[],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"https:\/\/qol-kk.com\/wp2\/wp-content\/uploads\/2026\/09\/post-3344-thumbnail.jpg","_links":{"self":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts\/3344","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/comments?post=3344"}],"version-history":[{"count":1,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts\/3344\/revisions"}],"predecessor-version":[{"id":3345,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts\/3344\/revisions\/3345"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/media\/3368"}],"wp:attachment":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/media?parent=3344"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/categories?post=3344"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/tags?post=3344"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}