Master Data Management System

📖 About This Project

Master Data Management System เป็นระบบจัดการข้อมูลหลัก (Master Data) สำหรับองค์กร พัฒนาด้วย Laravel Framework เพื่อจัดการข้อมูลพื้นฐาน เช่น รูปทรง (Shape), สี (Color), และข้อมูลอื่นๆ ที่เกี่ยวข้อง
รองรับหลายภาษา (Multi-language) และ ธีม Dark Mode เพื่อประสบการณ์ผู้ใช้ที่ดียิ่งขึ้น

✨ Key Features

• 🎨 Modern UI/UX - TailwindCSS + Alpine.js
• 🌗 Dark Mode - สลับธีมได้ทันที
• 🌐 Multi-language - รองรับภาษาไทย/อังกฤษ เปลี่ยนภาษาได้ทันที
• 📊 CRUD Operations - จัดการข้อมูลครบวงจร
• 🔍 Advanced Search & Filter - ค้นหาและกรองข้อมูล
• ✅ Real-time Validation - ตรวจสอบข้อมูลทันที
• 📱 Responsive Design - รองรับทุกอุปกรณ์
• 🔐 User Authentication & Authorization - ระบบผู้ใช้และสิทธิ์
• 📈 Data Relationships - จัดการข้อมูลสัมพันธ์
• 📤 File Import System - นำเข้าข้อมูลจาก Excel/CSV

🛠️ Technology Stack

Backend:

• Laravel 10.x
• MySQL 8.0+
• Eloquent ORM
• Maatwebsite/Laravel-Excel (Import/Export)

Frontend:

• TailwindCSS
• Alpine.js
• Select2
• Blade Templates

Additional:

• Laragon
• Composer
• NPM/Node.js

🚀 Installation

Prerequisites

• PHP 8.1.10+
• Composer
• Node.js & NPM
• MySQL 8.0+
• Laragon (แนะนำสำหรับ Windows)

Setup Instructions

1. Clone Repository

   git clone https://github.com/Decode357/Project_Master_Database.git
   cd MasterDataDemo

2. Install Dependencies

   composer install
   npm install

3. Environment Configuration

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

4. Database Setup

   • ตั้งค่า DB ใน .env
   • รัน migration และ seed

   php artisan migrate
   php artisan db:seed

5. Build Assets

   npm run dev   # สำหรับพัฒนา
   npm run build # สำหรับ production

6. Start Development Server

   php artisan serve

📤 File Import System

ระบบรองรับการนำเข้าข้อมูลจากไฟล์ Excel (.xlsx, .xls) และ CSV เพื่อเพิ่มข้อมูลจำนวนมากพร้อมกัน

📋 Features

• ✅ รองรับหลายรูปแบบไฟล์: Excel (.xlsx, .xls) และ CSV
• ✅ Validation แบบ Real-time: ตรวจสอบความถูกต้องของข้อมูลก่อนนำเข้า
• ✅ Error Handling: แจ้งเตือนข้อผิดพลาดพร้อมรายละเอียด
• ✅ Bulk Import: นำเข้าข้อมูลจำนวนมากได้ในครั้งเดียว
• ✅ Template Download: ดาวน์โหลดไฟล์ตัวอย่างสำหรับนำเข้า

🔧 การติดตั้งเพิ่มเติมสำหรับ Import System

# ติดตั้ง Laravel Excel Package
composer require maatwebsite/excel

🌐 Multi-language & Dark Mode

เปลี่ยนภาษา

• กดปุ่มเปลี่ยนภาษา (มุมขวาบน) เพื่อสลับระหว่างภาษาไทย/อังกฤษ
• ข้อความทุกส่วนในระบบจะเปลี่ยนตามภาษา
• เพิ่มไฟล์ภาษาใหม่ได้ที่ resources/lang/{locale}/ และใช้ __('...') ใน Blade

Dark Mode

• กดปุ่มสลับธีม (🌗) เพื่อเปลี่ยนระหว่างโหมดสว่าง/มืด
• ระบบจะจำค่าธีมที่เลือกไว้ (localStorage)

📁 Project Structure

MasterDataDemo/
├── app/
│   ├── Http/Controllers/     # Controllers
│   ├── Models/              # Eloquent Models
│   ├── Imports/             # Import Classes
│   └── Providers/           # Service Providers
├── database/
│   ├── migrations/          # Database Migrations
│   ├── seeders/            # Database Seeders
│   └── factories/          # Model Factories
├── resources/
│   ├── views/              # Blade Templates
│   ├── css/                # Stylesheets
│   └── js/                 # JavaScript Files
├── routes/
│   ├── web.php             # Web Routes
│   └── api.php             # API Routes
├── storage/
│   └── app/
│       └── imports/        # Temporary Import Files
└── public/                 # Public Assets
    └── templates/          # Import Templates

🎯 Usage

🔧 Configuration

Environment Variables

APP_NAME="Master Data Demo"
APP_ENV=local
APP_KEY=base64:...
APP_DEBUG=true
APP_URL=http://localhost

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

# File Upload Configuration
FILESYSTEM_DISK=local
MAX_UPLOAD_SIZE=2048 

👥 Team

• Developer: Decode357
• Project Type: Master Data Management System
• Framework: Laravel 10.x

---