Update docs

This commit is contained in:
Jannis Portmann 2022-01-18 20:25:49 +01:00
parent b8c6d41dc9
commit 774630ea14
2 changed files with 22 additions and 13 deletions

View file

@ -3,9 +3,9 @@
## Prerequisites ## Prerequisites
A good start is to follow this [intro](https://symfony.com/doc/current/the-fast-track/en/1-tools.html). A good start is to follow this [intro](https://symfony.com/doc/current/the-fast-track/en/1-tools.html).
In addition, you will need `yarn` and `npm`, as well as [`docker-compose`](https://docs.docker.com/compose/install/). In addition, you will need `yarn` and `npm`, as well as [`docker compose`](https://docs.docker.com/compose/install/).
For that, install [`node.js`](https://nodejs.org/) by downloading directly or using your package manager. For that, install [`node.js`](https://nodejs.org/) by downloading directly or using your package manager (if you're using Linux, you probably knpw how to install).
### MacOS ### MacOS
Using [homebrew](https://homebrew.sh): Using [homebrew](https://homebrew.sh):
@ -22,19 +22,19 @@ choco install nodejs npm yarn
## Setup the project ## Setup the project
### 1. Clone the repo ### 1. Clone the repo
Using SSH Using SSH ([set up your ssh-keys](https://git-scm.com/book/en/v2/Git-on-the-Server-Generating-Your-SSH-Public-Key) first or use https)
``` ```
git clone ssh://git@git.thisfro.ch:222/thisfro/plant-exchange.git git clone ssh://git@git.thisfro.ch:222/thisfro/pflaenz.li.git
``` ```
### 2. Go to the directory ### 2. Go to the directory
``` ```
cd plant-exchange cd pflaenz.li
``` ```
### 3. Setup Database and other stuff ### 3. Setup Database and other stuff
``` ```
docker-compose up -d docker compose up -d
``` ```
To create the database To create the database
``` ```
@ -61,17 +61,22 @@ symfony serve --port 8080 --no-tls -d
You sholud be able to access the site under [localhost:8080](http://localhost:8080) You sholud be able to access the site under [localhost:8080](http://localhost:8080)
You'll also need to build the webpack files (or use watch files):
```
yarn build
```
### 6. Create a user ### 6. Create a user
Register your own account and set the `role` in the databse to `["ROLE"ADMIN"]` Register your own account and set the `role` in the databse to `["ROLE_ADMIN"]`
### 7. Watch files ### 7. Watch files
If you are editing `.scss` or other webpack files, you'll want to run If you are editing `.scss` or `.js`, you'll want to run
``` ```
yarn watch yarn watch
``` ```
this will automatically rebuild webpack files on save.
--- ---
Thats it for now, you can start developing! Thats it for now, you can start developing! :tada:
If you have any questions, ask [thisfro](https://git.thisfro.ch/thisfro) or creat an issue! If you have any questions, ask [thisfro](https://git.thisfro.ch/thisfro) or create an issue!

View file

@ -7,12 +7,15 @@ A platform where people can exchange plants. They can post what they have and se
- [Symfony](https://symfony.com/) - [Symfony](https://symfony.com/)
- [MariaDB](https://www.mariadb.org) - [MariaDB](https://www.mariadb.org)
Deployment: TBD
## Admin dashboard ## Admin dashboard
Find it under `/admin` Find it under `/admin`
## Filters ## Filters
### Implemented
- Distance between postal codes
### Ideas
:warning: This list is work in progress! :warning: This list is work in progress!
Searching with filters such as: Searching with filters such as:
@ -22,4 +25,5 @@ Searching with filters such as:
| Name | `string` | textfield | | Name | `string` | textfield |
| Category | `Category` | dropdown | | Category | `Category` | dropdown |
Distance from entered ZIP to the offer ZIP. ## Development
To get started with development, see [DEVELOPMENT.md](DEVELOPMENT.md)