generated from westfarn/web_django_template
westfarn
b62357c8be
Keep mint/UTM in always-on core so email_sms and directmail stay optional, and brand utm_source from SITE_NAME (or UTM_SOURCE) instead of a hardcoded client name. Closes westfarn/web_django_template#3
84 lines
2.9 KiB
Markdown
84 lines
2.9 KiB
Markdown
# 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.
|
|
|
|
## Campaign tracked links (piha.li)
|
|
|
|
When `FEATURE_EMAIL_SMS` or `FEATURE_DIRECT_MAIL` is on, composers auto-insert a
|
|
homepage URL with `utm_source` (slug of `SITE_NAME`, or `UTM_SOURCE`),
|
|
`utm_medium` = channel, and `utm_campaign` = campaign name. Configured
|
|
`SHORTENER_BASE_URL` + `SHORTENER_API_TOKEN` mint that URL via
|
|
[url_shortening_service](https://git.aimloperations.com/ai_ml_operations/url_shortening_service)
|
|
and put `piha.li` / `beta.piha.li` short links in SMS, email hrefs, and postcard QR codes.
|
|
|
|
Caller secrets (this repo's env file):
|
|
|
|
```text
|
|
SHORTENER_BASE_URL=https://shortener.aimloperations.com
|
|
SHORTENER_API_TOKEN=<slug>:<secret>
|
|
```
|
|
|
|
Operator secrets (`url_shortening_service_*`): `SHORTENER_API_TOKENS=<slug>:<same-secret>`
|
|
and `SHORT_ALLOWED_HOSTS` must include the client domain. Mint against the **API host**,
|
|
never `piha.li`.
|