Discussion Platform

Aplikasi platform diskusi berbasis web yang dibangun dengan Laravel 11 dan Livewire 3. Platform ini memungkinkan pengguna untuk membuat, berbagi, dan mendiskusikan topik-topik dengan fitur lengkap seperti komentar, reaksi, laporan konten, dan sistem verifikasi.

📋 Daftar Isi

Fitur Utama
Stack Teknologi
Instalasip3
Struktur Direktori
Dokumentasi Module
API Routes

✨ Fitur Utama

✅ Autentikasi pengguna dengan email & Google OAuth
✅ Sistem verifikasi email
✅ Reset password melalui email
✅ Membuat, mengedit, dan menghapus post/diskusi
✅ Sistem komentar berjenjang
✅ Reaksi terhadap post dan komentar
✅ Pencarian dan filter konten
✅ Tag/kategori untuk post
✅ Simpan post favorit
✅ Laporan konten yang melanggar
✅ Appeal/banding untuk konten yang dilaporkan
✅ Dashboard admin untuk pengelolaan
✅ Sistem trust score untuk pengguna
✅ Notifikasi
✅ Pengaturan profil dan keamanan

🛠 Stack Teknologi

Backend:

Laravel 11.31
PHP 8.2+
Livewire 3.6
Laravel Socialite 5.23 (Google OAuth)
Spatie Permission 6.21 (Role & Permission)

Frontend:

Tailwind CSS 4.1
Vite 5.0
DaisyUI 5.5
Alpine.js
jQuery
ApexCharts (Grafik)
DataTables (Tabel)
Tagify (Tag Input)

Database:

MySQL/PostgreSQL

Testing:

Pest PHP 3.6
PHPUnit

📦 Instalasi

Prerequisites

PHP 8.2 atau lebih tinggi
Composer
Node.js & npm
MySQL/PostgreSQL

Setup Project

# Clone repository
git clone <repository-url>
cd Discussion

# Install PHP dependencies
composer install

# Install Node dependencies
npm install

# Copy environment file
cp .env.example .env

# Generate application key
php artisan key:generate

# Configure database di .env
# DB_CONNECTION=mysql
# DB_HOST=127.0.0.1
# DB_DATABASE=discussion
# DB_USERNAME=root
# DB_PASSWORD=

# Run migrations
php artisan migrate

# Seed database (optional)
php artisan db:seed

# Build frontend assets
npm run build

# Untuk development
npm run dev

# Start server
php artisan serve

📁 Struktur Direktori

Discussion/
├── app/
│   ├── Http/
│   │   ├── Controllers/         # HTTP Controllers
│   │   └── Middleware/          # Custom Middleware
│   ├── Models/                  # Database Models
│   ├── Jobs/                    # Queue Jobs
│   ├── Notifications/           # Email Notifications
│   └── Providers/               # Service Providers
├── routes/
│   ├── web.php                  # Web Routes
│   └── console.php              # Console Commands
├── database/
│   ├── migrations/              # Database Migrations
│   ├── factories/               # Model Factories
│   └── seeders/                 # Database Seeders
├── resources/
│   ├── views/                   # Blade Templates
│   ├── css/                     # Stylesheet
│   └── js/                      # JavaScript
├── config/                      # Configuration Files
├── storage/                     # Uploaded Files & Logs
├── tests/                       # Test Files
├── public/                      # Public Assets
└── vendor/                      # Dependencies

📚 Dokumentasi Module

1. Models (Database Models)

User

Model utama untuk pengguna platform.

Fields: id, name, email, password, email_verified_at, profile_picture, bio, trust_score, suspended_at
Relations:
- hasOne: UserDetail, UserSetting
- hasMany: Post, Comment, Reaction, Report, Appeal, TrustScoreLog
- belongsToMany: savedPosts (Post)

Post

Model untuk post/diskusi yang dibuat pengguna.

