2.2 Digital Intellectual Observatory (المرصد الفكري)

A global, cross-tenant monitoring command center designed to track and refute digital misconceptions and threats:

• Public Report Intake: A glowing, high-impact public form protected by Cloudflare Turnstile spam prevention, allowing users to report threat URLs with danger levels and spread matrices.
• Analyst Control Panel: Observatory managers and analysts can triage incoming reports, assign scholars, and link scientific refutations (counter-measures). Neutralized threats are automatically published to the public defense feed.

2.3 Omni-Channel Content Engine

A unified CMS supporting multiple content categories and formats with native bilingual (Arabic/English) layout support:

• Articles: Rich text writing via TiPTap v3 with native logical CSS properties supporting seamless RTL/LTR layout transitions.
• Video Streaming: Resilient media player supporting YouTube embeddings alongside fallback stream sources (like Cloudflare Stream) to bypass censorship.
• Audio/Podcasts: Complete support for podcasts and lectures, allowing self-hosted MP3 uploads or external stream links.

2.4 Premium Gate & Privacy-First Analytics

• Premium Gate: Restricts exclusive courses or refutations behind a subscription barrier, bypassed automatically for tenant staff.
• Umami Integration: Built-in tracking using self-hosted, privacy-first Umami Analytics to ensure analytics data is not harvested by advertising networks.

3. Project Structure

burhan/
├── app/                          # Nuxt 4 Frontend & App Shell
│   ├── app.vue                   # Root component & transitions
│   ├── assets/css/main.css       # Onyx/Gold global design system styles
│   ├── components/
│   │   ├── dashboard/            # RichTextEditor, FloatingSidebar, editor-toolbar
│   │   ├── hub/                  # EntityCard, CategorySection
│   │   ├── premium/              # PremiumGate
│   │   ├── tenant/               # OrgHeader, BranchNav, VideoPlayer
│   │   └── ui/                   # Button, Badge, GlassCard, AppSelect, Avatar
│   ├── composables/              # useUser, useOrg, useLocale, useEntities
│   ├── i18n/                     # Bilingual UI translations (ar.json, en.json)
│   ├── layouts/                  # default.vue (public), dashboard.vue (admin)
│   ├── middleware/               # dashboard-auth.ts, org.global.ts, observatory-auth.ts
│   ├── pages/                    # File-system routing (Hub, Tenant, Observatory, Dashboard)
│   ├── types/                    # Database TypeScript definitions
│   └── utils/                    # localized.ts, image.ts
├── server/                       # Nitro Server Engine (Cloudflare Pages compatible)
│   ├── api/                      # Server routes (auth, tenant registration, observatory)
│   └── utils/                    # supabase.ts (admin client factory)
├── supabase/                     # Supabase database config
│   ├── migrations/               # Chronological database patches (00001 - 00009)
│   └── schema.sql                # Unified database setup script (one-click setup)
├── public/                       # PWA icons and loaders
├── nuxt.config.ts                # Nuxt configuration
├── tailwind.config.ts            # Tailwind onyx/gold theme definition
└── package.json                  # Dependencies & scripts

4. Ethical Use License & Policy (سياسة الاستخدام الأخلاقي)

Burhan is open-source but carries strict ethical constraints. The source code and database schemas are provided as a sovereign technical asset (وقف تقني).

By cloning, deploying, or contributing to this project, you agree to the following restrictions:

• You shall not deploy this software on platforms or for organizations that promote atheism or actively undermine Islamic values.
• You shall not use this software to serve hostile entities, promote sectarian hatred, or distribute unethical/immoral media.
• The creators and contributors of Burhan reserve the right to revoke permission to use this codebase if these terms are violated.

5. Getting Started

5.1 Prerequisites

• Node.js 20+
• A Supabase Project (URL + Anon Key + Service Role Key)
• Cloudflare Turnstile Account (Optional, for Observatory spam protection)

5.2 Local Installation

1. Clone the repository and install dependencies:

   git clone https://github.com/Ibrahem3/burhan-platform.git
   cd burhan-platform
   npm install
   

2. Configure environment variables:

   cp .env.example .env
   

   Open .env and fill in your Supabase project endpoints and credentials:

   SUPABASE_URL=https://your-project.supabase.co
   SUPABASE_KEY=your-anon-public-key
   SUPABASE_SECRET_KEY=your-service-role-key
   # Optional Cloudflare Turnstile keys
   NUXT_PUBLIC_TURNSTILE_SITE_KEY=your-site-key
   NUXT_TURNSTILE_SECRET_KEY=your-secret-key
   

3. Setup Database Schemas:

   • Open your project in the Supabase Dashboard.
   • Go to the SQL Editor tab.
   • Open supabase/schema.sql in your code editor, copy its entire contents, paste it into the Supabase SQL Editor, and click Run. This builds all tables, enums, triggers, security functions, RLS policies, and storage buckets in one click.

4. Run the local server:

   npm run dev
   

   Your site will be available at http://localhost:3000.

6. Contribution Guide: Join the Intellectual Defense

The core backend architecture, multi-tenant security layers (RLS), API routing, database schema, and translation engines are fully optimized, solid, and production-ready.

However, the Frontend UI is currently in a functional state. We explicitly invite the open-source community to fork, contribute, and enhance the UI/UX.

How to Contribute:

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/ui-enhancement).
3. Polish the UI components under app/components/ or pages under app/pages/.
4. Submit a Pull Request with a clear explanation of your visual improvements.

Let's build a sovereign and resilient infrastructure together!

💬 Join our Discord Community: Join Ainux on Discord