Entwickler: Unterschied zwischen den Versionen

Aus OrgaMon Wiki
Zur Navigation springen Zur Suche springen
 
(31 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 4: Zeile 4:
<i>Freie Software ist die Basis für IT-Sicherheit</i><br>
<i>Freie Software ist die Basis für IT-Sicherheit</i><br>
[Richard Stallman]
[Richard Stallman]
* Aktuelle Entwicklungen: https://github.com/Andreas-Filsinger/OrgaMon/commits/main/


== OrgaMon, unterstützte Betriebssysteme ==
== OrgaMon, unterstützte Betriebssysteme ==


* Win32, Windows 2000, XP, Vista, Windows 7
* Win32, Windows 2000, XP, Vista, Windows 7, Windows 10
* Linux über die Emulations-Schicht Wine ab 0.98.5
* Linux über die Emulations-Schicht Wine ab 0.98.5
* Virtualisierte Windows XP Systeme (via VirtualBox)
* Virtualisierte Windows 10 Systeme (via [[Linux.kvm]])


== OrgaMon-App, unterstützte Betriebssysteme ==
== OrgaMon-App, unterstützte Betriebssysteme ==
Zeile 20: Zeile 22:
*[[Entwickler Schnellstart]]<br>
*[[Entwickler Schnellstart]]<br>
*[[OrgaMon-FS|OrgaMon Test-Suite]]<br>
*[[OrgaMon-FS|OrgaMon Test-Suite]]<br>
* Datenbank [[Metadaten]]
*[[Technik]]
*[[Technik]]
*[[eCommerce]]<br>
*[[eCommerce]]<br>
Zeile 28: Zeile 31:
*[[HotKeys]]
*[[HotKeys]]
*[[OrgaMon-next]]
*[[OrgaMon-next]]
*[[HeBu-next]]
*[[TxOrtung]]
*[[TxOrtung]]
*[[minecraft]]
*[[minecraft]]
*[[ZIP-Erstellung]]
* http://msdn.microsoft.com/en-us/library/ms740668(v=vs.85).aspx
* http://msdn.microsoft.com/en-us/library/ms740668(v=vs.85).aspx


Zeile 41: Zeile 44:
*[[OrgaMon-RC]]
*[[OrgaMon-RC]]


== OrgaMon-Server-Identitäten ==
== Team-Entwickler ==


* der OrgaMon-Quelltext für die Konsolen-Anwendung (win32/linux) ist so universell gehalten, dass auch der Quelltext mit dem FreePascal [http://freepascal.org]-Compiler übersetzt werden kann (ab Rev. 8.000).
Für das Gesamtkunstwerk OrgaMon wird ein zentrales Git-Repository geführt. Der Read Only Zugriff ist anonym möglich. Forke das Repository in deinen eigenen GitHub-Account. Mache von diesem Repository ein Git-Clone auf deine lokale Platte. Entwickle auf diesem Verzeichnis. Änderungen per Poll-Request an das Original OrgaMon-Repository. Der Maintainer Andreas(Punkt)Filsinger(bei)orgamon(Dot)org meldet sich dann. Es ist ein Lizenzbruch an OrgaMon zu entwickeln und die Arbeit nicht in das Original Repository zurückfliessen zu lassen. Bitte komme dieser moralischen Verpflichtung nach
* Stand 2016: Im Moment läuft bei der Freepascal Compilierung nur das Target Win32. In Zukunft wird ein "lOrgaMon" als Serverprozess für Linux erwartet. Dazu muss ich noch automatisierte Tests in win32 vorbereiten, die dann identisch unter Linux ablaufen müssen.


=== cOrgaMon ===
* Web-Interface: https://github.com/Andreas-Filsinger/OrgaMon
* Git-Interface: https://github.com/Andreas-Filsinger/OrgaMon.git


cOrgaMOn.exe ist eine monolitische Anwendung die per Kommandozeilenparameter verschiedene Identitäten annehmen kann. Für jede Identität muss dann eine eigene Instanz des Prozesses gestartet werden.
=== Installation ===


==== id_TWebShop ====
==== einfach mal zum testen ====
* der XMLRPC für den TWebShop
==== id_Bestellen ====
==== id_Mail ====
==== id_Druck ====
==== id_App ====
* der Service für "senden" der OrgaMon-App


ftphost=
* Lade Dir TortoiseGIT herunter (http://tortoisesvn.net/downloads) und installiere es
ftpuser=
* Erstelle in "Eigene Dateien"->RAD Studio->Projekte ein neues Verzeichnis mit dem Namen "OrgaMon" (kann auch woanders liegen oder auch anders lauten!) und öffne es (ANMERKUNG: Es MUSS sich wegen eines Bugs im TortoiseGIT auf einer LOKALEN Platte befinden, Samba Shares gehen nicht!!!!)
ftppwd=
* Rechtsklicke in das offene Verzeichnis in den leeren Bereich und wähle "Git Clone"
port=
* Als Repository gebe <code>https://github.com/Andreas-Filsinger/OrgaMon.git</code> an
LogPath=
* Vergewissere Dich, dass Dein "Check Out Directory" (eigentlich das Target Dir!) das eben angelegte "OrgaMon" ist, und nicht OrgaMon/OrgaMon sein wird
# default = "NEIN"
* Drücke OK, alle Optionen einfach so lassen!
NoTimeCheck=["JA"|"NEIN"]
 
==== id_Foto ====
 
* der Service für das verteilen von Fotos
 
[System]
[~Id~]
ftphost=
ftpuser=
ftppwd=
BackUpPath=
WebPath=
[StatistikPath=]
FTPPath=
UnverarbeitetPath=
LogPath=
 
=== lOrgaMon ===
 
der XMLRPC für den OrgaMon (Linux-Konsolenanwendung,Win32-Konsolenanwendung)
 
=== bOrgaMon ===
 
BankCard Dämon für die Übergabe der EC-Karten an den OrgaMon. BLZ, Kontonummer, Gültig bis, Kartennummer wird gelesen. Schreibt die Kartendaten in eine Datei. (Oder per XMLRPC).
 
http://www.infintuary.org/index.php
 
== Team-Entwickler ==
 
Für das Gesamtkunstwerk OrgaMon wird ein zentrales Repository mit der Software Subversion verwaltet. Der Read Only Zugriff ist anonym möglich. Schreibenden Zugriff erhalten Entwickler nach Kontakt zum OrgaMon-Maintainer Andreas(Punkt)Filsinger(bei)orgamon(Dot)org .
 
* Web-Interface (WEBsvn) Read-Only Zugriff: http://orgamon.org/subversion/
* SVN-Interface: svn://orgamon.org/orgamon


=== Installation ===
==== wenn man mitentwicklen will ====


* Lade Dir TortoiseSVN herunter (http://tortoisesvn.net/downloads) und installiere es
* Dann braucht man einen GitHhub Account, also schnelll registrieren
* Erstelle in "Eigene Dateien"->RAD Studio->Projekte ein neues Verzeichnis mit dem Namen "OrgaMon" (kann auch woanders liegen oder auch anders lauten!) und öffne es (ANMERKUNG: Es MUSS sich wegen eines Bugs im TortoiseSVN auf einer LOKALEN Platte befinden, Samba Shares gehen nicht!!!!)
* Man macht einen Fork des Repositorys OrgaMon
* Rechtsklicke in das offene Verzeichnis in den leeren Bereich und wähle "SVN Checkout"
* Man macht vom Eigenen Fork einen "Git Clone" ins lokale Verzeichnis
* Als Repository gebe "svn://orgamon.org/orgamon" an
* Man macht Änderungen/Test und immer mal wieder ein Commit, damit Änderungen sinnvoll ins eigene Repository fliessen
* Vergewissere Dich, dass Dein "Check Out Directory" (eigentlich das Target Dir!) das eben angelegte "OrgaMon" ist
* Drücke OK, alle Optionen einfach so lassen!


=== täglicher Arbeitsablauf ===
=== täglicher Arbeitsablauf ===
Zeile 113: Zeile 74:


* rechter Mausklick auf Dein OrgaMon-Verzeichnis
* rechter Mausklick auf Dein OrgaMon-Verzeichnis
* "SVN Update"
* "Git Sync" ... danach weitere Schritte


-> Du bist nun auf dem neuesten Stand!
-> Du bist nun auf dem neuesten Stand!
Zeile 135: Zeile 96:
Man sollte erst mal alles zu Ende bringen, also alle Hinzunahmen erst mal zu Ende bringen. Nun muss man
Man sollte erst mal alles zu Ende bringen, also alle Hinzunahmen erst mal zu Ende bringen. Nun muss man


* auf neue Verzeichnisse einen rechten Mausklick machen und "TortoiseSVN" -> "+ add" ausführen, jetzt hat man die Chanche Datei-Extensions, die man nicht auf dem Server haben will zu demarkieren (default ist "Alles angekreuzt"). Nach einem OK wir im lokalen Repository zunächst mal der neue Content als überhaupt "SVN-relevanter" Content beachtet. Der Fragezeichenstatus geht über in ein fettes blaues Plus.
* auf neue Verzeichnisse einen rechten Mausklick machen und "TortoiseGIT" -> "+ add" ausführen, jetzt hat man die Möglichkeit Datei-Extensions, die man nicht auf dem Server haben will zu demarkieren (default ist "Alles angekreuzt"). Nach einem OK wir im lokalen Repository zunächst mal der neue Content als überhaupt "SVN-relevanter" Content beachtet. Der Fragezeichenstatus geht über in ein fettes blaues Plus.
* neue Dateien, die noch ein blaues Fragezeichen haben muss einzeln ge "+ add"ed werden.  
* neue Dateien, die noch ein blaues Fragezeichen haben muss einzeln ge "+ add"ed werden.  


Zeile 142: Zeile 103:
==== Release erzeugen ====
==== Release erzeugen ====


* mache diesen Schritt sobald all deine Test erfolgreich laufen
* mache diesen Schritt erst sobald all deine Test erfolgreich laufen
* Nebeneffekte deiner Release sollten ausgeschlossen sein, wenn unsicherheiten bestehen bitte Andreas Filsinger kontaktieren
* Nebeneffekte deiner Release sollten ausgeschlossen sein, wenn unsicherheiten bestehen bitte Andreas Filsinger kontaktieren
* "SVN Update" auf die Projekt-Datei im Rev-Verzeichnis (z.B. OrgaMon.rev.txt)
* Editiere die zum Projekt passende .rev.txt Datei aus dem Pfad /rev
* Mache oben neu Einträge im Stile der anderen alten Einträge
* Ab .SQL Init kannst Du SQL Befehle zum Metadaten Update hinzugeben
* In Globas.pas (oder in jedem Projekt eigentlich anders) erhöhe die Versionnummer auf die Angabe in der Rev-Datei
* Rev-Datei nun laden und eine Version hochzählen (und merken) und einen neuen Eintrag machen
* Rev-Datei nun laden und eine Version hochzählen (und merken) und einen neuen Eintrag machen
* in "globals.pas" die gemerkte Version Nummer eintragen
* in "globals.pas" die gemerkte Version Nummer eintragen
Zeile 150: Zeile 114:
* Autoup und ab damit
* Autoup und ab damit
* Nun all deine Änderungen committen: rechter Mausklick auf das Repository Haupt-Verzeichnis  
* Nun all deine Änderungen committen: rechter Mausklick auf das Repository Haupt-Verzeichnis  
* "SVN Commit"
* dokumentiere in der Msg-Box dein Patch-Set
* dokumentiere in der Msg-Box dein Patch-Set
* "GIT Commit"


optional
optional


* anschliessender "SVN Update", denn andere waren in der Zwischenzeit nicht untätig
* anschliessender Merge (bitte das hier korrigieren) damit auch Du wieder die Änderungen der anderen bekommst
* dies erhöht die Chanche dass Dein nächster "Update" / "Commit" problemlos durchläuft


=== Bedeutung der Verzeichnisse ===
=== Bedeutung der Verzeichnisse ===
Zeile 173: Zeile 136:
== Konzepte ==
== Konzepte ==


[[DatabaseArchitect]]<br>
[[RAIB]]
[[RAIB]]


Zeile 200: Zeile 162:


* Die Lösung 2103 liegt sauber in unserem Zeitfenster!
* Die Lösung 2103 liegt sauber in unserem Zeitfenster!
[[CMS.Dateiablage]]
== OrgaMon next ==
* Es gibt Gedanken über einen Neustart der Entwicklung in c++17 mit clang als Compiler und qt Develop als IDE
=== clang++ ===
// orgamon.cpp
#include <iostream>
int main(){
  if (!nullptr) {
  std::cout << "<nullptr> support!" << std::endl;
  }
std::cout << "Hallo, du schöne Welt!" << std::endl;
return 0;
}
==== Comilieren und Linken ====
clang++ -stdlib=libc++ orgamon.cpp -lc++abi
./a.out
==== Von Clang die LLVM IR lernen ====
clang++ -S -stdlib=libc++ -emit-llvm orgamon.cpp
joe orgamon.ll
=== FreePascal ===
* FreePascal sollte ev. ein Target LLVM IR enthalten
* https://code.google.com/p/dcocor/
** sollte 100% UTF8 werden, nix anderes (Source, Strings, Files, DB, OS)
** sollte ev. ein Target LLVM IR enthalten


=== TO DO ===
=== TO DO ===


* FlexCell und IBObjects Wegfall
* FlexCell und IBObjects Wegfall
* Migration Zipper
* Nach der Funktionsprüfung von lOrgaMon.exe (FreePascal-Win32-Konsolenanwendung) soll das Compile-Target "Linux" geprüft werden.
* Nach der Funktionsprüfung von lOrgaMon.exe (FreePascal-Win32-Konsolenanwendung) soll das Compile-Target "Linux" geprüft werden.
* Bestandteile der Dienste "Mail", "Tagwache", "Tagesabschluss" sollen Stück für Stück in den lOrgaMon Code wandern.
* Bestandteile der Dienste "Mail", "Tagwache", "Tagesabschluss" sollen Stück für Stück in den lOrgaMon Code wandern.

Aktuelle Version vom 12. August 2024, 18:54 Uhr

Software ist in der modernen Welt zu wichtig, um nicht als Open-Source entwickelt zu werden.
[Linus Torwalds]
Freie Software ist die Basis für IT-Sicherheit
[Richard Stallman]

OrgaMon, unterstützte Betriebssysteme

  • Win32, Windows 2000, XP, Vista, Windows 7, Windows 10
  • Linux über die Emulations-Schicht Wine ab 0.98.5
  • Virtualisierte Windows 10 Systeme (via Linux.kvm)

OrgaMon-App, unterstützte Betriebssysteme

  1. Andorid 2.3 oder besser

Datenfunknetz

technische Infos für Entwickler

OrgaMon, Summer of Code

OrgaMon-RC

Team-Entwickler

Für das Gesamtkunstwerk OrgaMon wird ein zentrales Git-Repository geführt. Der Read Only Zugriff ist anonym möglich. Forke das Repository in deinen eigenen GitHub-Account. Mache von diesem Repository ein Git-Clone auf deine lokale Platte. Entwickle auf diesem Verzeichnis. Änderungen per Poll-Request an das Original OrgaMon-Repository. Der Maintainer Andreas(Punkt)Filsinger(bei)orgamon(Dot)org meldet sich dann. Es ist ein Lizenzbruch an OrgaMon zu entwickeln und die Arbeit nicht in das Original Repository zurückfliessen zu lassen. Bitte komme dieser moralischen Verpflichtung nach

Installation

einfach mal zum testen

  • Lade Dir TortoiseGIT herunter (http://tortoisesvn.net/downloads) und installiere es
  • Erstelle in "Eigene Dateien"->RAD Studio->Projekte ein neues Verzeichnis mit dem Namen "OrgaMon" (kann auch woanders liegen oder auch anders lauten!) und öffne es (ANMERKUNG: Es MUSS sich wegen eines Bugs im TortoiseGIT auf einer LOKALEN Platte befinden, Samba Shares gehen nicht!!!!)
  • Rechtsklicke in das offene Verzeichnis in den leeren Bereich und wähle "Git Clone"
  • Als Repository gebe https://github.com/Andreas-Filsinger/OrgaMon.git an
  • Vergewissere Dich, dass Dein "Check Out Directory" (eigentlich das Target Dir!) das eben angelegte "OrgaMon" ist, und nicht OrgaMon/OrgaMon sein wird
  • Drücke OK, alle Optionen einfach so lassen!

wenn man mitentwicklen will

  • Dann braucht man einen GitHhub Account, also schnelll registrieren
  • Man macht einen Fork des Repositorys OrgaMon
  • Man macht vom Eigenen Fork einen "Git Clone" ins lokale Verzeichnis
  • Man macht Änderungen/Test und immer mal wieder ein Commit, damit Änderungen sinnvoll ins eigene Repository fliessen

täglicher Arbeitsablauf

Beginn

  • rechter Mausklick auf Dein OrgaMon-Verzeichnis
  • "Git Sync" ... danach weitere Schritte

-> Du bist nun auf dem neuesten Stand!

Coding & Test

  • öffne z.B. mit Delphi ./OrgaMon/OrgaMon.dproj
  • editiere Dateien wie bisher
  • mache alles wie bisher, teste alles gut ...

-> wenn Deine Änderungen Release-Fähig sind ...

Löschen von Dateien

bei einem Commit sind Löschungen nicht automatisch im Änderungsauftrag an den Server mit dabei: Es reicht aber "select / deselect all" anzukreuzen, alternativ kann bei jeder gewünschten Löschung ein Haken gesetzt werden.

Hinzunahme neuer Dateien

ACHTUNG: Jeder neue Content (neue Verzeichnisse / neue Dateien) wird erkannt jedoch muss wie bei der Löschung das "select / deselect all" angekreuzt werden, dass überhaupt der Content übertragen wird. Bei dieser Verfahrensweise bekommen jedoch andere Entwickler diese neuen Dateien nicht zu Gesicht. Es muss hier mehr getan werden:

Man sollte erst mal alles zu Ende bringen, also alle Hinzunahmen erst mal zu Ende bringen. Nun muss man

  • auf neue Verzeichnisse einen rechten Mausklick machen und "TortoiseGIT" -> "+ add" ausführen, jetzt hat man die Möglichkeit Datei-Extensions, die man nicht auf dem Server haben will zu demarkieren (default ist "Alles angekreuzt"). Nach einem OK wir im lokalen Repository zunächst mal der neue Content als überhaupt "SVN-relevanter" Content beachtet. Der Fragezeichenstatus geht über in ein fettes blaues Plus.
  • neue Dateien, die noch ein blaues Fragezeichen haben muss einzeln ge "+ add"ed werden.

Vor einem "Commit" sollten also alle "hängenden" Stati ordentlich in echte Stati "add" oder "ignore" umgesetzt werden!

Release erzeugen

  • mache diesen Schritt erst sobald all deine Test erfolgreich laufen
  • Nebeneffekte deiner Release sollten ausgeschlossen sein, wenn unsicherheiten bestehen bitte Andreas Filsinger kontaktieren
  • Editiere die zum Projekt passende .rev.txt Datei aus dem Pfad /rev
  • Mache oben neu Einträge im Stile der anderen alten Einträge
  • Ab .SQL Init kannst Du SQL Befehle zum Metadaten Update hinzugeben
  • In Globas.pas (oder in jedem Projekt eigentlich anders) erhöhe die Versionnummer auf die Angabe in der Rev-Datei
  • Rev-Datei nun laden und eine Version hochzählen (und merken) und einen neuen Eintrag machen
  • in "globals.pas" die gemerkte Version Nummer eintragen
  • nochmals compilieren
  • Autoup und ab damit
  • Nun all deine Änderungen committen: rechter Mausklick auf das Repository Haupt-Verzeichnis
  • dokumentiere in der Msg-Box dein Patch-Set
  • "GIT Commit"

optional

  • anschliessender Merge (bitte das hier korrigieren) damit auch Du wieder die Änderungen der anderen bekommst

Bedeutung der Verzeichnisse

  • anfix32 (*.pas Tools)
  • PHPincludes (*.php Tools)
  • rev (Die Revision-Dateien)
  • OrgaMon (*.pas der OrgaMon-win32-Client)
  • MonDaServer (*.pas ein Server)
  • Oc (*.pas ein Kommandozeilen Tool)
  • aqbd (*.c ein HBCI Dämon)
  • TWebShop (*.php5 der OrgaMon Webshop)

Konzepte

RAIB

Datum

Noch immer ist die Unsitte verbreitet Datumsangaben im Bezug auf das Jahr nur 2 stellig anzugeben, als man schenkt sich das Jahrhundert, in dem wir leben! Also einen Datumsangabe wie z. B.

10.10.10

hm, ist das jetzt der 10.10.1910 oder 10.10.2010. Das kann man nun je nach Kontext (als Mensch) sehr gut entscheiden. Der OrgaMon legt hier folgende Vereinbarung zu Grunde:

  • Gehe vom aktuellen Jahr aus und rechne ein Menschenalter (75 Jahre) zurück, dies ist das Startdatum für 2 stellige Jahresangaben
  • Gehe vom aktuellen Jahr aus und rechne eine Menschengeneration (24 Jahre) vor, dies ist das Endedatum für 2 stellige Jahresangaben


z.B. 10.10.10
  • Es sei das Jahr 2025: Zeitraum ist somit also 1955 bis 2054
  • das bedeutet die Lösung ist entweder 1910 oder 2010
  • da nur 2010 im vorberechneten Zeitfenster liegt ist dies das Ergebnis!

Kann es sich auch mal auf das kommende Jahrhundert beziehen? JA. Sagen wir jemand sagt: Am 10.10.03 steigt die grösste Party aller Zeiten! Nehmen wir an, es ist das Jahr 2099, also

2099 - 75 = 2024 StartJahrhundert
2099 + 24 = 2123 EndeJahrhundert
  • Die Lösung 2103 liegt sauber in unserem Zeitfenster!

TO DO

  • FlexCell und IBObjects Wegfall
  • Nach der Funktionsprüfung von lOrgaMon.exe (FreePascal-Win32-Konsolenanwendung) soll das Compile-Target "Linux" geprüft werden.
  • Bestandteile der Dienste "Mail", "Tagwache", "Tagesabschluss" sollen Stück für Stück in den lOrgaMon Code wandern.
    • --Indexerstellung
    • --FTP-Uploads
    • --Backup / --restore
    • --tagwache
    • --tagesabschluss

SEPA-Probleme

bisher

'ABSCHLUSS PER 31.03.2011'#$D#$A
'SALDO RECHNUNGSABSCHLUSS'#$D#$A
'            PER  31.03.2011'#$D#$A
'INCL. ABSCHLUSSBETRAG'#$D#$A
'                     303,49'#$D#$A

neu

'ABSCHLUSS PER 31.12.2015SALDO RECHNUNGSABSCHLUSS            PER  30.12.2015INCL. ABSCHLUSSBETRAG                     763,52'#$D#$A

Aufsplittung


'ABSCHLUSS PER 31.12.2015'
'SALDO RECHNUNGSABSCHLUSS'
'            PER  30.12.2015'
'INCL. ABSCHLUSSBETRAG'
'                     763,52'
  • Also was die Banken machen ist gegen jedes IT-Verständnis
    • die einst mehrzeiligen Verwendungszwecke werden zu einer langen Zeile zusammengefügt, dabei werden
      • Blanks links des ersten Zeichen erhalten
      • Blanks rechts des letzten Zeichens gelöscht

TOLL!!! Gut gemacht