# User Roles & Permissions

## Role Hierarchy

| Role | Description |
|------|-------------|
| **Admin** | Full system access, manages all content, users, and settings |
| **Manager** | Content management, post approval, limited admin access |
| **Subscriber** | Can write and submit posts for review |

## Permission Matrix

| Feature | Admin | Manager | Subscriber | Public |
|---------|:-----:|:-------:|:----------:|:------:|
| **Public Pages** | | | | |
| View homepage, blog, posts | Yes | Yes | Yes | Yes |
| View static pages (About, Privacy, etc.) | Yes | Yes | Yes | Yes |
| Search articles | Yes | Yes | Yes | Yes |
| Subscribe to newsletter | Yes | Yes | Yes | Yes |
| Submit contact form | Yes | Yes | Yes | Yes |
| **Authentication** | | | | |
| Register account | — | — | — | Yes |
| Login/Logout | Yes | Yes | Yes | — |
| **Subscriber Dashboard** | | | | |
| View dashboard stats | Yes | Yes | Yes | — |
| Create posts | — | — | Yes | — |
| Edit own posts | — | — | Yes | — |
| Delete own posts | — | — | Yes | — |
| Submit posts for review | — | — | Yes | — |
| **Admin — Content** | | | | |
| View all posts | Yes | Yes | — | — |
| Create posts | Yes | Yes | — | — |
| Edit any post | Yes | Yes | — | — |
| Delete posts | Yes | — | — | — |
| View pending approvals | Yes | Yes | — | — |
| Approve/reject posts | Yes | — | — | — |
| View AI bot drafts | Yes | Yes | — | — |
| **Admin — Categories** | | | | |
| View categories | Yes | — | — | — |
| Create/edit/delete categories | Yes | — | — | — |
| **Admin — Users** | | | | |
| View all users | Yes | — | — | — |
| Approve/reject subscribers | Yes | — | — | — |
| Suspend/delete users | Yes | — | — | — |
| Create manager accounts | Yes | — | — | — |
| **Admin — AI Bot** | | | | |
| Bot dashboard | Yes | — | — | — |
| Manage keywords | Yes | — | — | — |
| Generate articles | Yes | — | — | — |
| Manage bot articles | Yes | — | — | — |
| View/clear error logs | Yes | — | — | — |
| Bot settings | Yes | — | — | — |
| **Admin — Communication** | | | | |
| View subscribers | Yes | — | — | — |
| Compose/send newsletter | Yes | — | — | — |
| Process newsletter queue | Yes | — | — | — |
| View newsletter logs | Yes | — | — | — |
| View contact messages | Yes | — | — | — |
| Delete contact messages | Yes | — | — | — |
| **Admin — System** | | | | |
| Manage static pages | Yes | — | — | — |
| Site settings | Yes | — | — | — |

## Access Control Implementation

- **AuthMiddleware**: Checks every request against a whitelist of route → role mappings
- **require_auth()**: Verifies session has a logged-in user
- **require_role('role')**: Verifies user has the specified role
- **has_role(...roles)**: Helper to check if current user has any of the listed roles
- Routes not in the middleware rules are publicly accessible
