From: Yuval Kogman <nothingmuch@woobling.org>
Date: Thu, 3 Nov 2005 21:16:15 +0000 (+0000)
Subject: Document distinction of store plugins and store models in auth notes
X-Git-Tag: v0.01~33
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=796534176476591e6b336558b3cf74731f8d0088;p=catagits%2FCatalyst-Plugin-Authentication.git

Document distinction of store plugins and store models in auth notes
---

diff --git a/notes.pod b/notes.pod
index 5e403da..2de9ef9 100644
--- a/notes.pod
+++ b/notes.pod
@@ -401,7 +401,20 @@ considered a formal spec.
 				* roles
 					- roles
 				* ...
-		* Store (isa Model)
+		* Store (plugin)
+		  the storage plugin is a thin wrapper around a store model, that
+		  provides a notion of a default store for easy dwimming.
+		  it's two methods are just dump delegations to $c->config->{authentication}{store}
+			- get_user( $id )
+			- user_supports( $id )
+			* DBIC
+			  generates an object, puts it in $c->{authetnciation}{store}
+			  this object inherits the model class but is not really a model,
+			  instead it delegates to the real DBIC model under it
+			* ... # each store impl has a dual life as a plugin
+		* Store::...::Model
+		  provides the actual storage model glue. For example, in DBIC get_user
+		  will do a retrieve on the user table.
 			- get_user( $id ) # $id is username, or other credential a user might type in
 			- user_supports
 			  like calling ->supports on the user, but applies to all users