No description
Find a file
2023-11-07 12:34:14 +01:00
.github Create FUNDING.yml 2021-02-13 23:53:36 +01:00
db/migrations Initial commit 2017-09-12 14:11:29 +02:00
debian Do not fail installation on systems without systemd 2019-02-26 09:08:08 +01:00
doc Renamed to ClientZone 2018-05-12 22:05:03 +02:00
i18n Namespace renamed to VendorZone 2018-06-27 11:53:46 +02:00
nbproject Namespace renamed to VendorZone 2018-06-27 11:53:46 +02:00
src Add Script that generate invoices from contracts 2019-03-01 09:38:33 +01:00
tests Update client.json 2018-12-11 22:26:05 +01:00
.gitignore ver up 2018-11-23 00:26:56 +01:00
bootstrap.sh Renamed to ClientZone 2018-05-12 22:05:03 +02:00
client.json Choose clinet using DataTables 2018-11-22 20:36:55 +01:00
codeception.yml Initial commit 2017-09-12 14:11:29 +02:00
composer.json Update composer.json 2023-11-07 12:34:14 +01:00
Dockerfile Try to make installable package & image 2018-10-10 17:22:06 +02:00
Makefile Choose clinet using DataTables 2018-11-22 20:36:55 +01:00
phinx-adapter.php Choose clinet using DataTables 2018-11-22 20:36:55 +01:00
phinx.yml Renamed to ClientZone 2018-05-12 22:05:03 +02:00
README.md Choose clinet using DataTables 2018-11-22 20:36:55 +01:00
Vagrantfile Initial commit 2017-09-12 14:11:29 +02:00
vendorzone.json Choose clinet using DataTables 2018-11-22 20:36:55 +01:00

FlexiBee VendorZone

VendorZone Logo

Adminská zóna vašeho FlexiBee. Aplikace taktéž umožňuje objednávání položek ceníku FlexiBee a následnou reakci na příchozí platbu

Administrátor označí v ceníku nabízené položky štítkem ESHOP a ACTIVE. Poté jsou tyto nabízeny k obejdnání:

Nabídka

Po volbě položky je možné vyplnit detaily:

Formulář

Objednané položky jsou schraňovány v košíku:

Potvrzení

Výsledkem je buď zálohová faktura, nebo objednávka ve FlexiBee:

Objednáno

Vlastnosti

Funkce automatizace

  • Příjmání WebHooků
  • Zpracování změn nepřijatých jako webhook
  • Mirror a Historie Evidencí FlexiBee do tabulky databáze
  • Mechanizmus modulů pro reakce na změny v položkách evidencí (faktura uhrazena)
  • Mechanizmus modulů pro reakce na položky zpracovávaných faktur
  • skript api/GetCustomerScore.php pro vracejcí zewl score klienta
  • ukládání parametrů objednaných položek do json přílohy faktury/objednávky
  • Párování faktur
  • Obesílání upomínek

Funkce pro Administrátora

  • Nastavení ChangesApi a webhooků na stránce flexibee.php
  • Zakládání a mazání operátorů

Funkce pro Operátora

  • Rozcestník často používaných aplikací
  • Vyhledávač v Adresách, Kontaktech a Ceníku
  • U adres je možné přepínat štítky
  • U položek ceníku je možné přepínat štítky a tím povolovat jejich zobrazení v nabídce zákazníkům
  • Nabízeným položkám je možné přiřadit obrázek a jeho náhled.
  • Zobrazení přehledu objednávek s možností je odeslat zákazníkovi mailem

Moduly pro zpracování změn evidencí

Načítají se ze složky VendorZone\whplugins např FakturaPrijata.php a jsou vždy potomky třídy \VendorZone\WebHookHandler

V modulu je možné předefinovat metody create() update() a delete() které se vykonávají při patřičné změně.

Moduly pro zpracování objednaných položek

Načítají se ze složky VendorZone\orderplugins např DomainOrg.php a jsou vždy potomky třídy \VendorZone\OrderPlugin

Plugin může mít předefinovány tyto metody:

  • formFields($form) - vykreslí formulář s položkami potřebnými pro objednání položky
  • controlFields($order) - zkontroluje hodnoty odeslané formulářem
  • processFields($order) - zpracuje hodnoty odeslané formulářem
  • settled() - vykonává se v případě že byla zaplacena faktura obsahující položku s kodem který ma plugin na starosti

Testovací adresa: [https://clientzonee.vitexsoftware.cz/]

Požadavky pro běh:

  • PHP 5 a vyšší s mysqli rozšířením
  • Ease framework
  • FlexiPeeHP
  • SQL Databáze s podporou PDO

Instalace

Pro instalaci je třeba:

  • přistupové údaje do mysql/postgres

  • databáze a přidané deb zdroje VitexSoftware

     wget -O - http://v.s.cz/info@vitexsoftware.cz.gpg.key|sudo apt-key add -
     echo deb http://v.s.cz/ stable main > /etc/apt/sources.list.d/ease.list
     apt update
     apt install clientzonee
    

Konfigurace:

Aplikace se snaží načíst konfigurační soubor z /etc/flexibee/clientzone.json Pokud jej nenajde tak jej hledá v kořenu webu ()

{                                                                                                                                          
    "EASE_APPNAME": "VendorZone",                                                                                                      
    "EASE_LOGGER": "syslog|console",                                                                                                       
    "SEND_MAILS_FROM": "shop@syourdomain.net",                                                                                                
    "EMAIL_FROM": "shop@yourdomain.net",                                                                                                                       
    "EASE_EMAILTO": "info@vitexsoftware.cz",                                                                    
    "SUPPRESS_EMAILS": "true",                                                                                                                              
    "SEND_INFO_TO": "office@yourdomain.net",                                                                                                                       
    "DB_HOST": "localhost",                                                                                                                             
    "DB_USERNAME": "clientzone",                                                                                                                            
    "DB_PASSWORD": "clientzone",                                                                                                                            
    "DB_DATABASE": "clientzone",                                                                                                                            
    "DB_PORT": "3306",                                                                                                                                  
    "DB_TYPE": "mysql",                                                                                                                                 
}
  • SUPPRESS_EMAILS - Neodesílají se Emaily klientům
  • EASE_EMAILTO - Komu se odesílají logy po vykonání skriptů
  • SEND_INFO_TO - Komu se posílá info o nových registracích a objednávkách

Adminská oprávnění pro uživatele: a:1:{s:5:"admin";s:4:"true";}

K jakému FlexiBee se VendorZone připojuje je specifikováno v souboru /etc/flexibee/client.json

{
    "FLEXIBEE_URL": "https://demo.flexibee.eu:5434",
    "FLEXIBEE_LOGIN": "winstorm",
    "FLEXIBEE_PASSWORD": "winstrom",
    "FLEXIBEE_COMPANY": "demo"
}

Informace pro vývojáře:

  • Aplikace je vyvíjena pod v NetBeans pod linuxem.
  • Dokumentace ApiGen se nalézá ve složce doc
  • Složka testing obsahuje testovací sady Selenium a PHPUnit a strukturu DB
  • Aktuální zdrojové kody: git@github.com:VitexSoftware/VendorZone.git

Instalace databáze

mysqladmin -u root -p create clientzone
mysql -u root -p -e "GRANT ALL PRIVILEGES ON clientzone.* TO 'clientzone'@'localhost' IDENTIFIED BY 'clientzone'"

su postgres
psql 
CREATE USER clientzone WITH PASSWORD 'clientzone';
CREATE DATABASE clientzone OWNER clientzone;
\q
vendor/bin/phinx migrate

© 2017 Vítězslav Dvořák / Vitex Software