Elewant is a project based on the PHP mascotte: the ElePHPant.
The idea is that we make it easier in the community to swap and share these lovely plush pachyderms. For now, you can create a herd and enter all the members that you have. In the near future, it will be possible to put your surplus ElePHPants up for trade, and request specific ElePHPants that you want to add to your herd.
But this project is more. The idea is to allow people who are interested involved. Not just by open sourcing the code so it can be contributed to, but by actually building and running it together. From idea to production and beyond.
Well, the basics are pretty simple: we build, deploy and maintain a project together. This means that all the aspects of building and maintaining are areas of learning:
So some usual suspects:
- Behaviour driven development
- Automated testing
- Event sourcing
- The Symfony framework
But also:
- Automated Provisioning
- Deploying
- Build pipelines
- Logging and alerting
- Dependency management
And eventually:
- How to deal with legacy code ;-)
Feel free to add anything you learn, no matter how small, to <docs/lessons_learned.md>
You will need some tools on your local system:
[Virtual box](https://www.virtualbox.org/)
[Ansible](https://www.ansible.com/)
Add the following line to your hostsfile:
192.168.77.77 develop.elewant.loc
Fetch roles from Ansible Galaxy:
ansible-galaxy install -r ansible/galaxy_roles.yml -f
If you want to be able to log in with twitter, you'll need to create an application at app.twitter.com, then place your key & secret in a file called
ansible/provision/group_vars/develop/override_locally.yml.
Bring your box up:
vagrant up --provision
You should be up-and-running!
http://develop.elewant.loc/
For developers, there is a special button on the front page to generate users for your local environment. Just click on "Developer login" and you should be able to create (and log in as) randomly created users.
Have fun!
You can find more docs in the /docs folder, like:
- How to run the tests running_the_tests
- Adding functionality to the domain model
- A few handy notes for developers
- A neat list of things people learned working on the project