refined-unipass

Yet another Web App that simplifies the Unipass (Korean Customs Service) and adds useful features.

Live Demo

https://mooyoul.github.io/refined-unipass/

Screenshots

Quick Query	B/L Query

Compact Report	Detailed Report

Multiple Results	Error Dialog

Key Features

• Compact & Simple UI for mobile devices
• Quick cargo query without supplying "Arrival Year".
• WIP - Event Notifications via Telegram, PushBullet, and Slack.

API

Getting Started

You'll need to prepare below resources:

• Pre-configured AWS Credentials
• API Key for accessing Unipass API - Docs

$ git clone https://github.com/mooyoul/refined-unipass.git
$ cd refined-unipass
$ npm ci

Deploying your own API service

$ env \
    CARGO_CLEARANCE_PROGRESS_API_KEY=YOUR_API_KEY \
    CORS_ALLOWED_ORIGINS='https://mooyoul.github.io http://www.lvh.me:8080' \
    CORS_MAX_AGE='3600' \
    npm run deploy:prod

(Optional) Deploying CDN

$ cd infra
$ npm ci
$ env \
    CDK_DEFAULT_REGION=us-east-1 \
    CDK_DEFAULT_ACCOUNT=YOUR_AWS_ACCOUNT_ID \
    CDN_DOMAIN_NAME=refined-unipass.example.com \
    CDN_ZONE_NAME=example.com \
    API_DOMAIN_NAME=xxxx.execute-api.region.amazonaws.com \
    API_PATH=/stage \
    npm run cdk -- deploy

Testing

Test Suites are not available at this moment.

Web Client

Getting Started

$ cd client
$ npm ci

Running web client locally

$ cd client
$ npm run dev

then, Navigate to http://www.lvh.me:8080.

Testing

Test Suites are not available at this moment.

Related

• node-unipass Node.js Library for accessing Unipass API.

License

MIT

See full license on mooyoul.mit-license.org