📰 Bangla News Paper

Bangla News Paper is a high-performance, dynamic news portal designed for modern journalism. It features a comprehensive suite of tools for content management, multimedia storytelling, and interactive user engagement. Developed collaboratively with a focus on scalability, security, and SEO optimization.

---

🚀 Project Overview

This project delivers a seamless experience for both readers and administrators. It handles everything from real-time live updates and podcasts to complex advertisement scheduling and location-based news delivery.

🌟 Key Highlights

• Dynamic Content Delivery: Articles, multimedia galleries, and live updates.
• Interactive Engagement: Integrated polls, podcasts, and user profiles.
• Robust Administration: Full-featured backend for managing every aspect of the portal.
• Scalable Architecture: Built with Laravel 12 and Inertia.js (React) for a smooth SPA experience.

---

📚 Documentation

Detailed technical and product documentation is available in the following files:

Document	Description
📋 Requirements	Functional and Non-functional project requirements.
🏗️ Architecture	Technical stack and system design patterns.
🗺️ ER Diagram	Visual representation of database relationships.
🗄️ Database Schema	Detailed reference of all database tables.
🛤️ User Journey	Mapping of user paths (Reader, Admin, Editor).
🛠️ Developer Guide	Workflow and coding standards for developers.

---

🛠️ Features

📰 Content Management

• Dynamic Posts: Create and manage rich text articles with CKEditor support.
• Categorization: Multi-level categories and subcategories for organized navigation.
• Media Galleries: dedicated image albums and video galleries with lightbox support.
• Podcasts: Integrated audio content for modern news consumption.

🔧 Administrative Control

• User Management: Role-based access control (RBAC) using Spatie Permissions.
• Menu Builder: Fully dynamic menu management for the frontend.
• Ad Management: Schedule and manage advertisements across different site sections.
• SEO Tools: Built-in SEO management for every page and post.
• Live Updates: Real-time news ticker and live event coverage.

👤 User Experience

• Secure Authentication: Registration, login, and personalized user profiles.
• Location-Specific News: Filter news based on geographical locations.
• Search & Archive: Advanced search functionality and organized archives.
• Interactive Polls: Engaging poll system with live voting results.

---

💻 Tech Stack

Backend

Frontend

Key Libraries

---

⚙️ Installation & Setup

1. Clone the repository

git clone https://github.com/yourusername/newspaper.git
cd newspaper

2. Install Dependencies

composer install
npm install

3. Environment Configuration

Copy the example environment file and update your database credentials:

cp .env.example .env
php artisan key:generate

4. Database Setup

Run the migrations and seeders (if available):

php artisan migrate

5. Run the Application

# Terminal 1: Laravel Server
php artisan serve

# Terminal 2: Vite Dev Server
npm run dev

---

📄 Environment Variables

The following key environment variables are required for full functionality:

Variable	Description
DB_DATABASE	Name of your MySQL database
DB_USERNAME	Database user
DB_PASSWORD	Database password
APP_URL	Your application base URL
VITE_APP_URL	Vite dev server URL (usually port 8000/5173)

---

👥 Contribution

This project was developed by a team of 2 dedicated members.

Contributor	Role	Socials
Md Rafiul Islam	Full-stack Developer	GitHub / LinkedIn
Sakhawat Kabir Rasu	Full-stack Developer	GitHub / LinkedIn

---

License

Distributed under the MIT License. See LICENSE for more information.

---

Contact

Project Maintainer: Md Rafiul Islam
Project Link: https://github.com/Rafiul29/newspaper.git