Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eureka2/G6K
Generator of calculation simulator (calculator)
https://github.com/eureka2/G6K
calculator engine generators javascript php simulation simulator symfony
Last synced: 4 months ago
JSON representation
Generator of calculation simulator (calculator)
- Host: GitHub
- URL: https://github.com/eureka2/G6K
- Owner: eureka2
- License: mit
- Created: 2015-01-29T20:33:02.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2024-02-20T08:46:04.000Z (10 months ago)
- Last Synced: 2024-04-29T17:07:53.409Z (8 months ago)
- Topics: calculator, engine, generators, javascript, php, simulation, simulator, symfony
- Language: JavaScript
- Homepage:
- Size: 36.7 MB
- Stars: 20
- Watchers: 6
- Forks: 19
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# G6K
[](LICENSE)
[](https://insight.symfony.com/projects/c84bb3b7-3ba8-4513-821b-bbcd35364fdb)
[](https://packagist.org/packages/eureka2/g6k)
G6K is a tool that enables the creation and online publishing of calculation simulators without coding. It has a simulation engine and an administration module.
A calculation simulator is an online service made available to a user to enable them to calculate the results (taxes, social benefits, etc.) corresponding to their particular situation. The results are calculated on the basis of data supplied by the user, reference data (eg amount of a tax) and business rules reflecting the current legislation in the field of simulation.
[Learn more](http://eureka2.github.io/g6k/documentation/en/learn-more.html)
## Table of contents
1. [Prerequisites for Symfony](#prerequisites-for-symfony)
1. [Prerequisites for G6K](#prerequisites-for-g6k)
1. [Installation](#installation)
1. [Web server configuration](#web-server-configuration)
1. [Migration](#migration)
1. [Documentation](#documentation)
1. [Code quality](#code-quality)
1. [Innovation Award](#innovation-award)
1. [Copyright and license](#copyright-and-license)
## Prerequisites for Symfony
* PHP Version 7.1.3+
* JSON enabled
* ctype
* date.timezone in php.ini
* auto_detect_line_endings = On in php.ini
* PHP-XML module
* 2.6.21+ version of libxml
* PHP tokenizer
* Modules mbstring, iconv, POSIX (only on * nix), Intl with ICU 4+, and APCU 3.0.17+ APC (highly recommended) must be installed
* recommended php.ini settings:
* short_open_tag = Off
* magic_quotes_gpc = Off
* register_globals = Off
* session.auto_start = Off
## Prerequisites for G6K
* PDO enabled
* pdo_pgsql and/or pdo_sqlite and/or pdo_mysql activated
* pgsql and/or sqlite3 activated
* SimpleXML enabled
* serialize_precision = -1 in php.ini
* intl installed and activated
## Installation
1. If you plan to use MySQL or PostgreSQL, create a user with "CREATE DATABASE" and "CREATE TABLE" privileges using the administration tool of your RDBMS.
2. Be placed in the Web Server
3. Download composer.phar (https://getcomposer.org/download/) in . composer 1.7.2+ is required.
4. Under a shell or DOS, execute: ``php -d memory_limit=-1 composer.phar create-project eureka2/g6k simulator/ 4.*``
5. Enter the parameter values required by the installer, including:
* application environment [dev or prod] (prod) :
* debug mode [0 or 1] (0) :
* locale [en-GB, en-US, fr-FR, ...] (en-US) :
* upload directory (%kernel.project_dir%/var/uploads) :
* mailer URL (null://localhost) :
* database engine [sqlite, mysql or pgsql] (sqlite) :
* database name (g6k) :
for sqlite database only:
* database version (3.15) :
* database path (%kernel.project_dir%/var/data/databases/g6k.db) :
for mysql or pgsql database:
* database host [localhost, ...] :
* database port :
* database user :
* database password :
* database character set [UTF8, LATIN1, ...] (UTF8) :
## Web server configuration
### Adding Rewrite Rules
G6K comes with a `.htaccess` file in the `calcul/` directory that contains the rewrite rules.
`/admin/...` is rewritten in `/admin.php/...` and all other queries in `/index.php/...`.
Thus, the `admin.php` and` index.php` front-end controllers can be omitted from the request urls.
### Apache
You must add the `AllowOverride All` directive in the `VirtualHost` block of the server configuration.
Assuming G6K is installed in the directory `/var/www/html/simulator` :
```
ServerName domain.tld
ServerAlias www.domain.tld
DocumentRoot /var/www/html/simulator
AllowOverride All
Order Allow,Deny
Allow from All
# other directives
```
For best performance, rewrite rules can be moved from the `.htaccess` file to the `VirtualHost` block of the server configuration.
In this case, change `AllowOverride All` to `AllowOverride None` and delete the `.htaccess` file.
```
ServerName domain.tld
ServerAlias www.domain.tld
DocumentRoot /var/www/html/simulator
AllowOverride None
Order Allow,Deny
Allow from All
# rewrite rules from .htaccess
# other directives
```
For security reasons, the can be set to the `calcul/` directory : `DocumentRoot /var/www/html/simulator/calcul`
In this case, `calcul/` should be omitted from the path of the request URL.
```
ServerName domain.tld
ServerAlias simulators.domain.tld
DocumentRoot /var/www/html/simulator/calcul
# rewrite rules from .htaccess
AllowOverride None
Order Allow,Deny
Allow from All
# other directives
```
### NGinx
Because NGinx does not have `.htaccess` files, all of the setup has to be managed within the server config file.
The following is fully working. There are probably a number of improvements which can be made, but this should be a good starting-point.
The most important point is that the `/admin` path has to be routed separately to the other app.
```
server {
rewrite ^/index\.php/?(.*)$ /$1 permanent;
## Admin ##
## Required for the admin area (this is in .htaccess inside /calcul) ##
location /admin {
rewrite ^(.*)$ /admin.php/$1 last;
}
## Main ##
location @rewriteapp {
rewrite ^(.*)$ /index.php/$1 last;
}
## Symfony ##
## PRODUCTION ENV ##
location ~ ^/(index|admin)\.php(/|$) {
fastcgi_pass unix:/var/run/php/php7.2-fpm.sock; #-> this needs to be your php-fpm location
fastcgi_split_path_info ^(.+\.php)(/.*)$;
include fastcgi_params;
internal;
}
# other directives
}
```
## Migration
If you want to transfer simulators, their data sources and style sheets from a previous installation,
do not copy them manually, use the following console command:
``php bin/console g6k:simulator:copy -w abDatepicker -w abListbox -w AutoMoneyFormat all /var/www/html/simulator-old``
assuming `/var/www/html/simulator-old` is the installation directory of the previous version.
This command performs all the necessary conversions to enable their use with this new version.
Note that in this command, the -w option sets widgets.
`abDatepicker`, `abListbox` and `AutoMoneyFormat` are widgets that will automatically apply to 'date', choice (select), and money fields, respectively.
You can omit those you do not want to use.
At the end of the copy, go to the administration interface to clear the development and production caches.
## Documentation
### Administrator's Guide
[ [en](http://eureka2.github.io/g6k/documentation/en/index.html) ]
[ [fr](http://eureka2.github.io/g6k/documentation/fr/index.html) ]
### Classes
[Documentation of G6K classes](http://eureka2.github.io/g6k/documentation/classes/4.x)
## Code quality
[](https://insight.symfony.com/projects/c84bb3b7-3ba8-4513-821b-bbcd35364fdb)
## Innovation Award
G6K
By eureka2
April 2018 Number 6
There are many sites that are useful because they provide means to let the users perform calculations of some kind from simple values entered in Web forms.
This package provides a Web interface to implement a generic system for designing and providing access to pages that provide several types of calculator tools.
Manuel Lemos
## Copyright and license
© 2015-2019 Eureka2 - Jacques Archimède. Code released under the [MIT license](https://github.com/eureka2/G6K/blob/master/LICENSE).
**[↑ back to table of contents](#table-of-contents)**