# Admin guide

## Getting in

- `/admin` is the moderation queue (the default page). Staff sign in with their member account and **Continue to admin**; until a real staff account exists, the owner password (the `ADMIN_PASSWORD` setting) can bootstrap a session — leave that unset once admins exist.
- Roles: **admin** sees everything; **moderator** sees the moderation pages (queue, listings, directory, event edits, companies, event watch). Removing a role ends access at once, on the next request.
- Every write lands in the **audit log** recording who did it. If an action surprised you, the log is the first place to look.

## Where to approve member submissions

- **Event URLs** — Content → **Event watch** (`/admin/watched`). Members propose an event URL from `/app/events`; rows arrive Proposed. **Approve** (goes into the monthly sponsor crawl), **Reject**, or **Delete** (stored sightings stay). "Re-read" pushes an approved URL back into the queue.
- **Companies** — Content → **Companies** (`/admin/companies`). Radar proposals arrive Proposed → edit to set Active, or merge one company into another when a name was tracked twice.
- **Events** — Content → **Listings**; proposed events from the public submit form wait here.
- All of it also flows into the **Queue** (the `/admin` home), the fastest review surface when you just want to work the backlog.

## The menus

**Queue** — the moderation queue: everything waiting, in one place.

**Content**

- **Listings** — the events themselves: approve, edit, reject; the public calendar is the output.
- **Directory** — speaker profiles.
- **Companies** — the radar's tracked-company index: status, per-company "Re-check", merge when needed.
- **Event watch** — member-proposed event URLs awaiting approval or serving the crawl.
- **Sources** — the imports that feed listings automatically.

**Advertising**

- **Campaigns** — sponsor campaigns; ads render labelled ("Ad") and never unlabelled.
- **Ad stats** — how the slots perform.

**People**

- **Members** — accounts and roles: grant or change a plan (Free / Planner / Planner Pro), make someone a moderator or a **partner** (never shown the paid side), and email-domain rules that auto-set partners at sign-up.
- **Enquiries** — the contact form's queue.
- **Feedback** — in-product feedback.

**System**

- **Jobs** — the background jobs. Nothing runs on a schedule in dev: run by hand with `pnpm job <name>` or the "Run now" button; the monthly sponsor crawl (`sponsors:refresh`, second of the month in prod) and the company sweep (`sponsors:sweep`) are the AI-billed ones — watch them, there is a kill switch and per-run cost ceilings.
- **Health** — data health: listing quality, coverage by city, the moderation queue (sys-admin checks are planned, FEATURES §9).
- **Business** — the platform as a business: events by source, platform cost per month (fixed lines + measured AI spend in A$), admin labour, members and revenue.
- **Fixed costs** — each month, add what every vendor billed (A$, from the invoice). "Copy last month" starts a new month from the previous one; edit the lines that changed.
- **Admin hours** — log time spent running the platform by area. Stored as hours, so the rates in Settings → Business re-price every month.
- **Settings** — the platform's knobs, including the AI model that drives the crawl costs, and (under Business) the FX rate and day rates the business dashboard uses.
- **AI SmartSearch** — the natural-language search over events.

## Habits that keep this honest

- Approve an event watch URL only when the page is the event's own (or its sponsors page). The crawl reads it monthly; a wrong page burns budget until you delete it.
- Reject rather than delete when a proposal makes sense but the URL is wrong — rejection keeps the record and the member knows the state.
- The audit log plus the labels: if something is written, someone's name is on it. Do not work around the tools.
