## 1. How to install and run php-docker #### # cd $HOME #### # git clone http://git.daboryhost.com:10880/dabory/mybin #### # export PATH=$PATH:$HOME/mybin #### # mkdir -p $HOME/docker-works/php/ #### # cdphp #### # git clone http://git.daboryhost.com:10880/dabory/php-docker #### # cd php-docker #### Read reference manual to setup docker environment #### # git clone http://git.daboryhost.com:10880/dabory/dbrerp #### # cd dbrerp #### Read reference manual to setup dbrerp environment ## 2. How to Setup theme folder #### dbrerp has 2 different concept for controlling source code such as "standard" part and "theme" part. Many software solution providers have a big scourge of core solution part and customizing part to be jumbled as a spagetti syndrom. Problems related with this issue have been preventing smooth upgrade and raised update cost in software development. Dabory suggested a method to solve this problem by dividing code of "stardard" and "theme" as customized part. As dabory team build developed "double git update structure" by using .git and .gitignore functiionalities and proper folder structure. Also it have applied to User Pages( so-called Admin pages) and Pro Pages ( so-called Service Pages) in 2 different ways. #### (1) THEME folder $HOME/docker-works/php/{website-alias}/dbrerp/public/themes/ is theme forlder to be used customized part "{website-alise}" is can be "php-docker" or specific names as such as "newerp-php73" when developers maintain multiple websites in local PC. In webhosting server, /home/{website-alias}/public_html/public/themes/ As git structure, "themes" folder is excluded by adding folder name in .gitignore file. Under "themes" folder, it can have subfolder such as "pro" and "erp" As the subfolder, "pro" is for Pro Page for consists of Service Pages (or Home Page) excluding User Pages(Admin page). Also "erp" indicates folder for User Pages(or Admin Pages) This is why "themes" folder have a sub git structure under root git struture. we call root git as "parent git" and theme git as "child git" You can acquire folder name typing in cli : # cdpro {website-alise} example for local PC: $ cdpro newerp-php73 (will show) cd /Users/EricKim/docker-works/php/newerp-php73/dbrerp/public/themes/pro example for server : $ cdpro newerp (will show) cd /home/newerp/public_html/public/themes/pro example for local PC: $ cderp newerp-php73 (will show) cd /Users/EricKim/docker-works/php/newerp-php73/dbrerp/public/themes/erp example for server : $ cdpro newerp (will show) cd /home/newerp/public_html/public/themes/erp #### (2) How to install THEME folder http://git.daboryhost.com:10880/dbr-themes-pro There are dbr-themes-pro themes to be selected for theme, choose one of them and git clone the url link. cd {themes_folder/pro} #### # git clone http://git.daboryhost.com:10880/dbr-themes-pro/erponly As same way, http://git.daboryhost.com:10880/dbr-themes-erp There are dbr-themes-erp themes to be selected for theme, choose one of them and git clone the url link. #### # git clone http://git.daboryhost.com:10880/dbr-themes-erp/optical_pos !! Important difference between "pro" and "erp" is that: pro should be one, erp can be multiple because erp can have conbined features by business logic and workflows. #### (3) How to GIT sync STANDARD/THEME folder with git server simultanously example for local PC: cd $HOME/docker-works/php/ ( normally input cdphp) all-gitpp {website-alias} example for server : cd /home (normally input cdz) all-gitpp-host {website-alias} These shell scripts run git sync with standard folder and change directory to themes folder of "pro" and "erp" and run sync for both of pro and erp folder to reduce time for total updates. #### (4) How to sync THEME folder and .env file variables You can easily find ERP_THEMES, PRO_THEME variables in 2nd, 3th lines of .env file. You MUST syncronize the variable name and theme folder name as variable value. ## 3. How to start php-docker #### # cd $HOME/docker-works/php/php-docker #### # dkrmcu-remove-containers-and-compose-up 1) This will delete all docker containers and restart container in local PC. 2) You don't need to anything after update git in server. ## 4. How to stop php-docker (delete all docker containers) #### # cd $HOME/docker-works/php/php-docker #### # docker rm -f $(docker ps -a -q) . ## 4. Configuration #### .env Location : $HOME/.env (Laravel Env variable and Dabory variable combined) #### .env.dabory Location : $HOME/.env.dabory (Dabory API Connection and Token Keys) #### Note1 : There are divided concepts of ERP / PRO in dabory solution from the other web/app solutions. ERP is for backoffice pages for company or organization staffs and managers (Extension of Admin Page) PRO is for frontoffice pages for guest and customer member who are outside of company or organization (Extension of Service Page) #### Note2 : Dabory Media Library is inspired by Wordpress media library and extened for more wide range of use. #### Note3 : All of variables "Laravel" sub item can be referred in website below. https://laravel.com/docs/7.x/configuration ### Important !! : In development or web design stage, You should set .env as follows: 1. BROWSER_CACHE=false 2. CSSJS_URL=local This reduces website rendering speed, but changes in js script and css are fed to web pages in no time. ## .env Variable Description. | Type | Name | Usage | Applied | Remarks | |----------|-------------|-----------------------------|------|---------------------------------------------| | Dabory| ERP_PARA_CUSTOM_THEME| ERP theme | | erp 파라 커스텀할 때 사 | | Dabory| ERP_THEMES| ERP theme | | Can be multiple themes | | | PRO_THEME| PRO theme | | only one theme available for one site | | | LOCALE_SEQUENCE| Language and Local Sequence | | Separated by comma | | | APP_MOBILE_NO| Mobile No for Admin message | | | | | TAG_LINE| Page Tag for SEO | | | | | MEDIA_URL| File upload URL | | Local, Website and CDN such as S3 available | | | FAVICON_PATH| Pavicon File Path | | | | | IS_SKIP_DBUPDATE| Skip DB update | | | | | IS_ON_MEMBER_SIGNUP| | Yes| | | | FROALA_LICENSE_KEY| | | FROALA 라인센스 키 | | | SHIP_TRACK_API| | | 배송 추적 api키 | | | DEVICE_SCALE| | | ex)mobile>0;tablet>768;desktop>1024 | | | API23E_KEY_PAIR| | | api23e key pair | | | USER_LOGIN_ROUTE| | | 유저로그인 페이지 주소 커스텀 | | | ADMIN_EMAIL| | | 테스트 메일보낼 때 받을 메일 | | | CRM_SEARCH_SITE| | | crm search site 이동 주소 | | | CRM_CUSTOM| | | crm custom 확인 | | | CRM_KKSEARCH_URL| | | crm kksearch site 주소 | |SMS | SMS_TYPE| | | aligo | |SMS | SMS_APIKEY| | | sms api key | |SMS | SMS_USER| | | sms user | |SMS | SMS_SENDER| | | sms sender | | | BROWSER_CACHE| Browser Cache Available | | | | | CSSJS_URL| css, js asset url | | | | | VERSION_DATE| css, js 캐시 업데이트 | | | |Printer | REPORT_SERVER_URL| Shared Report Server| | Crystal Report suppored | |elastic | ELASTIC_HOST| | | | |elastic | ELASTIC_USER| | | | |elastic | ELASTIC_PASSWD| | | | |elastic | KIBANA_URL| | | | | Laravel| APP-xxx| Refer Laravel Manual site for more info | | https://laravel.com/docs/7.x/configuration | | | DB_CONNECTION| | Yes | Dabory Does Not use Eloquent ORM in Laravel | | | AWS_ACCESS_XXX | | | Dabory use S3 as media library | | | PUSHER_APP_ID| | No| | | | LOG_CHANNEL| | No| | | | MEMCACHED_HOST| | No| | | | SESSION_DRIVER| | No| | | | REDIS_HOST| | No| | | | MAIL_MAILER| | | Dabory use S3 as mailer in Laravel | | | PUSHER_APP_ID| | No| | | | MIX_PUSHER_APP_KEY| | No| |