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.

.env.example

@@ -0,0 +1,29 @@
+# Django
+SECRET_KEY=your-secret-key-here
+DEBUG=True
+DJANGO_SETTINGS_MODULE=config.settings.development
+ALLOWED_HOSTS=localhost,127.0.0.1
+
+# Database
+DB_NAME=fonrey
+DB_USER=fonrey
+DB_PASSWORD=fonrey
+DB_HOST=db
+DB_PORT=5432
+
+# Redis
+REDIS_URL=redis://redis:6379/0
+CELERY_BROKER_URL=redis://redis:6379/1
+
+# Cloudflare R2
+R2_ENDPOINT_URL=https://<account_id>.r2.cloudflarestorage.com
+R2_ACCESS_KEY_ID=
+R2_SECRET_ACCESS_KEY=
+R2_BUCKET_NAME=media
+R2_CUSTOM_DOMAIN=
+
+# Sentry（production 填写）
+SENTRY_DSN=
+
+# PII 加密密钥（AES-256，生产环境必须替换）
+PHONE_ENCRYPTION_KEY=

.gitignore

@@ -0,0 +1,8 @@
+.env
+*.pyc
+__pycache__/
+.DS_Store
+node_modules/
+static/css/output.css
+media/
+dist/

Dockerfile

@@ -0,0 +1,8 @@
+FROM python:3.12-slim
+WORKDIR /app
+RUN apt-get update && apt-get install -y     libpq-dev gcc     && rm -rf /var/lib/apt/lists/*
+COPY requirements/base.txt requirements/base.txt
+RUN pip install --no-cache-dir -r requirements/base.txt
+COPY . .
+EXPOSE 8000
+CMD ["uvicorn", "config.asgi:application", "--host", "0.0.0.0", "--port", "8000"]

Makefile

@@ -0,0 +1,23 @@
+.PHONY: dev migrate shell createsuperuser test lint
+
+dev:
+	docker compose up
+
+migrate:
+	docker compose exec web python manage.py migrate_schemas --shared
+	docker compose exec web python manage.py migrate_schemas
+
+shell:
+	docker compose exec web python manage.py shell_plus
+
+test:
+	docker compose exec web pytest apps/ -v
+
+lint:
+	ruff check . && black --check .
+
+tailwind-build:
+	npm run build
+
+createsuperuser:
+	docker compose exec web python manage.py create_tenant_superuser

apps/account/admin.py

@@ -0,0 +1 @@
+from django.contrib import admin

apps/account/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class AccountConfig(AppConfig):
+    name = "apps.account"
+    verbose_name = "登录认证"

apps/account/tasks.py

@@ -0,0 +1,6 @@
+from celery import shared_task
+
+
+@shared_task
+def sample_task() -> str:
+    return "account task placeholder"

apps/account/urls.py

@@ -0,0 +1,9 @@
+from django.urls import path
+
+from . import views
+
+app_name = "account"
+
+urlpatterns = [
+    path("", views.index, name="index"),
+]

apps/account/views.py

@@ -0,0 +1,5 @@
+from django.http import HttpRequest, HttpResponse
+
+
+def index(request: HttpRequest) -> HttpResponse:
+    return HttpResponse("account app placeholder")

apps/client/admin.py

@@ -0,0 +1 @@
+from django.contrib import admin

apps/client/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class ClientConfig(AppConfig):
+    name = "apps.client"
+    verbose_name = "客源管理"

apps/client/tasks.py

@@ -0,0 +1,6 @@
+from celery import shared_task
+
+
+@shared_task
+def sample_task() -> str:
+    return "client task placeholder"

apps/client/urls.py

@@ -0,0 +1,9 @@
+from django.urls import path
+
+from . import views
+
+app_name = "client"
+
+urlpatterns = [
+    path("", views.index, name="index"),
+]

apps/client/views.py

@@ -0,0 +1,5 @@
+from django.http import HttpRequest, HttpResponse
+
+
+def index(request: HttpRequest) -> HttpResponse:
+    return HttpResponse("client app placeholder")

apps/complex/admin.py

@@ -0,0 +1 @@
+from django.contrib import admin

apps/complex/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class ComplexConfig(AppConfig):
+    name = "apps.complex"
+    verbose_name = "楼盘管理"

apps/complex/tasks.py

@@ -0,0 +1,6 @@
+from celery import shared_task
+
+
+@shared_task
+def sample_task() -> str:
+    return "complex task placeholder"

apps/complex/urls.py

@@ -0,0 +1,9 @@
+from django.urls import path
+
+from . import views
+
+app_name = "complex"
+
+urlpatterns = [
+    path("", views.index, name="index"),
+]

apps/complex/views.py

@@ -0,0 +1,5 @@
+from django.http import HttpRequest, HttpResponse
+
+
+def index(request: HttpRequest) -> HttpResponse:
+    return HttpResponse("complex app placeholder")

apps/org/admin.py

@@ -0,0 +1 @@
+from django.contrib import admin

apps/org/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class OrgConfig(AppConfig):
+    name = "apps.org"
+    verbose_name = "组织人事"

apps/org/tasks.py

@@ -0,0 +1,6 @@
+from celery import shared_task
+
+
+@shared_task
+def sample_task() -> str:
+    return "org task placeholder"

apps/org/urls.py

@@ -0,0 +1,9 @@
+from django.urls import path
+
+from . import views
+
+app_name = "org"
+
+urlpatterns = [
+    path("", views.index, name="index"),
+]

apps/org/views.py

@@ -0,0 +1,5 @@
+from django.http import HttpRequest, HttpResponse
+
+
+def index(request: HttpRequest) -> HttpResponse:
+    return HttpResponse("org app placeholder")

apps/permission/admin.py

@@ -0,0 +1 @@
+from django.contrib import admin

apps/permission/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class PermissionConfig(AppConfig):
+    name = "apps.permission"
+    verbose_name = "权限管理"

apps/permission/tasks.py

@@ -0,0 +1,6 @@
+from celery import shared_task
+
+
+@shared_task
+def sample_task() -> str:
+    return "permission task placeholder"

apps/permission/urls.py

@@ -0,0 +1,9 @@
+from django.urls import path
+
+from . import views
+
+app_name = "permission"
+
+urlpatterns = [
+    path("", views.index, name="index"),
+]

apps/permission/views.py

@@ -0,0 +1,5 @@
+from django.http import HttpRequest, HttpResponse
+
+
+def index(request: HttpRequest) -> HttpResponse:
+    return HttpResponse("permission app placeholder")

apps/property/admin.py

@@ -0,0 +1 @@
+from django.contrib import admin

apps/property/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class PropertyConfig(AppConfig):
+    name = "apps.property"
+    verbose_name = "房源核心"

apps/property/tasks.py

@@ -0,0 +1,6 @@
+from celery import shared_task
+
+
+@shared_task
+def sample_task() -> str:
+    return "property task placeholder"

apps/property/urls.py

@@ -0,0 +1,9 @@
+from django.urls import path
+
+from . import views
+
+app_name = "property"
+
+urlpatterns = [
+    path("", views.index, name="index"),
+]

apps/property/views.py

@@ -0,0 +1,5 @@
+from django.http import HttpRequest, HttpResponse
+
+
+def index(request: HttpRequest) -> HttpResponse:
+    return HttpResponse("property app placeholder")

apps/region/admin.py

@@ -0,0 +1 @@
+from django.contrib import admin

apps/region/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class RegionConfig(AppConfig):
+    name = "apps.region"
+    verbose_name = "区域管理"

apps/region/tasks.py

@@ -0,0 +1,6 @@
+from celery import shared_task
+
+
+@shared_task
+def sample_task() -> str:
+    return "region task placeholder"

apps/region/urls.py

@@ -0,0 +1,9 @@
+from django.urls import path
+
+from . import views
+
+app_name = "region"
+
+urlpatterns = [
+    path("", views.index, name="index"),
+]

apps/region/views.py

@@ -0,0 +1,5 @@
+from django.http import HttpRequest, HttpResponse
+
+
+def index(request: HttpRequest) -> HttpResponse:
+    return HttpResponse("region app placeholder")

apps/release/admin.py

@@ -0,0 +1 @@
+from django.contrib import admin

apps/release/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class ReleaseConfig(AppConfig):
+    name = "apps.release"
+    verbose_name = "客户端发布管理"

apps/release/tasks.py

@@ -0,0 +1,6 @@
+from celery import shared_task
+
+
+@shared_task
+def sample_task() -> str:
+    return "release task placeholder"

apps/release/urls.py

@@ -0,0 +1,9 @@
+from django.urls import path
+
+from . import views
+
+app_name = "release"
+
+urlpatterns = [
+    path("", views.index, name="index"),
+]