blob: 931fca315d82328c5981c946008f281c4d7db07d [file] [log] [blame]
#summary The User entity model
#labels Phase-Design,Contents-Skeleton,Design-Model
The User entity stores a single private user email address and login
credentials in the [http://code.google.com/appengine/docs/datastore/
Datastore]. The User
[http://code.google.com/appengine/docs/datastore/entitiesandmodels.html#The_Model_Interface Model] currently contains only a single
[http://code.google.com/appengine/docs/datastore/typesandpropertyclasses.html#UserProperty UserProperty].
It is important to keep in mind that a given User can have more than one
[UserRoles role] at a time in a given Program and can also participate in more
than one Program. Contrast this with the [PersonModel Person entity] which
can only participate in a single Program.
_*Eventually, this topic should be populated by the output of*_ `pydoc`.
{{{
class User(db.Model):
"""A user and associated login credentials, the fundamental identity entity.
User.id is a Google Account, which also provides a "private" email address.
User is a separate Model class from Person because the same login ID may be
used to, for exmaple, serve as Contributor in one Program and a Reviewer in
another.
Also, this allows a Person to, in the future, associate that Person entity
with a different Google Account if necessary.
A User entity currently participates in only a single relationship:
persons) a 1:many relationship of Person entities identified by the
User. This relation is implemented as the 'persons' back-reference
Query of the Person model 'user' reference.
"""
id = db.UserProperty(required=True)
}}}
----
_Copyright 2008 Google Inc._
_This work is licensed under a_
[http://soc.googlecode.com/svn/wiki/html/licenses/cc-by-attribution-2_5.html Creative Commons Attribution 2.5 License].
[http://creativecommons.org/licenses/by/2.5/ http://soc.googlecode.com/svn/wiki/html/licenses/cc-by-2_5-88x31.png]