college_craft/README.md

web_django_template

Gitea template for AI ML Operations client websites (Web Design & Hosting).

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

# 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:

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.