Měsíční Vytrvalec server

Quick Start

git clone <repo> && cd vytrvalec-server
just setup
just run

That's it. just pre-init or ./setup.sh installs all dependencies automatically:

• just - task runner
• FrankenPHP - PHP app server (includes PHP 8.4 + all extensions)
• fnm + Node.js - for frontend asset builds
• Composer - PHP package manager
• sqlite3 - default database

Then just init sets up the project for running.

Then just run starts FrankenPHP, the WebSocket server, and the messenger queue.

Prerequisites

• Linux (Ubuntu/Debian, Fedora, openSUSE, Arch supported)
• sudo access (for system packages)
• curl and wget

Configuration

The default setup uses SQLite. For MySQL, edit .env.local:

DATABASE_URL="mysql://user:pass@localhost/db?serverVersion=8.0&charset=utf8"

Place google-service-account.json in the project root for Firebase integration.

Available Commands

just               # List all commands
just pre-init      # Full dependency + project setup
just project-setup # Project-only (composer, npm, DB, assets)
just run           # Start server + WebSocket + queue
just test          # Run tests
just lint          # Run Mago linter
just analyze       # Run Mago static analysis
just fmt           # Format code
just db-seed       # Load fixtures

ZČU VPN connection

• On Linux, install NetworkManager - paru -S networkmanager-openconnect
• In your VPN client create VPN Cisco AnyConnect connection
• Set gateway as vpn.zcu.cz
• Username and password is your orion login

Kubernetes

• Install kubectl paru -S kubectl
• You can follow this instructions or continue as in this readme
• Create config file in $HOME/.kube/config as below

  apiVersion: v1
  clusters:
  - cluster:
      certificate-authority-data:
  LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUN5RENDQWJDZ0F3SUJBZ0lCQURBTkJna3Foa2lHOXcwQkFRc0ZBREFWTVJNd0VRWURWUVFERXdwcmRXSmwKY201bGRHVnpNQjRYRFRJd01EY3hOREV5TXpnMU0xb1hEVE13TURjeE1qRXlNemcxTTFvd0ZURVRNQkVHQTFVRQpBeE1LYTNWaVpYSnVaWFJsY3pDQ0FTSXdEUVlKS29aSWh2Y05BUUVCQlFBRGdnRVBBRENDQVFvQ2dnRUJBTmpMCnNxam9lMjNQRGVtYkROQmcvUU5MVVRDWklMakVzemEyVW8rTTdyNUtqcjFsSHo5WDBSczBVeTZZN0VCMmQxTDYKZVBrbkV6NmFRU3BBUTlXUVBWYjZNVy9PMU9Ha1QvRkhjdVJaZ1JPUGlNSmt2Q1BETmIzNjJsTDVDVG5iaGFvdQpTZk83SmFDTVlweHdzQmNlUnB2MnhjZTRNTnc3L3pBbzZYTElXdDQ4RjVldzJpTnZDODB1Y2llSFRvWjhhUzR1CmVkbGhWNGxoUU9lK1dJazFkeHBsU1NRYys0TEJYeUlEOVpPbXRSb1F2emN4dlJGQ1ZYQUZ1RWRNd3dsMTZEWkYKWVlYU0c5TUI1SmNjOTVqUTVkWUg1dzZta0s4NTJQakJ0TDQ0dWhMRDFJNW9wTEUrcU1tL2hYaUk2QmFKZk1CWgp4b1oxR3pRRDdGKzcrZXdacE5zQ0F3RUFBYU1qTUNFd0RnWURWUjBQQVFIL0JBUURBZ0trTUE4R0ExVWRFd0VCCi93UUZNQU1CQWY4d0RRWUpLb1pJaHZjTkFRRUxCUUFEZ2dFQkFEVHVoazNyUWRvRkxVWXBPWlc1UytxL3lpVmcKdS9TaUlocWNnMDRJb1dNdWpTaTRwQnhOVTg2MEY3ODJXWU9FTzVzUE5FNjZaRDJWZ1NpVlJMd2RtU2M2QlpxSgpZU3NxeU42NlN1ajhZd1AydzdzL09HYzVEWGN6RElMOWNuSDJsRmJ5SHBhL1ZVbmNHL1VRelAyS0VENDNVZnBpCm1CZ1B2dGtjQXdXcDJQcnIrTjljQjV5ZWtTNXRYK2drQ25VS2ZhVWw0eGFoK1BTZGU3VEFjZ0hiYm1uSWxPdTEKQTh2QmhSYjBRNitnMjEzcktZcVlQVThFQVVydERSczVhMGFWMnBmNlBJbitWdEJvMVhNcWdVeG1yM2diNE1IUgpzczRHWGY2RTRPSTZaOEo5akMzR2lwRWVzUkVHd01WK3RIWXBuQ2t0dHVWTFVZT3JqUmp4Z2FlVmdJZz0KLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQo=
      server: https://synergia.civ.zcu.cz:6443
    name: synergia
  contexts:
  - context:
      cluster: synergia
      namespace: vytrvalec-uts
      user: gitlab-vytrvalec-uts
    name: vytrvalec-uts
  current-context: vytrvalec-uts
  kind: Config
  preferences: {}
  users:
  - name: gitlab-vytrvalec-kts
    user:
      token: <token for gitlab-vytrvalec-kts>

• Replace <token for gitlab-vytrvalec-kts> with token obtained from Kubernetes Dashboard under vytrvalec-uts workspace -> config and storage -> secrets -> gitlab-vytrvalec-kts-token

  

• Now you can run commands like kubectl exec ...

Plugins

• If you are using JetBrains IDE install this plugin from xepozz.

Run before push

• just analyze - Static analysis
• just lint - Linter
• just fmt - Formatting (Mago + Twig CS Fixer)