init: Manar platform scaffold

README.md

@@ -1,3 +1,38 @@
-# manar
+# Manar (منار)
+**AI-Driven Paid Media Operations Platform**
 
-Manar — AI Paid Media Ops Platform
+Manar means *beacon/lighthouse* in Arabic. It monitors, diagnoses, recommends, executes, and reports on paid media — starting with Google Ads.
+
+## Architecture
+| Container | Purpose |
+|---|---|
+| `manar-frontend` | Next.js dashboard at `manar.asktam.net` |
+| `manar-core-db` | Postgres 16 — brands, users, memberships |
+| `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.
+
+## Phase 1 Brands
+- Al Salama Medical — Google Ads ID: `5467427558`
+- Ask Tam
+
+## Trust Ladder
+| Level | Name | Behavior |
+|---|---|---|
+| 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