DeEmCee

This file may be edited to document any setup, deployment, and system information.

System Version

...to be added

Linux?

PHP 7.2.24?

MySQL 5.7.29?

Laravel 6.x

Composer

1. Run composer install

   deemcee$ composer install
   

Database

Migration

...to be added

Seeding

1. Regenerate Composer's autoloader

   deemcee$ composer dump-autoload
   

2. Run database seeders

   deemcee$ php artisan db:seed
   

3. (Optional) Run DPointAccumulation seeder individually

   deemcee$ php artisan db:seed --class=DPointAccumulationSeeder
   

4. (Optional) Run NotificationType seeder individually

   deemcee$ php artisan db:seed --class=NotificationTypeSeeder
   

Laratrust

...to be added

Passport

...to be added

Storage

Please setup the following storage location for system generated assets such as PDF files.

1. Link to public disk (https://laravel.com/docs/6.x/filesystem#the-public-disk)

   deemcee$ php artisan storage:link
   

2. Make a new invoice directory for storing PDF invoices.

   deemcee$ mkdir storage/app/public/invoice
   

3. Make a new upload directory for storing Generic File Upload files.

   deemcee$ mkdir storage/app/upload
   

4. Make a new evaluation directory for storing Evaluation Report document files.

   deemcee$ mkdir storage/app/public/evaluation
   

5. Make a new voucher directory for storing Voucher image files.

   deemcee$ mkdir storage/app/public/voucher
   

6. Make a new banner directory for storing Announcement banner image files.

   deemcee$ mkdir storage/app/public/banner
   

7. Make a new excel directory for storing DeEmcee Program Themes (deemcee-themes.xlsx) files.

   deemcee$ mkdir storage/app/public/excel
   

8. Make a new delivery-order directory for storing merchandise DO files.

   deemcee$ mkdir storage/app/public/delivery-order
   

9. Make a new certificate directory for storing certificates files.

   deemcee$ mkdir storage/app/public/certificate
   

Generic File Uploader

The following API End Point allows file upload capabilities:

POST {{url}}/uploads

Uploading a file

Use 'file' as the form-data key in request.

Successful upload will return the following response body:

{
    "file_path": "upload/my-image-abc.jpg"
}

Using the response file_path

The file_path value points to the file stored in /storage/app/upload/ directory. The file cannot be publicly accessed yet. It can be subsequently used in the following API End Points that accepts a file:

• Create Centre Evaluation Report

  • POST /reports/evaluation/{{branch_id}}
  • Key: "file_path"

• Create Redemption Voucher

  • POST {{url}}/dpoint/vouchers
  • Key: "image_path" (optional)

• Update Redemption Voucher

  • PUT {{url}}/dpoint/vouchers
  • Key: "image_path" (optional)

• Create Announcement

  • POST {{url}}/announcements
  • Key 1: "desktop_banner_url" (file_path value or valid URL)
  • Key 2: "mobile_banner_url" (file_path value or valid URL)

Upon successful request, the file will be copied to their respective public directories for public access in /storage/app/public/.

Payment Gateway (MOLPay / RAZER)

Documentation / Specifications

https://d2x73ruoixi2ei.cloudfront.net/pdf/%5Bofficial+API%5D+RazerMS+API+Spec+for+Merchant+%28v13.14%29.pdf

Config

Payment URL and keys are defined in:

• config/molpay.php

Please add the following to .env:

MOLPAY_MERCHANT_ID=SB_deshop
MOLPAY_VERIFYKEY=[Verify Key here]
MOLPAY_SECRETKEY=[Secret Key here]

(Obtain keys from RAZER MERCHANT SERVICES PORTAL)

Deployment

...to be added