/*******************************************************************
* Copyright© 2011 Seema Saijpaul 
* 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/>.

* Author: Seema Saijpaul
* Feedback: nssell.2009@gmail.com
*******************************************************************/

Description of the project:
---------------------------
QUASOR is built with the motivation of educating the end users with natural recipes 
that are made with Organic ingredients and can be used to treat/cure common ailments 
such as cold, headache , acne etc. The materials are common household wisdom in 
various parts of the world but the ingredients may or may be found in your place.

DISCLAIMER: This Application is built for educational/informational purposes												only and Author takes no responsibility for any of the content in the application
and is no way responsible for any impact caused physically or otherwise to the end
user. All medical ailments needs to be treated by trained medical professional only
and this application is not a substitute for professional treatment/medication.The
remedies contained herein are not FDA approved. This software is provided 'AS IS' and
developer assumes no liability for any consequences arising out of usage of software.


Features of the project:
------------------------

Currently working features of the application:

 -Displays a list of ailments for the user to select.
 -Upon selection of ailment by user, remedy for the selected ailment is shown.
 -User has the option of increasing/decreasing the font size of the remedy 
  according to their convinence upon selecting the remedy.
 -Users can bookmark/"mark as favorite" a remedy for quick access.
 -Favorite remedies option provides the flexibility to the user to look at only his favorite
  remedies rather than the whole list of ailments
 -Users can share the market link of the application or one specific remedy with their 
  friends/family through email feature provided.
 -User can browse through all the remedies one after the another through 
  previous/next links provided for easy access.
 -Search box provided for the list of ailments for faster search of the 
  ailment from long list of ailments.
 -Users can submit their own remedies inorder to share them among other 
  users of the same application.
 -Users can view the list of remedies submitted by other users to the QUASOR server and 
  view them on their phone

Future Enhancements

 -User Interface enhancements.
 -Right now, if user wants to add a remedy he/she can add remedy for only a fixed list of ailments. 
  So, need to work on giving option to add remedy for any ailment.
 -Talk to expert regarding their ailment to get some opinion through chat feature.
 -Login facility so that users can only enter their remedy if they are registered users inorder to 
  reduce spam.
 -Right now, application runs with dummy content, need to update remedy content.
 -For user submitted functionality, need to publish the server application.

NOTE: The application is still under testing phase so please let me know through email on email address 
provided above if some feature from currently working list is not working for you.
User submitted remedies feature won't be accessible to users as server needed for same is not yet published.

Platform:
---------
Android device with version (2.2). Testing this application on newer version of android 
is in progress.I will update the information as soon as the testing is completed.

Installation:
-------------
Please read "INSTALL.txt" located at below location:

https://github.com/saijpaul/Quasor

for complete instructions on how to install and use this application by users(Developer or EndUser). 


Step-by-Step guide on how to Use the application:
-------------------------------------------------

1.) Install the application.
2.) On running the application you will get to the "Disclaimer". You can only enter the application if 
    you agree with the conditions written on disclaimer and press on "I Agree".
3.) Once you enter the application, you will get the main screen of the application with a list of ailments.
    You can perform one of the following functions on this screen:
    a) If you want to look at the remedy of an ailment from the list of ailments, just click on the ailment 
       name and you would be taken to the screen with the remedy.
       
       Once you reach the screen with remedy, you can perform following functions:
        
       (i) Click on the Home image will take you to the previous screen.
       (ii)Click on the Share Remedy image will open up email functionality from which users can send mail 
	   to their family/friends.
       (iii) Previous/Next arrow images to go forward or backward in remedies.
       (iv)  Favorite image, click on the image to mark the remedy as your favorite remedy.
       
    b) Click on Your favorite Remedies image to see the listing of you favorite remedies.

	Once you reach the screen with ailment list, you can perform following functions:

	(i) If you want to remove some remedies from you list of favorite remedies then
	    click on the checkbox and press Remove Remedy Image.
	
	Rest functionality of this screen is same as that of initial screen with list of ailments.

    c) Share the link of the application through email by clicking on share the app image.
    d) Click on user submitted remedies image to look at the remedies submitted by other users of the 
       same application.

	Once you reach the screen with user submitted remedies, you can perform following functions:
	(i) Click on the ailment to look at all the remedies provided by different users under that ailment.
	(ii)Click on Add Remedy button to share your own remedy with all the other users of the application.

    e) Enter the name of the ailment you want to see in the box provided and click OK image when you have finished 
       searching.You will see the ailment whose name you provided in the list. 


License Information:
--------------------
This application is licensed under GPLv3. Please read "LICENSE.txt" for full version of the license terms 
and conditions located at: https://github.com/saijpaul/Quasor 

Attributions:
-------------
I am very grateful to all the people who have done the hardwork to create images & write code samples.

For images:

http://commons.wikimedia.org - Special thanks to Ben Clough(background) and Luc Viatour(front image, link to the website www.lucnix.be)
http://www.artua.com(HOME)
http://www.hadibe.com(NEXT,PREVIOUS)
http://www.ahmad-hania.wateentech.com(EMAIL)

AUTHORS(HAND SHARE)
1	Ulisse Perusin <uli.peru@gmail.com>
2	Riccardo Buzzotta <raozuzu@yahoo.it>
3	Josef Vybíral <cornelius@vybiral.info>
4	Hylke Bons <h.bons@student.rug.nl>
5	Ricardo González <rick@jinlabs.com>
6	Lapo Calamandrei <calamandrei@gmail.com>
7	Rodney Dawes <dobey@novell.com>
8	Luca Ferretti <elle.uca@libero.it>
9	Tuomas Kuosmanen <tigert@gimp.org>
10	Andreas Nilsson <nisses.mail@home.se>
11	Jakub Steiner <jimmac@novell.com>524

Dapino Webdesign, http://www.dapino-colada.nl(MEDICAL KIT)

http://www.dellustrations.com(SHARE)

http://www.openclipart.org(FAVORITE FOLDER) by jose hevia

http://www.openclipart.org(FAVORITE PLUS) by jean_victor_balin and warszawianka

http://www.openclipart.org(FAVORITE MINUS) by jhnri4 and warszawianka
 
FOR CODE SAMPLES:

http://developer.android.com/index.html
http://www.helloandroid.com/tutorials/connecting-mysql-database
http://www.reigndesign.com/blog/using-your-own-sqlite-database-in-android-applications/