# ASETQU V.2 - Digital Asset Ecosystem Platform

<p align="center">
  <img src="public/assets/images/logo.png" width="200" alt="ASETQU V.2 Logo">
</p>

<p align="center">
  <strong>A Unified Ecosystem for Growth & Rewards</strong>
</p>

<p align="center">
  <a href="#features">Features</a> •
  <a href="#tech-stack">Tech Stack</a> •
  <a href="#installation">Installation</a> •
  <a href="#documentation">Documentation</a> •
  <a href="#contributing">Contributing</a>
</p>

---

## 📋 About

**ASETQU V.2** adalah platform ekosistem aset digital yang komprehensif dengan fitur gamifikasi. Platform ini dibangun di atas blockchain Solana, dirancang untuk menghadirkan utilitas yang aman, transparan, dan berkinerja tinggi dalam ekosistem Real-World Assets (RWA).

Platform ini menyediakan modern ecosystem untuk digital assets, enabling secure transactions, transparent tokenization, and sustainable value growth for businesses and communities.

---

## ✨ Features

### 🏠 Company Profile Website

-   Landing pages dengan CMS yang fleksibel
-   Mega menu navigation
-   Responsive design dengan Bootstrap 5.3
-   SEO-friendly content management
-   **Header Menu Management** - edit text, reorder items, manage mega menu
-   **Footer Management** - edit footer text, copyright, contact info
-   **Social Media Links** - manage social media icons and URLs

### 🔐 User Authentication System

-   Login/Register dengan email
-   E-Wallet connection (MetaMask, Phantom, etc.)
-   Role-based access control (Admin/Visitor/Guest)
-   Email verification & password reset

### 📊 Token Dashboard

-   Real-time token information
-   Staking dashboard dengan reward tracking
-   Burn tracker interaktif
-   Market analytics

### 💰 E-Wallet Integration

-   Multi-platform wallet support (Indodax, MetaMask, Trust Wallet, Coinbase, Phantom)
-   Wallet balance synchronization
-   Primary wallet management
-   Web3 & Exchange wallet types

### 🎮 Gamification System

-   Built-in games untuk collect coins
-   Coin to points conversion
-   Daily login rewards dengan streak bonus
-   Leaderboard & achievements

### 📚 Academy/Education

-   Educational video content via YouTube links
-   Video catalog with level & category filters
-   Track user watch history (logged-in users)
-   No enrollment system - direct YouTube redirect

### 📅 News & Events

-   Event calendar (Admin-created events only)
-   Only 1 event per date allowed
-   Event registration for visitors
-   Email reminders (before event & on event day)
-   Newsletter subscription

### 💬 Community Feed

-   Testimonials displayed on homepage
-   Admin-managed content only (no user submissions)
-   Curated community stories & reviews

---

## 🛠️ Tech Stack

### Backend

| Technology                    | Version | Purpose                          |
| ----------------------------- | ------- | -------------------------------- |
| **PHP**                       | 8.2+    | Server-side programming language |
| **Laravel**                   | 12.x    | Core PHP framework               |
| **PostgreSQL**                | 15.x+   | Primary database                 |
| **nwidart/laravel-modules**   | 12.x    | HMVC modular architecture        |
| **Laravel Sanctum**           | Latest  | API authentication               |
| **Spatie Laravel Permission** | Latest  | Role & permission management     |
| **Intervention Image**        | Latest  | Image processing                 |
| **Maatwebsite Excel**         | Latest  | Export functionality             |

### Frontend

| Technology              | Version   | Purpose           |
| ----------------------- | --------- | ----------------- |
| **Blade**               | (Laravel) | Templating engine |
| **Bootstrap**           | 5.3.x     | CSS framework     |
| **Vanilla JS / jQuery** | Latest    | Interactivity     |
| **Swiper.js**           | Latest    | Carousels/sliders |
| **Chart.js**            | Latest    | Dashboard charts  |
| **Vite**                | Latest    | Asset bundling    |

### Infrastructure

| Technology       | Purpose                   |
| ---------------- | ------------------------- |
| **Redis**        | Caching (optional)        |
| **Queue Worker** | Background job processing |
| **Cron Jobs**    | Scheduled tasks           |

---

## 📁 Project Structure

Project menggunakan arsitektur **HMVC (Hierarchical Model-View-Controller)** dengan struktur modular:

