2013-11-11: refactoring the structure: split into backend and frontends

CHANGES

@@ -1,3 +1,6 @@
+2013-11-11:
+a) split system into backend and frontend component
+
 2013-08-01:
 a) fault handling integrated into the backend
 b) frontend help system improved

INSTALL

@@ -1,21 +1,41 @@
 How to set up / install your own OSCAd instance:
+================================================
+
+(I) Combining the basic php backend and frontends:
+( {backend/basic-php.be/} 
+x { frontends/basicDemoFe-4-basicPhpBe,
+    frontends/basicTbrandedFe-4-basicPhpBe
+  })
 ------------------------------------------------
 
 (1) generate a directory 'toscad' under your web server root directory.
-(2) copy the complete content of this directory into
-    this newly generated 'toscad' directory
-(3) Change into that directory /???/toscad/fileadmin/php/
-(4) Open a shell and call php ./prepare-oscad.php
-(5) Call your webserver url: http.//your-domain/toscad/index.html
+(2) copy the complete content of the sielected frontend directory 
+    into this newly generated 'toscad' directory
+(3) copy the php backend directory into the directory
+    /???/toscad/fileadmin/
+(4) Rename /???/toscad/fileadmin/basic-php.be as /???/toscad/fileadmin/php
+(5) Change into that directory /???/toscad/fileadmin/php/
+(6) Open a shell and call php ./prepare-oscad.php
+(7) Call your webserver url: http.//your-domain/toscad/index.html
 
 READY.
 
-(6) If you want to modify the frontent, generate new html files etc.
-(7) If you want to modify the representation of the answers,
+(8) If you want to customize the frontent, generate new html files etc.
+(9) If you want to customize the representation of the answers,
     modify /???/toscad/fileadmin/php/fileadmin/php/include-files/oscad-view-results-inc.php
-(8) If you want to improve the computed answers, modify the files under
+(A) If you want to improve the computed answers, modify the files under
     /???/toscad/fileadmin/php/fileadmin/php/fileadmin/php/master-files/
     and call again ./prepare-oscad.php - as described above.
 
 
 Happy Coding
+----------------------------------------------------
+
+(II) Combining the python based backend and frontends:
+( {backend/basic-python.be/} 
+x { frontends/basicDemoFe-4-basicPythonBe,
+    frontends/basicTbrandedFe-4-basicPythonBe
+  })
+
+
+TBD

LICENSING

@@ -1,11 +1,19 @@
 OSCAd, the (Telekom) Open Source Compliance Advisor
 (c) 2013 Karsten Reincke, Deutsche Telekom AG, Darmstadt, Germany
 
-    OSCAd is free software: you can redistribute it and/or modify
-    it under the terms of the GNU Affero General Public License as
+    OSCAd is free software: 
+    (1) you can (re)distribute and/or modify its backend components 
+    under the terms of the GNU Affero General Public License as
     published by the Free Software Foundation, either version 3 of the
     License, or (at your option) any later version.
 
+    (2) generally, you can (re)distribute and/or modify its frontends
+    under the terms of the GNU General Public License as
+    published by the Free Software Foundation, either version 3 of the
+    License, or (at your option) any later version (Specific frontends
+    may be published under other open source licenses [see the file
+    LICENSING in the frontend directories] )
+
     This program is distributed in the hope that it will be useful,
     but WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

README

@@ -15,8 +15,17 @@ fulfill license and use case specific requirements.
 
 (c) K. Reincke, Deutsche Telekom AG, Darmstadt 2013
 
-The Open Source Compliance Advisor is licensed under the GNU Affero General Public License (AGPL) which is "[...] specifically designed to ensure cooperation with the community in the case of network server software". So, in short:
+(I) The (backend of the) Open Source Compliance Advisor is licensed under the 
+GNU Affero General Public License (AGPL) which is "[...] specifically 
+designed to ensure cooperation with the community in the case of 
+network server software". So, in short:
 
-Feel free to share (to copy, distribute and transmit) or to modify (to adapt) the software provided you are going to hand your (modified) sources over to anyone who requests for the code - even if he is only interacting with it remotely through a computer network.
+Feel free to share (to copy, distribute and transmit) or to modify (to adapt) 
+the software provided you are going to hand your (modified) sources over to 
+anyone who requests for the code - even if he is only interacting with it 
+remotely through a computer network.
 
 Your full rights and obligations are defined by the AGPL 3.0.
+
+(II) The frontends are spcificly licensed: see the files LICENSING of
+the specific frontedn directories