Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chlnlto/first-balfour-asset-management-system
PHP Laravel Filament-Driven Asset Management System
https://github.com/chlnlto/first-balfour-asset-management-system
alpinejs blade filamentphp heroicons laravel livewire mysql php tailwindcss xampp
Last synced: 5 days ago
JSON representation
PHP Laravel Filament-Driven Asset Management System
- Host: GitHub
- URL: https://github.com/chlnlto/first-balfour-asset-management-system
- Owner: CHlNlTO
- Created: 2024-07-18T13:46:42.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-09-16T15:56:55.000Z (3 months ago)
- Last Synced: 2024-10-31T05:05:08.017Z (about 2 months ago)
- Topics: alpinejs, blade, filamentphp, heroicons, laravel, livewire, mysql, php, tailwindcss, xampp
- Language: PHP
- Homepage:
- Size: 948 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## About the Project
The **Asset Management System** is a web application developed for **First Balfour, Inc.**, a leading engineering and construction company based in the Philippines. This system is designed to efficiently manage the company's assets, track their status, and ensure seamless operational workflows.
## Features
- **Simple, Fast Routing Engine**: Utilizes Laravel's robust routing capabilities.
- **Elegant ORM**: Built with Eloquent for intuitive database interactions.
- **Real-time Updates**: Incorporates real-time asset status updates using Alpine.js.
- **Responsive Design**: Styled with Tailwind CSS for a modern, responsive interface.
- **Secure Authentication**: Implements Laravel's authentication for secure access.
- **Comprehensive Asset Tracking**: Detailed views and management of assets.
## Technologies Used
- **PHP 8.2.12**
- **Laravel 11.12.0**
- **Filament 3.2.57**
- **Tailwind CSS**
- **Alpine.js**
- **MySQL Database**
- **XAMPP**
- **Heroicons**
## Getting Started
### Prerequisites
- **PHP 8.2.12** or higher
- **Composer**
- **Node.js** and **npm**
- **XAMPP** (for local development)
- **MySQL Database**
### Installation
1. **Clone the repository:**
```bash
git clone https://github.com/clarkwayneabutal/first-balfour-asset-management-system.git
cd first-balfour-asset-management-system
```
2. **Install dependencies:**
```bash
composer install
npm install
npm run dev
```
3. **Set up environment variables:**
Copy the `.env.example` file to `.env` and configure your database and other settings.
```bash
cp .env.example .env
php artisan key:generate
```
4. **Run migrations:**
```bash
php artisan migrate --seed
```
5. **Serve the application:**
```bash
php artisan serve
```
## Usage
- **Dashboard**: Access the dashboard to view a summary of assets.
- **Assets Management**: Add, edit, delete, and view assets with ease.
- **User Authentication**: Secure login and registration for users.
- **Real-time Updates**: Get real-time updates on asset statuses.
## Development
### File Structure
```
├── app
│ ├── Console
│ ├── Exceptions
│ ├── Http
│ ├── Models
│ ├── Providers
│ └── ...
├── bootstrap
├── config
├── database
│ ├── factories
│ ├── migrations
│ └── seeders
├── public
├── resources
│ ├── css
│ ├── js
│ ├── views
│ └── ...
├── routes
│ └── web.php
├── storage
├── tests
└── ...
```
## Contact
**Clark Wayne Abutal**
4th Year Student Web Developer
[LinkedIn](https://www.linkedin.com/in/clark-wayne-abutal-1005001aa/) | Email: [email protected]
**First Balfour, Inc.**
First Balfour Building, 106 Valero St., Salcedo Village, Makati City, Philippines
[Website](https://www.firstbalfour.com)
## License
This project is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).