Renamed the folder 'resource' to 'resources' to better reflect its contents. Updated the file path in the PHP CS Fixer configuration accordingly to ensure continued functionality.
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.