.. -*- coding: utf-8 -*-

Pre-defined schemas in the library

----------------------------------

The library defines a set of entities schemas that are required by the system

or commonly used in `LAX` applications.

Of course, you can extend those schemas if necessarry.

System schemas

``````````````

Those are defined in::

  ./myapp/ginco/schemas/

  ./myapp/ginco/entities/

``schemas/`` defines the data model you will use in your application. 

It allows you to describre the entities and the relations you will need.

``entities/`` deifnes the methods you might need on the entities you 

defined in your schema.

The system entities available are:

* `EUser`, system users

* `EGroup`, users groups

* `EEType`, entity type

* `ERType`, relation type

* `State`, workflow state

* `Transition`, workflow transition

* `TrInfo`, record of a transition trafic for an entity 

* `EmailAddress`, email address, used by the system to send notifications

  to the users and also used by others optionnals schemas

* `EProperty`, used to configure the application

* `EPermission`, used to configure the security of the application

* `Card`, generic documenting card

* `Bookmark`, an entity type used to allow a user to customize his links within

  the application

Components in the library

`````````````````````````

Those are defined in::

  ./myapp/ginco-apps/

An application is based on several basic components. In the set of available

basic components we can find by example:

* `ecomment`, provides an entity type for `Comment` allowing us to comment others

  site's entities

* `emailinglist`, provides an entity type for `Mailinglist` which groups informations

  in a discussion list

* `efile`, provides entity types for `File` et `Image` used to represent

  files (text or binary) with additionnal informations such as MIME type or

  encoding.

* `elink`, provides an entity type for hypertext link (`Link`)

* `eblog`, provides an entity type weblog (`Blog`)

* `eperson`, provides an entity type for a person (`Person`)

* `eaddressbook`, provides an entity type used to represent phone 

  numbers (`PhoneNumber`) and mailing address (`PostalAddress`)

* `eclasstags`, categorization system based on tags (`Tag`)

* `eclassfolders`, categorization system based on folders hierarchy in order 

  to create navigation sections (`Folder`)

* `eemail`, archiving management for emails (`Email`, `Emailpart`,

  `Emailthread`)

* `ebasket`, basket management (`Basket`) allowing to group entities

To declare the use of a component, once installed, add the name of the component

to the variable `__use__` in the file `__pkginfo__.py` of your own component.