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:
- Composer;
- Symfony-cli tool;
- docker and docker-compose
- node > 20 and yarn 1.22
First initialization
- clone this repository and move to the cloned directory:
git clone https://gitlab.com/Chill-Projet/chill-bundles.git
cd chill-bundles
- install depencies using composer
composer install
- 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.
- 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".
-
start the stack using
docker compose up -d
, check the status of the start withdocker compose ps
-
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
-
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
- 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.