chill-bundles/README.md
Julien Fastré 3e0731f06e
Create an symfony app's skeleton to ease the development
[WIP] first import of automated recipes

[WIP] fix configuration file to be able to compile kernel and serve route

[WIP] first build of assets

[WIP] Continue working on configuration to load a page

[WIP] Reset the bin directory

[WIP] remove default migrations files

[WIP] fix configuration for running tests

[WIP] Installation instructions

Fix the default firewall in test login

[WIP] fix cs

[WIP] update gitlab-ci

[WIP] update gitlab-ci

[WIP] update gitlab ci

[WIP] fix config for running tests

[WIP] fix gitlab ci

[WIP] try tests/bootstrap php file from symfony bridge instead of phpunit recipe

remove kernel.php file

fix loading of entrypoint.json in test

[wip] increase memory limit for phpstan in test/ci

[WIP]: set the correct timezone directly within the phpunit.xml.dist file

[WIP]: fix security configuration

WIP: fix config for testing
2024-11-22 09:45:05 +01:00

3.1 KiB

Main Chill Bundles and Chill framework

Chill is a software for social workers. It allows them to keep track of the social work they do.

See our website for more information https://www.chill.social

Installation

Chill-bundles is a set of bundles that should be used within a Symfony application.

A symfony application will help you to customize all the configuration options, change the behaviour of some parts of the usual-way that chill works, … without to have to fork this repository !

For a usage in production

You will create a symfony app, which will then download this bundle as a dependency.

See the documentation at https://docs.chill.social.

For development or testing purpose only

⚠️ Use this method for development only. ⚠️

You will need:

First initialization

  1. clone this repository and move to the cloned directory:
git clone https://gitlab.com/Chill-Projet/chill-bundles.git
cd chill-bundles
  1. install depencies using composer
composer install
  1. Install and compile assets:
yarn install
yarn run encore production

note double check that you have the node version > 20 using the node --version command.

  1. configure your project: create a .env.local file at the root, and add the admin password:
# for this installation mode, the environment should always be "dev"
APP_ENV=dev
ADMIN_PASSWORD=\$2y\$13\$iyvJLuT4YEa6iWXyQV4/N.hNHpNG8kXlYDkkt5MkYy4FXcSwYAwmm
# note: if you copy-paste the line above, the password will be "admin".
  1. start the stack using docker compose up -d, check the status of the start with docker compose ps

  2. configure all the needed third-party tools

    # the first start, it may last some seconds, you can check with docker compose ps
    # run migrations
    symfony console doctrine:migrations:migrate
    # setup messenger
    symfony console messenger:setup-transports
    # prepare some views
    symfony console chill:db:sync-views
    # generate jwt token, required for some api features (webdav access, ...)
    symfony console lexik:jwt:generate-keypair
    
  3. add some fixtures

This will truncate all the existing data of the database. But remember, we are in dev mode !

symfony console doctrine:fixtures:load
  1. launch symfony dev-server
symfony server:start -d

And visit the web page it suggest. You can login with user center a_social and password password, or login admin with the password you set.

Stopping the server

symfony server:stop

Restart the webserver for subsequent start

symfony server:start -d
# this will automatically starts the full docker compose services

Documentation

The online documentation can be read at https://docs.chill.social, or the docs directory.