# web_django_template

Gitea template for AI ML Operations client websites
([Web Design & Hosting](https://aimloperations.com/web_design)).

Clone this repo (or **Use this template**), run `scripts/bootstrap-client.sh`,
set branding + `FEATURE_*` flags in the secret env file, deploy.

Always included: public site (landing, about, contact) and client portal
(login, dashboard, leads, UTM analytics). Optional catalog add-ons are
separate Django apps. A flag that is off keeps the app out of
`INSTALLED_APPS` — no models, admin, URLs, or portal nav.

## Catalog → flags

| Catalog item | Flag | App |
|---|---|---|
| Public site | (always on) | `public` |
| Client portal + UTM | (always on) | `accounts`, `dashboard`, `leads`, `analytics`, `contacts`, `core` |
| Email & SMS | `FEATURE_EMAIL_SMS` | `email_sms` |
| Direct mail (PCM) | `FEATURE_DIRECT_MAIL` | `directmail` |
| Blog | `FEATURE_BLOG` | `blog` |
| Payments (Stripe) | `FEATURE_PAYMENTS` | `payments` (requires email/SMS) |
| Social consolidation | `FEATURE_SOCIAL` | `social` |
| AI social generator | `FEATURE_SOCIAL_AI` | `social_ai` (requires social) |

## New client

```bash
# 1. Create repo from this Gitea template, clone it.
# 2. Rename package + branding placeholders:
./scripts/bootstrap-client.sh acme_site "Acme HVAC" acmehvac.com

# 3. Brand public templates and static/brand/ (logo, colors, copy).

# 4. Secrets on the control node:
mkdir -p ~/Documents/secrets/acme_site
cp .env.prod.example ~/Documents/secrets/acme_site/acme_site_prod.env
# Flip only purchased FEATURE_* flags. Fill provider secrets.
./scripts/validate-env.sh ~/Documents/secrets/acme_site/acme_site_prod.env

# 5. Infra: Postgres on 10.0.0.230, server-infra app_catalog, NPM, CI.
# 6. Deploy. Create a portal user (createsuperuser).
```

Local:

```bash
cp .env.example .env
uv sync
cd site
uv run python manage.py migrate
uv run python manage.py runserver
# or: docker compose up
```

## Stack

Django 6 + uv · Postgres (prod/beta); SQLite locally · dj-queue · Docker ·
server-infra Ansible deploy.

Ollama for social drafts lives on the LAN at `http://10.0.0.128:11434`.
Do not call a public Ollama host.