Initialize Fonrey Django multi-tenant project skeleton

Set up the required directory layout, app scaffolding, core settings, templates, static assets, and Docker/Tailwind tooling to establish a standardized development baseline.

config/asgi.py

@@ -0,0 +1,8 @@
+import os
+
+from django_tenants.asgi import TenantASGIHandler
+from django.core.asgi import get_asgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "config.settings.development")
+
+application = TenantASGIHandler(get_asgi_application())

config/settings/base.py

@@ -0,0 +1,144 @@
+from pathlib import Path
+
+from decouple import Csv, config as env
+
+BASE_DIR = Path(__file__).resolve().parent.parent.parent
+
+SECRET_KEY = env("SECRET_KEY", default="django-insecure-change-me")
+DEBUG = env("DEBUG", default=False, cast=bool)
+ALLOWED_HOSTS = env("ALLOWED_HOSTS", default="localhost,127.0.0.1", cast=Csv())
+
+SHARED_APPS = [
+    "django_tenants",
+    "apps.tenant",
+    "apps.release",
+    "shared",
+    "django.contrib.contenttypes",
+    "django.contrib.auth",
+    "django.contrib.sessions",
+    "django.contrib.messages",
+    "django.contrib.staticfiles",
+    "django_celery_beat",
+    "django_celery_results",
+]
+
+TENANT_APPS = [
+    "apps.account",
+    "apps.permission",
+    "apps.org",
+    "apps.region",
+    "apps.complex",
+    "apps.property",
+    "apps.client",
+    "apps.setting",
+    "core",
+]
+
+INSTALLED_APPS = list(SHARED_APPS) + list(TENANT_APPS)
+
+TENANT_MODEL = "tenant.Tenant"
+TENANT_DOMAIN_MODEL = "tenant.Domain"
+DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"
+
+DATABASES = {
+    "default": {
+        "ENGINE": "django_tenants.postgresql_backend",
+        "NAME": env("DB_NAME"),
+        "USER": env("DB_USER"),
+        "PASSWORD": env("DB_PASSWORD"),
+        "HOST": env("DB_HOST", default="localhost"),
+        "PORT": env("DB_PORT", default="5432"),
+        "CONN_MAX_AGE": 60,
+        "OPTIONS": {"pool_size": 10},
+    }
+}
+
+DATABASE_ROUTERS = ["django_tenants.routers.TenantSyncRouter"]
+
+CACHES = {
+    "default": {
+        "BACKEND": "django_redis.cache.RedisCache",
+        "LOCATION": env("REDIS_URL", default="redis://127.0.0.1:6379/0"),
+        "OPTIONS": {"CLIENT_CLASS": "django_redis.client.DefaultClient"},
+        "KEY_PREFIX": "fonrey",
+    }
+}
+
+SESSION_ENGINE = "django.contrib.sessions.backends.cache"
+SESSION_CACHE_ALIAS = "default"
+
+CELERY_BROKER_URL = env("CELERY_BROKER_URL", default="redis://127.0.0.1:6379/1")
+CELERY_RESULT_BACKEND = "django-db"
+CELERY_TASK_ALWAYS_EAGER = False
+CELERY_TASK_TIME_LIMIT = 300
+CELERY_TASK_SOFT_TIME_LIMIT = 270
+
+DEFAULT_FILE_STORAGE = "storages.backends.s3boto3.S3Boto3Storage"
+AWS_S3_ENDPOINT_URL = env("R2_ENDPOINT_URL", default="")
+AWS_ACCESS_KEY_ID = env("R2_ACCESS_KEY_ID", default="")
+AWS_SECRET_ACCESS_KEY = env("R2_SECRET_ACCESS_KEY", default="")
+AWS_STORAGE_BUCKET_NAME = env("R2_BUCKET_NAME", default="media")
+AWS_S3_CUSTOM_DOMAIN = env("R2_CUSTOM_DOMAIN", default=None)
+AWS_DEFAULT_ACL = "private"
+
+ASGI_APPLICATION = "config.asgi.application"
+WSGI_APPLICATION = "config.wsgi.application"
+ROOT_URLCONF = "config.urls"
+
+MIDDLEWARE = [
+    "django_tenants.middleware.main.TenantMainMiddleware",
+    "django.middleware.security.SecurityMiddleware",
+    "whitenoise.middleware.WhiteNoiseMiddleware",
+    "django.contrib.sessions.middleware.SessionMiddleware",
+    "django.middleware.common.CommonMiddleware",
+    "django.middleware.csrf.CsrfViewMiddleware",
+    "django.contrib.auth.middleware.AuthenticationMiddleware",
+    "django.contrib.messages.middleware.MessageMiddleware",
+    "django.middleware.clickjacking.XFrameOptionsMiddleware",
+    "core.middleware.audit.AuditMiddleware",
+]
+
+SECURE_PROXY_SSL_HEADER = ("HTTP_X_FORWARDED_PROTO", "https")
+SESSION_COOKIE_HTTPONLY = True
+SESSION_COOKIE_SAMESITE = "Lax"
+CSRF_COOKIE_HTTPONLY = False
+X_FRAME_OPTIONS = "DENY"
+
+LANGUAGE_CODE = "zh-hans"
+TIME_ZONE = "Asia/Shanghai"
+USE_I18N = True
+USE_TZ = True
+
+TEMPLATES = [
+    {
+        "BACKEND": "django.template.backends.django.DjangoTemplates",
+        "DIRS": [BASE_DIR / "templates"],
+        "APP_DIRS": True,
+        "OPTIONS": {
+            "context_processors": [
+                "django.template.context_processors.debug",
+                "django.template.context_processors.request",
+                "django.contrib.auth.context_processors.auth",
+                "django.contrib.messages.context_processors.messages",
+            ]
+        },
+    }
+]
+
+HTMX_GLOBAL_CSRF = True
+
+STATIC_URL = "/static/"
+STATIC_ROOT = BASE_DIR / "staticfiles"
+STATICFILES_DIRS = [BASE_DIR / "static"]
+
+MEDIA_URL = "/media/"
+MEDIA_ROOT = BASE_DIR / "media"
+
+PUBLIC_SCHEMA_URLCONF = "config.urls"
+
+LOGGING = {
+    "version": 1,
+    "disable_existing_loggers": False,
+    "handlers": {"console": {"class": "logging.StreamHandler"}},
+    "root": {"handlers": ["console"], "level": "INFO"},
+}