Fields: id, user_id, title, content, created_at, updated_at
Relations:
- belongsTo: User
- hasMany: Comment, Reaction, Report, Appeal
- belongsToMany: Tag, Saved (User)

Comment

Model untuk komentar pada post.

Fields: id, post_id, user_id, content, created_at, updated_at
Relations:
- belongsTo: Post, User
- hasMany: Reaction, Report

Tag

Model untuk kategori/tag post.

Fields: id, name, slug
Relations:
- belongsToMany: Post

Reaction

Model untuk reaksi (like/emoji) pada post atau comment.

Fields: id, user_id, post_id, comment_id, reaction_type, created_at
Relations:
- belongsTo: User, Post, Comment

Report

Model untuk laporan konten yang melanggar.

Fields: id, user_id, post_id, comment_id, reason, created_at
Relations:
- belongsTo: User, Post, Comment
- hasOne: Appeal

Appeals

Model untuk appeal/banding atas laporan konten.

Fields: id, report_id, user_id, reason, status, created_at, updated_at
Relations:
- belongsTo: Report, User

Saved

Model untuk post yang disimpan pengguna (Pivot table).

Fields: user_id, post_id, created_at
Relations:
- belongsTo: User, Post

UserDetail

Model untuk detail tambahan profil pengguna.

Fields: id, user_id, phone, address, city, country, website, date_of_birth
Relations:
- belongsTo: User

UserSetting

Model untuk pengaturan pengguna.

Fields: id, user_id, email_notification, public_profile, two_factor_enabled
Relations:
- belongsTo: User

TrustScoreLog

Model untuk log perubahan trust score pengguna.

Fields: id, user_id, change_amount, reason, created_at
Relations:
- belongsTo: User

Remember_Me

Model untuk token remember me.

Fields: id, user_id, token, expires_at

PostTag

Pivot table untuk relasi Post-Tag.

Fields: post_id, tag_id

2. Controllers (HTTP Controllers)

IndexController

Controller untuk halaman utama dan tampilan publik.

home() - Halaman beranda dengan list post
login() - Tampil form login
register() - Tampil form register
search() - Pencarian post
newest() - List post terbaru
DetailPost($id) - Detail halaman post
Profile($username) - Profil pengguna
tags() - Halaman list semua tag
tagPost($slug) - Post dengan tag tertentu
saved() - Post yang disimpan oleh user (protected)
post() - Form tambah post (protected)
postEdit($id) - Form edit post (protected)
EditProfile() - Form edit profil (protected)
dashboard() - Dashboard user (protected)
settings() - Halaman pengaturan (protected)
inbox() - Notifikasi inbox (protected)
inboxDetail($id) - Detail notifikasi (protected)

AuthController

Controller untuk autentikasi Google OAuth.

redirectToGoogle() - Redirect ke Google login
handlerGoogleCallback() - Handle callback dari Google

UserController

Controller untuk CRUD operasi user.

index() - Login/attempt autentikasi
create() - Register user baru
logout() - Logout user
update() - Update profil user
giveAccess($id) - Memberikan akses/role ke user
deleteAccess($id) - Menghapus akses/role user

PostController

Controller untuk CRUD post.

store() - Membuat post baru
update() - Update post
destroy() - Hapus post

CommentController

Controller untuk CRUD komentar.

store() - Membuat komentar baru
destroy() - Hapus komentar

ReactionController

Controller untuk reaksi pada post/comment.

store() - Tambah reaksi
destroy() - Hapus reaksi

ReportController

Controller untuk laporan konten.

store() - Buat laporan konten
index() - List semua laporan (admin)

AppealController

Controller untuk appeal/banding laporan.

store() - Buat appeal
update() - Update status appeal (admin)

AdminController

Controller untuk fungsi admin.

dashboard() - Dashboard admin dengan statistik
manageUsers() - Kelola pengguna
manageReports() - Kelola laporan
manageAppeals() - Kelola appeals

