From da8588a462b6bd75518d1cf5e010f47795fe3acb Mon Sep 17 00:00:00 2001
From: =?utf8?q?Roland=20H=C3=A4der?= <roland@mxchange.org>
Date: Tue, 8 Sep 2009 21:57:11 +0000
Subject: [PATCH] Contract-related XMLs added, TODOs.txt updated

---
 .gitattributes                                |  3 ++
 .../de/game/contract/base_contract.xml        | 51 +++++++++++++++++++
 .../de/game/contract/contract_types.xml       | 40 +++++++++++++++
 .../de/game/contract/signer_types.xml         | 29 +++++++++++
 docs/TODOs.txt                                |  2 +
 5 files changed, 125 insertions(+)
 create mode 100644 application/ship-simu/templates/de/game/contract/base_contract.xml
 create mode 100644 application/ship-simu/templates/de/game/contract/contract_types.xml
 create mode 100644 application/ship-simu/templates/de/game/contract/signer_types.xml

diff --git a/.gitattributes b/.gitattributes
index c2d7bb6..69ec6dc 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -279,6 +279,9 @@ application/ship-simu/templates/de/game/building/.htaccess -text
 application/ship-simu/templates/de/game/building/base_building.xml -text
 application/ship-simu/templates/de/game/company/.htaccess -text
 application/ship-simu/templates/de/game/contract/.htaccess -text
+application/ship-simu/templates/de/game/contract/base_contract.xml -text
+application/ship-simu/templates/de/game/contract/contract_types.xml -text
+application/ship-simu/templates/de/game/contract/signer_types.xml -text
 application/ship-simu/templates/de/game/merchant/.htaccess -text
 application/ship-simu/templates/de/game/research/.htaccess -text
 application/ship-simu/templates/de/game/resource/.htaccess -text
diff --git a/application/ship-simu/templates/de/game/contract/base_contract.xml b/application/ship-simu/templates/de/game/contract/base_contract.xml
new file mode 100644
index 0000000..ecfcf12
--- /dev/null
+++ b/application/ship-simu/templates/de/game/contract/base_contract.xml
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+A general contract
+
+@author		Roland Haeder <webmaster@ship-simu.org>
+@version	0.0.0
+@copyright	Copyright (c) 2007, 2008 Roland Haeder, 2009 Ship-Simu Developer Team
+@license	GNU GPL 3.0 or any newer version
+@link		http://www.ship-simu.org
+
+This program is free software: you can redistribute it and/or modify
+it 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.
+
+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
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see <http://www.gnu.org/licenses/>
+//-->
+<contract>
+	<!-- Parties of a contract are listed here. At least two, of course. //-->
+	<contract-parties total="{?total_parties?}">
+		<!-- All contract parties are enlisted with this tag. //-->
+		<contract-party>
+			<!-- The signer's data, for signer_type please refer to signer_types.xml //-->
+			<signer id="{?signer_id?}" type="{?signer_type?}" />
+		</contract-party>
+	</contract-parties>
+	<!-- General contract data like data of signature or cancelation //-->
+	<contract-data id="{?contract_id?}" type="{?contract_type?}">
+		<signed timestamp="{?signed_timestamp?}" />
+		<canceled timestamp="{?canceled_timestamp?}" />
+		<cancelation-reason>
+			<![CDATA[{?cancelation_reason?}]]>
+		</cancelation-reason>
+		<!-- A free-text description: //-->
+		<description>
+			<![CDATA[{?contract_description?}]]>
+		</description>
+	</contract-data>
+	<!-- The subject-(matter) of a contract. If this changes, the contract
+	     needs to be renewed. //-->
+	<contract-subject>
+		<!-- @TODO We need to make this more XML than free text. //-->
+		<![CDATA[{?contract_subject?}]]>
+	</contract-subject>
+</contract>
diff --git a/application/ship-simu/templates/de/game/contract/contract_types.xml b/application/ship-simu/templates/de/game/contract/contract_types.xml
new file mode 100644
index 0000000..14bcf87
--- /dev/null
+++ b/application/ship-simu/templates/de/game/contract/contract_types.xml
@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+All valid contract types.
+
+@author		Roland Haeder <webmaster@ship-simu.org>
+@version	0.0.0
+@copyright	Copyright (c) 2007, 2008 Roland Haeder, 2009 Ship-Simu Developer Team
+@license	GNU GPL 3.0 or any newer version
+@link		http://www.ship-simu.org
+
+This program is free software: you can redistribute it and/or modify
+it 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.
+
+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
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see <http://www.gnu.org/licenses/>
+//-->
+<contract-types>
+	<!-- A construction contract, possible signers: Construction company, customer, creditor //-->
+	<contract-type type="construction_contract" max-signers="3">
+		<!-- All valid signer types for this contract //-->
+		<signer-types extends="signer_types">
+			<signer-type type="gamer" slot="all" max="3" />
+			<signer-type type="moneybank" slot="creditor" max="1" />
+			<signer-type type="construction_company" slot="construction_company" max="1" />
+		</signer-types>
+		<!-- And the corresponding slot types //-->
+		<slots>
+			<slot type="construction_company" must-have="true" />
+			<slot type="customer" must-have="true" />
+			<slot type="creditor" must-have="false" />
+		</slots>
+	</contract-type>
+</contract-types>
diff --git a/application/ship-simu/templates/de/game/contract/signer_types.xml b/application/ship-simu/templates/de/game/contract/signer_types.xml
new file mode 100644
index 0000000..7e4787d
--- /dev/null
+++ b/application/ship-simu/templates/de/game/contract/signer_types.xml
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+All valid signer types and how they should translated into database and table
+names.
+
+@author		Roland Haeder <webmaster@ship-simu.org>
+@version	0.0.0
+@copyright	Copyright (c) 2007, 2008 Roland Haeder, 2009 Ship-Simu Developer Team
+@license	GNU GPL 3.0 or any newer version
+@link		http://www.ship-simu.org
+
+This program is free software: you can redistribute it and/or modify
+it 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.
+
+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
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see <http://www.gnu.org/licenses/>
+//-->
+<signer-types>
+	<!-- The type 'gamer' which is in facts the user. //-->
+	<signer-type type="gamer" table="user" column="userid" />
+	<!-- @TODO Add more types, e.g. company //-->
+</signer-types>
diff --git a/docs/TODOs.txt b/docs/TODOs.txt
index e4c1031..9f888e7 100644
--- a/docs/TODOs.txt
+++ b/docs/TODOs.txt
@@ -170,6 +170,8 @@
 ./inc/includes.php:36:// @TODO Find a nicer OOP-ed way for this
 ./inc/language.php:31:// @TODO Rewrite this
 ./inc/loader/class_ClassLoader.php:262:			/* @todo: Do not die here. */
+./application/ship-simu/templates/de/game/contract/base_contract.xml:48:		<!-- @TODO We need to make this more XML than free text. //-->
+./application/ship-simu/templates/de/game/contract/signer_types.xml:28:	<!-- @TODO Add more types, e.g. company //-->
 ### ### DEPRECATION FOLLOWS: ### ###
 ./application/ship-simu/main/personell/class_SimulatorPersonell.php:118:	 * @deprecated
 ./application/ship-simu/main/personell/class_SimulatorPersonell.php:319:	 * @deprecated
-- 
2.39.5