# INVESA

INVESA adalah Aplikasi Stok dan Penjualan POS, yang dibangun dengan basis [flightphp/core](https://github.com/flightphp/core) dan [siaupheng/webapp](https://git.trifonia.cloud/siaupheng/webapp).

Ini adalah versi fork yang telah disesuaikan dengan kebutuhan dari Toko Cahaya Masa - Mempawah.

## Instalasi

Aplikasi ini membutuhkan nginx sebagai proxy web server dan PHP versi 8.3 (keatas).

```bash
git clone https://git.trifonia.cloud/CMASA-MEMPAWAH/cmasa.git
```

Setelah berhasil clone, pastikan `app/config/app.php` dan `.env` telah disalin dan disesuaikan sesuai kebutuhan.

## Menjalankan Aplikasi

### Tanpa perlu install aplikasi tambahan

Untuk menjalankan aplikasi dalam bentuk pengembangan (development), anda bisa jalankan perintah

```bash
cd cmasa
composer start
```

Setelah itu, buka `http://localhost:8000` di browser anda.

__Catatan: Jika anda menemukan pesan error seperti `Failed to listen on localhost:8000 (reason: Address already in use)` maka anda dapat mengubah port aplikasi untuk dijalankan di port berbeda. Anda dapat mengubah pada file `composer.json` di bagian port bagian `scripts.start` ini.__

### Instalasi dengan Docker

Anda dapat [install Docker](https://docs.docker.com/engine/install/) dan gunakan `docker-compose` untuk menjalankan aplikasi dengan `docker`, jadi anda jalankan perintah berikut :
```bash
cd cmasa
docker-compose up -d
# or if a newer version of docker
docker compose up -d
```
Setelah itu, buka `http://localhost:8000` di browser anda.

## Struktur Project

Project ini dibuat dengan struktur yang mempermudah untuk maintenance dan dibaca oleh AI. berikut adalah struktur nya :

```
cmasa/
│
├── app/                # Folder utama aplikasi (BE)
│   ├── Controllers/    # Route controllers
│   ├── Middlewares/    # Custom middleware classes/functions
│   ├── Scripts/        # Script JS for every Controllers
│   ├── Styles/         # Extra CSS Styles
│   ├── Utils/          # Utility/helper functions
│   ├── views/          # View templates
│   ├── config/         # Configuration files (database, app settings, routes)
│   └── commands/       # Custom CLI commands for Runway
│
├── public/             # Web root (index.php, assets, etc.) (FE)
│
├── vendor/             # Composer dependencies
│
├── temp/               # Cache, Session, Error Logs
│
├── composer.json       # Composer config
│
└── README.md           # Project overview
```