SettingController

Controller untuk pengaturan user.

changePassword() - Ubah password
updatePrivacy() - Update pengaturan privasi
updateNotification() - Update pengaturan notifikasi

ForgotPasswordController

Controller untuk reset password.

showLinkRequestForm() - Tampil form input email
sendResetLinkEmail() - Kirim link reset ke email
resetPassword($token) - Tampil form buat password baru
resetPasswordAttempt() - Proses ubah password

VerificationController

Controller untuk verifikasi email.

notice() - Tampil halaman verifikasi email
verify($id, $hash) - Verifikasi email dengan link
resend() - Kirim ulang email verifikasi
changeEmail() - Ubah email

3. Jobs (Queue Jobs)

ProcessReportReward

Job untuk memproses reward/insentif ketika laporan konten diterima.

Menambah trust score reporter
Mengurangi trust score pembuat konten
Membuat log perubahan trust score
Trigger suspensi jika trust score terlalu rendah

4. Notifications (Email Notifications)

AppealsResult

Notifikasi hasil keputusan appeal.

Dikirim ketika admin memutuskan appeal
Berisi hasil dan alasan keputusan

GetSuspend

Notifikasi suspensi akun.

Dikirim ketika akun pengguna disuspensi
Berisi alasan dan durasi suspensi

QueuedResetPassword

Notifikasi reset password.

Dikirim link reset password ke email pengguna
Berisi token dan instruksi

QueuedVerifyEmail

Notifikasi verifikasi email.

Dikirim link verifikasi email ke email pengguna baru
Berisi token verifikasi

ReactionNotification

Notifikasi reaksi pada post/comment.

Dikirim ketika ada reaksi terhadap post/comment user
Berisi info siapa yang bereaksi dan konten apa

5. Middleware

auth.alert

Middleware custom untuk proteksi route yang memerlukan autentikasi.

Cek apakah user sudah login
Cek apakah email user sudah verified
Cek apakah akun user suspended

6. Routes (Web Routes)

Public Routes (Tanpa Autentikasi)

GET  /                          - Halaman beranda
GET  /login                     - Form login
GET  /register                  - Form register
POST /login                     - Attempt login
POST /register                  - Attempt register
GET  /forgotPassword            - Form forgot password
POST /forgotPassword            - Send reset link
GET  /reset-password/{token}    - Form reset password
POST /reset-password            - Update password
GET  /search                    - Pencarian post
GET  /newest                    - Post terbaru
GET  /post/detail/{id}          - Detail post
GET  /user/profile/{username}   - Profil pengguna
GET  /tags                      - List tags
GET  /tags/{slug}               - Post dengan tag
GET  /auth/google               - Google OAuth
GET  /auth/google/callback      - Google callback

Protected Routes (Memerlukan Autentikasi)

GET  /saved                     - Post tersimpan
GET  /post/add                  - Form tambah post
GET  /post/edit/{id}            - Form edit post
POST /post/save                 - Simpan post
POST /post/update               - Update post
POST /post/delete               - Hapus post

GET  /user/edit                 - Form edit profil
POST /profile/update            - Update profil
POST /give-access/{id}          - Berikan akses
POST /delete-access/{id}        - Hapus akses

POST /comment/save              - Tambah komentar
POST /comment/delete            - Hapus komentar

GET  /dashboard                 - Dashboard user

GET  /settings                  - Pengaturan
POST /settings/changePassword   - Ubah password

GET  /inbox                     - Notifikasi
GET  /inbox/{id}                - Detail notifikasi

GET  /email/verify              - Halaman verifikasi
GET  /email/verify/{id}/{hash}  - Verifikasi email
POST /email/verify/resend       - Kirim ulang verifikasi
POST /email/verify/change       - Ubah email

Admin Routes

