https://github.com/kir-dev/pek-next
PéK like Profiles and Groups. The administration system for Schönherz Student Hostel and SVIE
https://github.com/kir-dev/pek-next
rails ruby
Last synced: 3 months ago
JSON representation
PéK like Profiles and Groups. The administration system for Schönherz Student Hostel and SVIE
- Host: GitHub
- URL: https://github.com/kir-dev/pek-next
- Owner: kir-dev
- Created: 2015-09-30T17:44:15.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2025-11-08T16:00:34.000Z (6 months ago)
- Last Synced: 2025-11-08T18:04:14.039Z (6 months ago)
- Topics: rails, ruby
- Language: Ruby
- Homepage: https://pek.sch.bme.hu
- Size: 25.1 MB
- Stars: 11
- Watchers: 5
- Forks: 7
- Open Issues: 91
-
Metadata Files:
- Readme: README.hu.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# PéK-Next
**A Schönherz Kollégium és a [SVIE](https://svie.hu/) nyilvántartó rendszere**
[](https://travis-ci.org/kir-dev/pek-next)
[](https://codeclimate.com/github/kir-dev/pek-next)
[](https://gemnasium.com/kir-dev/pek-next)
## Rendszerkövetelmények
- Ruby 2.5.7
- Postgresql 9.6
- Node (asset fordítás)
- Redis (választható)
vagy
- Docker
## Függőségek telepítése
### Debian alapú rendszerekhez
###### Csomagok
```bash
# A Redis választható
sudo apt install postgresql-9.6 libpq-dev nodejs redis-server
```
###### Ruby 2.5.7
[Asdf](https://asdf-vm.github.io/asdf/#/core-manage-asdf-vm) használata ajánlott [ruby pluginnel](https://github.com/asdf-vm/asdf-ruby) vagy [rbenv](https://github.com/rbenv/rbenv) önmagában. Telepítsd a Ruby 2.5.7-et, majd állítsd be a futtatni kívánt verziót. Az éppen aktív verziót a `ruby -v` paranccsal tudod lekérdezni.
### MacOS
###### Brew
A legegyszerűbb, ha telepítjük a [brew](https://brew.sh) csomagkezelőt, majd ezzel a további függőségeket.
```bash
# A Redis választható
brew install asdf postgresql@9.6 redis
brew services start postgresql@9.6
brew services start redis
```
###### Ruby 2.5.7 és Node
Add hozzá a [ruby](https://github.com/asdf-vm/asdf-ruby) és [node](https://github.com/asdf-vm/asdf-nodejs) bővítményeket az asdfhez. Telepítsd a Ruby 2.5.7-et, majd állítsd be a futtatni kívánt verziót. Az éppen aktív verziót a `ruby -v` paranccsal tudod ellenőrizni.
## Beállítás
###### Forráskód és függőségek
```bash
git clone https://github.com/kir-dev/pek-next.git
cd pek-next
gem install bundler
bundle install
```
###### Környezeti változók
A használni kívánt értékekkel töltsd fel a `.env` fájlt a `.env.example` alapján.
###### Adatbázis
```bash
sudo su postgres
psql -c 'create user "pek-next" with superuser password '\''pek-next'\'';'
```
###### Adatbázis inicializálása
_Saját felhasználóként_
```bash
rake db:setup
```
## Futtatás
###### Szerver
```bash
rails s
```
###### Worker (választható, redis-t követel)
```bash
bundle exec sidekiq
```
###### Tesztek futtatása
```bash
rake test
```
## Telepítés
A legegyszerűbb mód a docker-compose használata.
A használni kívánt értékekkel töltsd fel a `.env` fájlt a `.env.example` alapján. Az `APP_ID` és `APP_SECRET` változót az auth.sch-ról kapott értékekkel töltsd ki. A `SECRET_KEY_BASE`-t a `bundle exec rake secret` parancs segítségével tudod legenerálni.
Futtasd a következő prancsokat:
```bash
# Nem szükséges ezeket a köteteket név szerint felvenni, így viszont könnyebb lehet hivatkozni rájuk később.
docker volume create pek_public
docker volume create pek_database
docker-compose up --build
```
Miután létrejöttek és futnak a szükséges háttérszolgáltatások / konténerek, add ki az alábbi parancsokat:
```bash
# Ez csak akkor szükséges, ha először telepíted a PéK-et
docker-compose run web bash -c "bundle exec rake db:setup"
# Csak akkor szükséges ha van olyan migráció, ami még nem futott le
docker-compose run web bash -c "bundle exec rake db:migrate"
# Ez csak új telepítésnél és asset váltáskor szükséges
docker-compose run web bash -c "bundle exec rake assets:precompile"
```
## Ismert nehézségek és megoldások
###### A Ruby nem tud natív kiegészítőket telepíteni
```bash
sudo apt install ruby-dev
```
###### Rbenv telepítés csak `ruby-build` használati utasításokat ad
```bash
rbenv install -v 2.5.7
```
###### Az Rbenv nem befolyásolja a Ruby verziót
```bash
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
source ~/.bashrc
```
###### A telepítés ellenére nem találja a shell a rails parancsot
_Indítsd újra a terminálod_
Készítette: [Kir-Dev Team](https://kir-dev.hu/)
### Külön köszönet
[](https://rollbar.com/)