Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- yms [07.04.2024 05:08] – [Installation] thooge
+++ yms [11.11.2024 08:19] (aktuell) – thooge
@@ Zeile 1: / Zeile 1: @@
 ====== Yacht Management Software (YMS) ======
-Freie Software zur Verwaltung einer oder mehrerer Yachten:
+Freie Software zur Verwaltung einer oder mehrerer Segelyachten.
-  * Ausrüstung
-  * Inventar
+Die Software läuft auf einem [[Bordcomputer]], vorzugeweise einem Raspberry Pi.
-  * Proviant
+Das System kann über einen zugehörigen Bildschirm bedient werden oder
-  * Projekte
+eine Browserschnittstelle (Web-GUI).
-  * Aufgaben
+Die Datenspeicherung erfolgt in einer MariaDB-Datenbank,
-  * Maße/Meßwerte
+die Dokumentablage auf Dateisystemebene.
-  * Dokumente
+Der externe Betrieb auf einem Webserver im Internet ist ebenfalls möglich.
+Features (für Version 1.0):
+  * Daten
+    * Stammdaten
+    * Stauraum
+    * Ausrüstung
+    * Inventar
+    * Proviant
+    * Projekte
+    * Aufgaben
+    * Wartungen
+    * Maße/Meßwerte
+    * Dokumentation
+    * Checklisten
+    * Marker (Tags)
+  * Frontend
+    * Native Bedienoberfläche auf dem Bordcomputer
+    * Web-GUI
+Weiterführende Informationen:
+  * Ankündigung im [[https://www.segeln-forum.de/thread/90714-yacht-management-software-yms/?postID=2628207|Segeln-Forum]]
+  * Quelltext herunterladen aus Git
+    * sobald in einem veröffentlichungswürdigem Zustand
+    * vorab möglich nach persönlicher Anfrage
+  * Demosystem unter https://www.hoogi.de/yms
+  * [[yms_handbuch|Anwendungshinweise]]
+  * [[yms_openplotter|Integration in OpenPlotter]]
-Zum Betrieb auf einem Bordcomputer, vorzugsweise Raspberry Pi.
-Demosystem unter https://www.hoogi.de/yms
 ===== Installation =====
@@ Zeile 18: / Zeile 43: @@
   * MariaDB Datenbank: ''apt-get install mariadb-server''
   * Webserver
-    * Apache mit PHP-Modul
+    * Apache mit PHP-Modul<code>
+apt-get install apache2 libapache2-mod-php php-mysql
+</code>
     * Lighttpd mit php-fpm:<code>
 apt-get install lighttpd php-fpm php-mysql
 lighty-enable-mod fastcgi-php-fpm
 </code>
-  * PDF Werkzeuge
+      * Socket-Adresse einstellen in Pool ''www'': ''listen = /run/php/php-fpm.sock''
-    * mupdf-tools
+      * Die Dateien für die GUI können einfach in ein Verzeichnis des Webservers kopiert werden. Falls das YMS die einzige Anwendung ist, kann das Basisverzeichnis z.B. ''/var/www/html'' verwendet werden. Teilt sich YMS den Server mit anderen Anwendungen, kann einfach ein Unterverzeichnis verwendet werden z.B.  ''/var/www/html/yms''.
+  * PDF Werkzeuge (MuPDF)
+    * '' apt-get install mupdf-tools''
   * Lokales, natives Frontend
     * Python
     * GTK
+===== Konfiguration =====
+Das System bzw. die Oberfläche ist grundsätzlich mehrsprachig ausgelegt.
+Die Nutzdaten sind allerdings nur in einer Sprache zu erfassen.
+Deshalb muß beim Aufsetzen des Systems eine Entscheidung bzgl. der Sprache
+getroffen werden.
+Datenbankstruktur anlegen, sprachunabhängig:
+  mariadb yms < mariadb.sql
+Anlegen nur der absolut minimalen Daten. Dabei handelt es sich um den
+initialen Benutzer //captain//, sowie die Vorbelegung von Auswahllisten
+welche im Programmcode referenziert werden.
+  mariadb yms < minimal.sql
+Einstellen des Kennworts für den ersten Benutzer
+  python3 genpass.py
+==== Web-GUI ====
+Als einziger Konfigurationsschritt muß die Konfigurationsdatei ''config.inc'' angelegt
+werden. Am einfachsten durch Umbenennen von ''config.inc-sample''.
+Mindestens die Datenbank-Zugangsdaten müssen angepaßt werden.