Djangoでプロジェクトを作成すると、デフォルトでは次のような構成になります。

myproject/
├─ myproject/ # 設定フォルダ（プロジェクト名と同じ）
│ ├─ settings.py 
│ ├─ urls.py 
│ └─ ... 
├─ app1/ # アプリケーションフォルダ
├─ manage.py 

一見シンプルで良さそうですが、アプリが増えてくると

• 設定ファイルの場所が分かりづらい（設定フォルダとプロジェクトフォルダの名前が同じでややこしい）

• テンプレートやstaticファイルをまとめにくい

• 共通処理をどこに置くか悩む

といった問題が出てきます。
そこで今回は、この構成をベースに「管理しやすく・拡張しやすい形」にカスタマイズしたものを紹介します。

まずは、KakuhanAppで採用しているディレクトリ構成を紹介します。

kakuhanapp/
├─ blog/ # アプリケーションフォルダ 
│ ├─ models.py 
│ ├─ views.py 
│ └─ ... 
├─ config/ # 設定フォルダ（Djangoの「myproject」相当）
│ ├─ settings/ # 環境別設定をまとめる
│ │ ├─ __init__.py
│ │ ├─ base.py
│ │ ├─ local.py
│ │ └─ production.py
│ ├─ urls.py
│ └─ ... 
├─ core/ # 共通処理フォルダ 
├─ static/ # 静的ファイル用フォルダ（CSS, JS, 画像など）
├─ templates/ # テンプレートフォルダ（HTMLを一元管理） 
│ ├─ blog/ 
│ └─ ... 
├─ manage.py 
├─ requirements.txt 
└─ ... 

この構成のポイントは3つです：

1. 設定フォルダを「config」に変更し、さらに環境ごとに管理

2. テンプレートと静的ファイルを共通化

3. 共通処理を「core」で管理

これだけで、アプリ全体の見通しがぐっと良くなります。

設定フォルダの名前を変える方法はこちら↓

プログラミング

【Django】設定フォルダの名前を変える2つの方法（プロジェクト作成時・既存プロジェクト）

投稿日: 2025/11/04

Djangoの設定ファイルは1つの settings.py にまとめるのが標準ですが、
開発用・本番用など環境によって設定を切り替えたい場合は、分割しておくと便利です。

KakuhanAppでは、以下のように config/settings/ フォルダを作り、環境ごとに設定を管理しています。

config/ 
├─ settings/ 
│ ├─ __init__.py 
│ ├─ base.py # 共通設定 
│ ├─ local.py # 開発環境用 
│ └─ production.py # 本番環境用 

• base.py には全環境共通の設定を記述します。

• local.py や production.py では、from .base import * で共通設定を読み込みつつ、環境固有の設定（DEBUG、DATABASESなど）を上書きします。

本番環境では production.py を使用し、manage.py 実行時に DJANGO_SETTINGS_MODULE を切り替える（以下を実行する）ことで安全に運用できます。

export DJANGO_SETTINGS_MODULE='config.settings.production' 

この方法を使うと、設定の衝突を防ぎつつ、環境に応じて柔軟に構成を切り替えられます。

アプリごとに templates や static フォルダを作る方法もありますが、
プロジェクトが大きくなると「どのアプリにどのHTMLがあるのか」管理が大変になります。

そのため、KakuhanAppでは プロジェクト直下に templates と static を設置 し、
すべてのアプリから共通で利用できるようにしています。

Django設定ファイル（config/base.py）では以下のようにパスを指定します。

TEMPLATES = [ { 'DIRS': [BASE_DIR / 'templates'], ... }, ] 

STATIC_URL = '/static/'
STATICFILES_DIRS = [ BASE_DIR / 'static', ] 

これで、どのアプリからでも共通のテンプレートや静的ファイルを扱えるようになります。
デザインを統一したいときにも非常に便利です。

複数アプリ間で共通して使う関数やクラスを、
utils.py のように各アプリ内に分散させてしまうと管理が大変になります。

KakuhanAppでは、共通処理をまとめるために 「core」フォルダ を作成しています。

core/ 
├─ utils.py 
├─ mixins.py 
└─ forms.py 

このようにしておくと、
「共通関数は core/utils.py にある」とすぐにわかり、アプリごとの責務も明確になります。

後から新しいアプリを追加しても、共通処理をすぐに再利用できるのも大きなメリットです。

Djangoは自由度が高いぶん、構成をどう設計するかがプロジェクトの継続性を左右します。
今回紹介した構成は、

• 環境別設定で安全に開発・デプロイができる

• 静的ファイルとテンプレートを一元管理できる

• 共通処理を明確に分けられる

という3つの強みを持っています。また、今後アプリを拡張していく上でも柔軟に対応できる形になっています。