config/settings/development.py

@@ -0,0 +1,3 @@
+from .base import *
+
+DEBUG = True

config/settings/production.py

@@ -0,0 +1,22 @@
+from decouple import config as env
+
+from .base import *
+
+DEBUG = False
+ALLOWED_HOSTS = env("ALLOWED_HOSTS", default="localhost,127.0.0.1").split(",")
+
+SECURE_SSL_REDIRECT = True
+SESSION_COOKIE_SECURE = True
+CSRF_COOKIE_SECURE = True
+
+SENTRY_DSN = env("SENTRY_DSN", default="")
+if SENTRY_DSN:
+    import sentry_sdk
+    from sentry_sdk.integrations.django import DjangoIntegration
+
+    sentry_sdk.init(
+        dsn=SENTRY_DSN,
+        integrations=[DjangoIntegration()],
+        traces_sample_rate=0.1,
+        send_default_pii=False,
+    )

config/urls.py

@@ -0,0 +1,36 @@
+from django.conf import settings
+from django.conf.urls.static import static
+from django.db import connection
+from django.http import HttpResponse
+from django.urls import include, path
+from django_tenants.utils import get_public_schema_name
+
+
+def healthz(_request):
+    return HttpResponse("ok")
+
+
+public_urlpatterns = [
+    path("healthz/", healthz, name="healthz"),
+    path("tenant/", include("apps.tenant.urls")),
+    path("release/", include("apps.release.urls")),
+]
+
+tenant_urlpatterns = [
+    path("", include("apps.account.urls")),
+    path("permission/", include("apps.permission.urls")),
+    path("org/", include("apps.org.urls")),
+    path("region/", include("apps.region.urls")),
+    path("complex/", include("apps.complex.urls")),
+    path("property/", include("apps.property.urls")),
+    path("client/", include("apps.client.urls")),
+    path("setting/", include("apps.setting.urls")),
+]
+
+if connection.schema_name == get_public_schema_name():
+    urlpatterns = public_urlpatterns
+else:
+    urlpatterns = tenant_urlpatterns
+
+if settings.DEBUG:
+    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

config/wsgi.py

@@ -0,0 +1,7 @@
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "config.settings.development")
+
+application = get_wsgi_application()