WartegAndriawanCom

This project was generated with Angular CLI version 17.2.0.

How To Run Development Mode ( first time )

• clone this repo
• npm install
• cp .env.example .env
• adjust the settings in .env file according to your device environment like what port your postgre db run , db name etc
• apply db migrations files ( generate / update table in db )
  • npm run knex migrate:latest
• apply db seeder ( insert db for default user , data , etc )
  • npm run knex seed:run
• if you are on linux os for running angular FE ( SSR ) dan server api dev mode you can run this
  • npm run start:all
  • or npm run start:all:no-reload ( if you dont want your browser auto refresh after changes in code is compiled , manually refresh browser )
• if you are on window os , you need to run 2 process
  • npm run serve:dev running api server.dev.ts
  • npm start running angular development mode

How To Production Mode

• in VPS
  • npm run build
  • pm2 start pm2.config.json

Development server

Run ng serve for a dev server. Navigate to http://localhost:4200/. The application will automatically reload if you change any of the source files.

Code scaffolding

Run ng generate component component-name to generate a new component. You can also use ng generate directive|pipe|service|class|guard|interface|enum|module.

Build

Run ng build to build the project. The build artifacts will be stored in the dist/ directory.

Running unit tests

Run ng test to execute the unit tests via Karma.

Running end-to-end tests

Run ng e2e to execute the end-to-end tests via a platform of your choice. To use this command, you need to first add a package that implements end-to-end testing capabilities.

Further help

To get more help on the Angular CLI use ng help or go check out the Angular CLI Overview and Command Reference page.

Knex

• Migration

  • Make migration

    • npm run knex migrate:make create_example_table

  • Applying migration ( update database )

    • npm run knex migrate:latest
    • npm run knex migrate:up

  • Rolling Back

    • npm run knex migrate:rollback -- --all
    • npm run knex migrate:rollback

• Seed

  • Make seed

    • npm run knex seed:make required_data

  • Applying seed ( insert data to database )

    • npm run knex seed:run
    • npm run knex seed:run -- --specific=seed-filename.ts --specific=another-seed-filename.ts

• Documentation

  • https://knexjs.org/guide/query-builder.html

ENV

• Generate Key ( example: secret key for security )
• openssl rand -base64 43

Note

• Icon list

• This document note was created when Angular was on version 17.2 & 18.0 ( optional for development )

  • Dirty Patch SSR from development mode: ng serve until angular team solve this in the future

• angular.json

  /**
  * angular.json
  * some library need to be excluded while compiling ( building ) for production
  */
  "externalDependencies": [
    "knex"
  ],

  /**
  * angular.json
  * some library not support ESM , only commonjs . 
  * this area will whitelist them but remember some library might be a problem for performance by doing so
  */
  "allowedCommonJsDependencies": [
    "dotenv","dotenv-expand"
  ]