#####################
		#                   #
		#      README       #
		#                   #
		#####################

 _______________________________________________
|						|
|	Authors : 				|
|		BURY Marie-Hélène (Binome 2)	|
|		DELOMENIE Justine (Binome 1)	|
|		MENGHETTI Marina (Binome 1)	|
|		RODER Thomas (Binome 2)		|
|_______________________________________________|


##########     HOW TO USE THE CODE ?     ##########


	- Please, use the virtual machine installed on the school computers that is named UBUNTU14_BD_PROG (MDP : usr)
	- Then, use eclipse with "Eclipse Java EE IDE for Web Developers". Version: Kepler Service Release 2.Change parameters : Window -> Preferences -> Compiler -> JDK compliance : compiler compliance level : 1.7
	- To retrieve all the code from Redmine : on Eclipse, click on Window > Show View > Others... > SVN > Référentiels SVN.
	- In the new window (probably on the bottom of your screen), click on the yellow cylindre with a green '+' "Nouvel emplacement du référentiel".
	- Retrieve the url of the deposit on RedMine, go in the configuration section, then click on "dépots" and copy the url. Paste the url in the window opened in Eclipse which is asking for the url. Authenticate with your username and password. Click on Finish.
	- In the referentiels SVN list, open the referentiel that matches the url, and click right on FilRouge and click on "Trouver/Réserver en tant que" and click Finish.
	- Now you have the code on Eclipse.


	- To have the access to the database : Launch pgAdmin with a click on the blue elephant at the top of the home screen. Double-click on Postgres and enter "postgres" as the password. Then, do a right click on "Base de Donnees" -> ajouter une base de données... -> write "filRouge" in the name section. Click on filRouge. Click on the symbol "executer vos propres requêtes SQL" (a magnifying glass with yellow background with "SQL" written on it).
	- Open RedMine and click on the section "Documents", then choose the section "script sql", and find the last script sql. Copy and paste all the text in the Query page for SQL requests.
	- Execute all : be careful Ctrl+A doesn't succeed, you need to select all the text (beginning with the first word of the text, and finishing with the last : you have to select the whole text ( it doesn't work by using ctrl + A ), and then click on the green arrow "executer la requête" (the first one) to execute the script.
	- Now you have your database initialized and it is linked with Eclipse.

	- So, if you want to use our tests, click on the corresponding name and launch it with the green arrow, these test files are junit tests files.
	- in the validationTests.uv1.tests.validation.withoutPersistence are located the validationTests available in Moodle.



##########     PACKAGES     ##########


	fr.uv1.bettingServices : The classes without persistence
	fr.uv1.bettingServices.DaoManagers : Managers to acess to the database
	fr.uv1.bettingServices.exceptions : The exceptions
	fr.uv1.tests.junit : JUnit tests
	fr.uv1.tests.validation.withoutPersistence : Validation tests available on Moodle
	fr.uv1.utils : DataBaseConnection and MyCalendar classes



##########     KNOWN BUGS     ##########


There are no known bugs for the moment for the part : competitors, single, team, participantManager, competition and competitionManager.
The Subscribe Method in the userManager class is hard to instantiate... that's why the UserManagerTest class is missing some elements.
There is a problem to give the tokens after a successful bet.


##########     GENERAL FUNCTIONMENT     ##########


The call of our functions begins with BettingSoft. The functions in BettingSoft calls functions in the differents managers.
The managers check, write and search in the database before to create the instances and/or return them with the informations of the database.

For the functions of the Competitor interface, we have chosen to have the call of the functions addMember and deleteMember in Single and Team, which call the function in the Dao manager.

If we had known this before, it could has been better to create the instances first and persist them after, but we haven't enough time to change it now.



##########     LICENSE     ##########


The licence is the licence used for the projects done by the students of Telecom Bretagne.


##########     RELEASE     ##########
commit numero 286