Farm manual management system

Project Summary

This project is a comprehensive LU farm manual management system built using Laravel and Soft UI Dashboard. It allows administrators to manage manuals by creating, editing, and deleting them. Additionally, it provides a subscription management system for readers, controlling which books they can access based on their subscription.

Features

• Manuals Management: Admins can create, edit, and delete manuals.
• Reader Subscription Management: Control which books readers can access based on their subscription.
• User Authentication: Register, login, and manage user profiles.
• Dashboard: A visually appealing dashboard with various UI components.
• Responsive Design: Built with Bootstrap 5 for a responsive and modern design.
• Docker Support: Easily set up and run the project using Docker.
• Asset Management: Use Laravel Mix and npm for managing and compiling assets.

Prerequisites

• Node.js and npm: Install Node.js and npm
• Composer: Install Composer
• Docker: Install Docker

Setup

Step 1: Clone the Repository

git clone https://github.com/hugostech/farm-manual.git
cd farm-manual

Step 2: Install Dependencies

composer install
npm install

Step 3: Configure Environment

Copy the .env.example file to .env and update the necessary configurations, mainly the database settings.

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

Step 4: Run Migrations and Seeders

php artisan migrate --seed

Step 5: Set Up Storage Link

php artisan storage:link

Step 6: Compile Assets

For development:

npm run dev

For production:

npm run prod

Step 7: Run the Application

Using Local Environment

php artisan serve

Using Docker

Build and run the Docker containers:

docker-compose up --build

References

• Laravel Documentation
• Soft UI Dashboard
• Docker Documentation
• npm Documentation