monica_site

Django 6 marketing platform for Monica Dhillon / MKDRealtor.com — public site, realtor portal, multi-channel outreach (email + SMS via SMTP2GO, postcards via PCM Integrations), and social scheduling (Facebook / Instagram / LinkedIn) with Ollama-assisted drafting.

Stack

• Django 6 + uv
• Postgres (prod/beta); SQLite locally when DATABASE_URL unset
• dj-queue (Django Tasks backend, Postgres queue, no Redis/Celery)
• Docker; deploy via server-infra Ansible pipeline

Environments

Env	Domain	Port (host)	Gate
prod	mkdrealtor.com	8004	SITE_UNDER_CONSTRUCTION=true (holding page)
beta	monica-preview.aimloperations.com	8014	full app (SITE_UNDER_CONSTRUCTION=false)

Local development

uv sync
cd site
uv run python manage.py migrate
uv run python manage.py runserver
# optional: docker compose up   # web + postgres (hot reload)
# optional worker: docker compose --profile worker up worker

Docker compose mounts ./site into the container and runs Django runserver when DJANGO_ENV=dev (the default). Edit Python/templates → auto-reload; no image rebuild. Rebuild only when Dockerfile / deps (pyproject.toml, uv.lock) change:

docker compose up --build

Local secrets (SMTP2GO, etc.)

Copy .env.example → .env (gitignored). Compose reads .env for email vars.

cp .env.example .env
# fill EMAIL_HOST_USER / EMAIL_HOST_PASSWORD
# for real delivery (not console logs):
# EMAIL_BACKEND=django.core.mail.backends.smtp.EmailBackend
docker compose up

Without EMAIL_BACKEND=…smtp…, mail prints to the web container logs (console backend).

SMTP2GO delivery webhooks

See site/messaging/README.md for SMTP2GO email/SMS webhooks and PCM Integrations postcard designer + webhook setup (Bearer auth, events).

Prod compose (docker-compose.prod.yml) still uses gunicorn with baked-in image code.

Secret env files (control node)

Create on the deploy host:

~/Documents/secrets/monica_site/monica_site_prod.env
~/Documents/secrets/monica_site/monica_site_beta.env

Templates: .env.prod.example (full var list). Validate with:

./scripts/validate-env.sh ~/Documents/secrets/monica_site/monica_site_prod.env

Deploy

CI on merge to main → tests → server-infra/scripts/deploy.sh --app monica_site --env prod --ref <sha>.

Start the dj-queue worker on exactly one host:

docker compose -f docker-compose.prod.yml --profile worker up -d

Apps

public · accounts · dashboard · leads · contacts · analytics · messaging · social

Social AI drafts: POST /portal/social/api/generate/ → Ollama at OLLAMA_BASE_URL (default http://10.0.0.128:11434).

See docs/monica-site-design.md for architecture.