Julien Fastré b92e60fa26
Rename header folder and update path in configuration
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.
2024-11-22 09:45:08 +01:00
2023-05-03 23:00:08 +02:00
2023-10-03 07:52:45 +00:00
2022-05-05 07:13:53 +02:00
2021-11-23 14:05:45 +01:00
2023-02-04 01:19:34 +01:00
2024-08-28 12:21:43 +02:00

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.

Description
Miroir de chill-bundles
Readme AGPL-3.0 58 MiB
Languages
PHP 77.3%
Twig 10.4%
Vue 7.4%
JavaScript 3.1%
TypeScript 1%
Other 0.8%