Frequently Encountered Issues (FEI)
General Issues
When I book appointment creating the workflow returns 401, Where should I start my debug?
Whenever you create an appointment and the create workflow request returns a 401, This means you have mismatch within your workflow .env and api .env. Below is the table to get you started on your debugging:
___________________________________________________________________________________________________
| Workflow .env | API .env |
---------------------------------------------------------------------------------------------------
| APP_URL | WORKFLOWAPP_URL |
---------------------------------------------------------------------------------------------------
| ALETHIAN_API_URL | APP_UR |
---------------------------------------------------------------------------------------------------
| WORKFLOW_JWT_CERT_PASSPHRASE | WORKFLOW_JWT_CERT_PRIV_KEY_PASSPHRASE |
---------------------------------------------------------------------------------------------------
| WORKFLOW_JWT_CERT_PRIV_KEY_PATH | WORKFLOW_JWT_CERT_PRIV_KEY_PATH |
---------------------------------------------------------------------------------------------------
| WORKFLOW_JWT_CERT_PUB_KEY_PATH | WORKFLOW_JWT_CERT_PUB_KEY_PATH |
---------------------------------------------------------------------------------------------------
When I book appointment creating workflow works, but redirection returns an error, Where should I start my debug?
We use SSO setup between the WebApp and Workflow app to ensure authenticated user goes direct to the Workflow without further auth. When there is a mismatch of the .env below, there should be possible issue
To ensure when user click on prepare for appointment from webapp work as expected as well as redirection after booking an appointment, ensure the following .env match
___________________________________________________________________________________________________
| Workflow .env | API .env |
---------------------------------------------------------------------------------------------------
| WORKFLOW_SSO_JWT_KEY | WORKFLOW_SSO_JWT_KEY |
---------------------------------------------------------------------------------------------------
App Environment Variables
I'm not sure my Workflow App .env is correct, what?
Here is the Workflow full .env, kindly update as required to match your local environment
APP_NAME="Alethian Workflow"
APP_ENV=local
APP_KEY=base64:vox8hfJtZ8zVRmLn8v3gsnK/Z3SgY70L7vCvWdSkkw0=
APP_DEBUG=true
LOCAL_DEV_MACHINE=true
APP_URL=http://workflow.bookadoc.test
MIX_API_BASE_URL="${ALETHIAN_API_URL}/api/v1/"
BOOKADOC_SITE_URL=http://dev.bookadoc.test
ALETHIAN_API_URL=http://dev-api.bookadoc.test
APP_VERSION_MAJOR=1
APP_VERSION_MINOR=0
APP_VERSION_PATCH=0
APP_VERSION="${APP_VERSION_MAJOR}.${APP_VERSION_MINOR}.${APP_VERSION_PATCH}"
USEFULPDF_TEAM_ID=1
LOG_CHANNEL=stack
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug
# This should use exact same details with marketing site
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=workflow
DB_USERNAME=root
DB_PASSWORD=
DB_DATABASE_BOOKADOC=alethian
BROADCAST_DRIVER=log
CACHE_DRIVER=file
FILESYSTEM_DRIVER=local
QUEUE_CONNECTION=sync
SESSION_DRIVER=database
SESSION_LIFETIME=120
MEMCACHED_HOST=127.0.0.1
REDIS_QUEUE=workflows
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=4ABJVZXkAzCaEOsLa4=
REDIS_PORT=6379
REDIS_URL=redis://4ABJVZXkmAZTNYkAfMzFIJkJ1yrM3VHAlAzCaEOsLa4=@127.0.0.1:6379
MAIL_FROM_ADDRESS="no-reply@bookadoc.com"
MAIL_FROM_NAME="${APP_NAME}"
MAIL_MAILER=azure
AZURE_MAIL_RESOURCE_NAME=
AZURE_MAIL_KEY=
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=thin-templates
AWS_USE_PATH_STYLE_ENDPOINT=false
AZURE_STORAGE_USE_API_PROXY=true
AZURE_STORAGE_ACCOUNT_NAME=cs4100320032174e80e
AZURE_STORAGE_CONTAINER_NAME=workflow
AZURE_STORAGE_ACCOUNT_KEY=
AZURE_STORAGE_BLOB_ENDPOINT=https://cs4100320032174e80e.blob.core.windows.net/
AZURE_STORAGE_CONNECTION_STRING=
PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=
PUSHER_APP_CLUSTER=mt1
MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
CASHIER_CURRENCY=USD
CASHIER_CURRENCY_LOCALE=en
LOG_ERROR_TO_SLACK=false
LOG_SLACK_WEBHOOK_URL=
MIX_WORKFLOW_BASE_URL="${APP_URL}"
MIX_BOOKADOC_SITE_URL="${BOOKADOC_SITE_URL}"
STRIPE_SK=sk_test_51P8OvFDa9N5JivON5CkmkAiFTJSTSk0jeXdi8TNRCKt7H66xsPP9V3P8aKZdYZiFk7BiYutsTxAKzZh02pgmKE2X00MhkBlTDi
STRIPE_PK=pk_test_51P8OvFDa9N5JivONV7Ab2FLTQwf2Tsm5mzIX8JvzMH9C695OrvtwTXkRsMYLTpH0SEOb1KsCfwiHaEuXgCIqG0Kz00KYcrXPpn
MIX_STRIPE_PK="${STRIPE_PK}"
WORKFLOW_SSO_JWT_KEY=
WORKFLOW_JWT_CERT_PASSPHRASE=
WORKFLOW_JWT_CERT_PRIV_KEY_PATH=alethian_private_key.pem
WORKFLOW_JWT_CERT_PUB_KEY_PATH=alethian_public_key.pem
#WORKFLOW_DEBUG_ALL_TO=new
HPI_CHAT_ENV=dev
MIX_HPI_CHAT_ENDPOINT=https://panacea-func-neg-v2-dev.azurewebsites.net/api/negotiate
MIX_HPI_CHAT_API_KEY=
MIX_HPI_CHAT_VERSION=v2
When I book appointment creating workflow works, but redirection returns an error, Where should I start my debug?
We use SSO setup between the WebApp and Workflow app to ensure authenticated user goes direct to the Workflow without further auth. When there is a mismatch of the .env below, there should be possible issue
To ensure when user click on prepare for appointment from webapp work as expected as well as redirection after booking an appointment, ensure the following .env match
___________________________________________________________________________________________________
| Workflow .env | API .env |
---------------------------------------------------------------------------------------------------
| WORKFLOW_SSO_JWT_KEY | WORKFLOW_SSO_JWT_KEY |
---------------------------------------------------------------------------------------------------