```
asqv2/
├── app/                    # Laravel core application
├── bootstrap/              # Framework bootstrap files
├── config/                 # Configuration files
├── database/               # Migrations, factories, seeders
├── docs/                   # Project documentation
│   ├── HLD.md              # High Level Design
│   ├── LLD.md              # Low Level Design
│   ├── DATABASE_DESIGN.md  # Database schema & ERD
│   ├── SYSTEM_FLOW.md      # System flow diagrams
│   └── API_DOCUMENTATION.md # API reference
├── Modules/                # HMVC Modules
│   ├── Core/               # Shared layouts, components
│   ├── Home/               # Homepage module
│   ├── Auth/               # Authentication module
│   ├── Admin/              # Admin panel module
│   ├── Page/               # CMS pages module
│   ├── News/               # News & events module
│   ├── Game/               # Gamification module
│   ├── Wallet/             # E-wallet module
│   ├── Point/              # Points & rewards module
│   ├── Dashboard/          # User dashboard module
│   └── Setting/            # Site settings module
├── public/                 # Public assets
├── resources/              # Views, CSS, JS
├── routes/                 # Route definitions
├── storage/                # App storage
├── tests/                  # Test suites
└── vendor/                 # Composer dependencies
```

---

## 🚀 Installation

### Prerequisites

-   PHP >= 8.2
-   Composer >= 2.x
-   Node.js >= 18.x
-   PostgreSQL >= 15.x
-   Git

### Step 1: Clone Repository

```bash
git clone https://github.com/your-org/asqv2.git
cd asqv2
```

### Step 2: Install Dependencies

```bash
# Install PHP dependencies
composer install

# Install NPM dependencies
npm install
```

### Step 3: Environment Configuration

```bash
# Copy environment file
cp .env.example .env

# Generate application key
php artisan key:generate
```

Edit `.env` file dengan konfigurasi database:

```env
DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=asqv2
DB_USERNAME=your_username
DB_PASSWORD=your_password
```

### Step 4: Database Setup

```bash
# Run migrations
php artisan migrate

# Seed database (optional)
php artisan db:seed

# Publish module migrations
php artisan module:migrate
```

### Step 5: Build Assets

```bash
# Development
npm run dev

# Production
npm run build
```

### Step 6: Start Development Server

```bash
php artisan serve
```

Visit `http://localhost:8000` in your browser.

---

## 📚 Documentation

Dokumentasi lengkap tersedia di folder `/docs`:

| Document                                          | Description                                        |
| ------------------------------------------------- | -------------------------------------------------- |
| [HLD.md](docs/HLD.md)                             | High Level Design - Arsitektur sistem dan overview |
| [LLD.md](docs/LLD.md)                             | Low Level Design - Detail teknis implementasi      |
| [DATABASE_DESIGN.md](docs/DATABASE_DESIGN.md)     | Database schema, ERD, dan table definitions        |
| [SYSTEM_FLOW.md](docs/SYSTEM_FLOW.md)             | System flow diagrams dan user journeys             |
| [API_DOCUMENTATION.md](docs/API_DOCUMENTATION.md) | API endpoints reference                            |
| [discuss.md](discuss.md)                          | Project discussion dan planning notes              |

---

## 🔧 Configuration

### Module Management

```bash
# Enable module
php artisan module:enable ModuleName

# Disable module
php artisan module:disable ModuleName

# Create new module
php artisan module:make ModuleName

# List modules
php artisan module:list
```

### Queue Worker

```bash
# Start queue worker
php artisan queue:work

# Start queue worker with specific connection
php artisan queue:work database --queue=high,default
```

### Scheduled Tasks

Add to crontab:

```bash
* * * * * cd /path-to-project && php artisan schedule:run >> /dev/null 2>&1
```

---

## 🧪 Testing

```bash
# Run all tests
php artisan test

# Run specific test suite
php artisan test --testsuite=Feature

# Run with coverage
php artisan test --coverage
```

---

## 👥 User Roles

| Role        | Description                                            |
| ----------- | ------------------------------------------------------ |
| **Admin**   | Full access - CMS management, user management, reports |
| **Visitor** | Registered users - Profile, wallet, games, points      |
| **Guest**   | Non-registered - Public pages only                     |

---

## 🎨 Design Reference

**Figma Prototype:** [ASETQU V.2 Design](https://www.figma.com/proto/c91gokvGUZOphzStiDvlav/ASQ-V.2)

### Color Palette

| Color          | Hex       | Usage                |
| -------------- | --------- | -------------------- |
| Primary Gold   | `#FFD700` | Highlights, headings |
| Primary Orange | `#E85D04` | CTA buttons          |
| Accent Cyan    | `#22D3EE` | Links, accents       |
| Dark Purple BG | `#12051F` | Main background      |
| Purple Mid     | `#2D1B4E` | Card backgrounds     |

---

## 🤝 Contributing

1. Fork the repository
2. Create feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit changes (`git commit -m 'Add AmazingFeature'`)
4. Push to branch (`git push origin feature/AmazingFeature`)
5. Open Pull Request

---

## 📄 License

This project is proprietary software. All rights reserved.

---

## 📞 Contact

-   **Website:** [asetqu.com](https://asetqu.com)
-   **Email:** support@asetqu.com
-   **Discord:** [AsetQu Community](https://discord.gg/asetqu)

---

<p align="center">
  <strong>© 2026 ASETQU V.2. All Rights Reserved.</strong>
</p>