GET  /admin/dashboard           - Dashboard admin
GET  /admin/users               - Kelola pengguna
GET  /admin/reports             - Kelola laporan
GET  /admin/appeals             - Kelola appeals
POST /admin/reports/{id}/accept - Terima laporan
POST /admin/reports/{id}/reject - Tolak laporan

7. Database Features

Migrations

create_sessions_table - Sesi pengguna
create_users_table - Data pengguna
create_user_details_table - Detail profil
create_posts_table - Post/diskusi
create_comments_table - Komentar
create_tags_table - Tag/kategori
create_post_tags_table - Relasi post-tag
create_reactions_table - Reaksi
create_reports_table - Laporan konten
create_appeals_table - Appeal laporan
create_saved_table - Post tersimpan
create_user_settings_table - Pengaturan user
create_trust_score_logs_table - Log trust score
create_remember_mes_table - Remember me tokens

Factories

UserFactory - Generate dummy user untuk testing

Seeders

CommentSeeder - Seed komentar dummy

8. Configuration Files

config/app.php

Konfigurasi aplikasi Laravel (timezone, locale, dll)

config/auth.php

Konfigurasi authentication guards dan providers

config/database.php

Konfigurasi koneksi database

config/filesystems.php

Konfigurasi storage disk untuk upload file

config/mail.php

Konfigurasi email driver (SMTP, Mailgun, dll)

config/queue.php

Konfigurasi queue driver untuk background jobs

config/session.php

Konfigurasi session lifetime dan behavior

config/permission.php

Konfigurasi Spatie Permission (role & permission)

config/services.php

Konfigurasi third-party services (Google, dll)

🚀 Environment Variables

Buat file .env dengan variabel berikut:

APP_NAME=Discussion
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost:8000

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=discussion
DB_USERNAME=root
DB_PASSWORD=

MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=587
MAIL_USERNAME=your_username
MAIL_PASSWORD=your_password
MAIL_FROM_ADDRESS=noreply@discussion.local
MAIL_FROM_NAME=Discussion

GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_REDIRECT_URI=http://localhost:8000/auth/google/callback

QUEUE_CONNECTION=database
SESSION_DRIVER=cookie

🧪 Testing

Jalankan test dengan Pest PHP:

# Jalankan semua test
php artisan pest

# Jalankan test spesifik
php artisan pest tests/Feature/AuthTest.php

# Jalankan dengan coverage
php artisan pest --coverage

# Format code dengan Pint
./vendor/bin/pint

⚙ Running Local

Buat Application Key terlebih dahulu

php artisan key:generate

Create DB dengan seed

php artisan migrate --seed

Jalankan npm

npm run dev

jalankan php serve

#Buka terminal baru
php artisan serve

jalankan queue untuk mailing

#Buka terminal baru
php artisan queue:listen

📝 Development Commands

# Tinker - Interactive shell
php artisan tinker

# Generate model dengan migration
php artisan make:model Post -m

# Generate controller
php artisan make:controller PostController --resource

# Publish vendor assets
php artisan vendor:publish

# Clear cache
php artisan cache:clear
php artisan config:clear
php artisan view:clear

# Queue listener untuk background jobs
php artisan queue:listen

🤝 Kontribusi

Fork repository ini
Buat branch fitur (git checkout -b feature/AmazingFeature)
Commit changes (git commit -m 'Add some AmazingFeature')
Push ke branch (git push origin feature/AmazingFeature)
Buat Pull Request

👨‍💻 Author

Created with ❤️ for Discussion Platform

Name		Name	Last commit message	Last commit date
app		app
bootstrap		bootstrap
config		config
database		database
public		public
resources		resources
routes		routes
storage		storage
tests		tests
.editorconfig		.editorconfig
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
README.md		README.md
artisan		artisan
composer.json		composer.json
composer.lock		composer.lock
package-lock.json		package-lock.json
package.json		package.json
phpunit.xml		phpunit.xml
vite.config.js		vite.config.js

Latest commit

History

Folders and files

Repository files navigation