init: Manar platform scaffold

README.md

@@ -1,38 +1,17 @@
-# Manar (منار)
+# Manar (منار) — AI Paid Media Ops Platform
-**AI-Driven Paid Media Operations Platform**
 
-Manar means *beacon/lighthouse* in Arabic. It monitors, diagnoses, recommends, executes, and reports on paid media — starting with Google Ads.
+Manar means beacon/lighthouse in Arabic.
+Monitor → Diagnose → Recommend → Execute → Report
 
-## Architecture
+## Containers
-| Container | Purpose |
+- manar-frontend: Next.js at manar.asktam.net
-|---|---|
+- manar-core-db: Postgres 16 (brands, users, memberships)
-| `manar-frontend` | Next.js dashboard at `manar.asktam.net` |
+- manar-tenants-db: Postgres 16 (per-brand schemas)
-| `manar-core-db` | Postgres 16 — brands, users, memberships |
+- manar-mcp: FastMCP Google Ads connector
-| `manar-tenants-db` | Postgres 16 — per-brand schemas |
-| `manar-mcp` | FastMCP — Google Ads connector + AI tools |
 
-Shared: ClickHouse (`manar` DB), Metabase, n8n, LiteLLM — all existing on VPS.
+## Brands (Phase 1)
-
+- Al Salama Medical: Google Ads 5467427558
-## Phase 1 Brands
-- Al Salama Medical — Google Ads ID: `5467427558`
 - Ask Tam
 
 ## Trust Ladder
-| Level | Name | Behavior |
+L0 Observer | L1 Suggest | L2 Auto+veto | L3 Autopilot
-|---|---|---|
-| L0 | Observer | Monitor + report only |
-| L1 | Suggest | Recommends, waits for approval |
-| L2 | Auto with veto | Executes, approval window to cancel |
-| L3 | Autopilot | Silent execution, post-hoc audit |
-
-## Five Capabilities
-Monitor → Diagnose → Recommend → Execute → Report
-
-## Week 1 Checklist
-- [x] Gitea repo: `colorlink/manar`
-- [ ] VPS scaffold: `/docker/manar/`
-- [ ] `manar-core-db` + schemas
-- [ ] `manar-tenants-db` + brand schemas
-- [ ] ClickHouse `manar` database + tables
-- [ ] `manar-mcp` skeleton
-- [ ] Data flow validated: OAuth → metrics → ClickHouse → Metabase