Update documentation to reflect Djarea's RPC architecture

- Root README: full quick start, architecture diagram, feature table,
  code generation workflow, error handling, forms, channels, testing
- Django README: setup, auth variations, contexts, forms, channels
- React README: clarify that generated hooks are the API (not library
  primitives), DjangoContext is the only provider needed, sub-exports
  are internals

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

django/README.md

@@ -1,29 +1,105 @@
-# djarea
+# djarea (Python)
 
-Django + React server functions framework. See the [monorepo root](../README.md) for full documentation.
+Django server functions framework. See the [monorepo root](../README.md) for full documentation.
 
-## Installation
+## Install
 
 ```bash
-# From git
 uv add "djarea[channels,allauth] @ git+https://git.impactsoundworks.com/isw/djarea.git#subdirectory=django"
-
-# Local editable
-uv add -e "../../web/djarea/django[channels,allauth]"
 ```
 
-## Quick Start
+## Setup
+
+```python
+# settings.py
+INSTALLED_APPS = ["djarea", ...]
+
+# urls.py
+path("api/djarea/", include("djarea.urls"))
+
+# asgi.py (optional, for WebSocket)
+from djarea import wrap_asgi
+application = wrap_asgi(get_asgi_application())
+```
+
+## Define Functions
 
 ```python
 from djarea.client import client
+from djarea.setup.registry import register
 from pydantic import BaseModel
 
-class UserOutput(BaseModel):
-    email: str
+class Output(BaseModel):
+    message: str
 
-@client(context='global')
-def current_user(request) -> UserOutput | None:
-    if not request.user.is_authenticated:
-        return None
-    return UserOutput(email=request.user.email)
+@client
+def echo(request, text: str) -> Output:
+    return Output(message=text)
+
+register(echo, "echo")
+```
+
+Register in `apps.py`:
+
+```python
+def ready(self):
+    import myapp.djarea_clients
+```
+
+## Auth
+
+```python
+@client(auth=True)          # requires authentication
+@client(auth='staff')       # requires is_staff
+@client(auth='superuser')   # requires is_superuser
+@client(auth=my_callable)   # custom check
+```
+
+## Contexts
+
+```python
+@client(context='global')   # fetched once, SSR-hydrated, becomes useCurrentUser()
+@client(context='local')    # fetched with params, becomes <GreetProvider>
+```
+
+## Forms
+
+```python
+from djarea.forms import DjareaFormMixin, DjareaFormMeta
+
+class ContactForm(DjareaFormMixin, forms.Form):
+    djarea = DjareaFormMeta(name="contact", title="Contact Us")
+    name = forms.CharField()
+    email = forms.EmailField()
+
+    def on_submit_success(self, request):
+        return {"sent": True}
+```
+
+Auto-registers `contact.schema`, `contact.validate`, `contact.submit`. Generates `useContactForm()` with Zod validation.
+
+## Channels
+
+```python
+from djarea.channels import ReactChannel
+
+class ChatChannel(ReactChannel):
+    class Params(BaseModel):
+        room: str
+    class DjangoMessage(BaseModel):
+        text: str
+
+    def authorize(self, params):
+        return self.user.is_authenticated
+    def group(self, params):
+        return f"chat_{params.room}"
+```
+
+Generates `useChatChannel({ room })`.
+
+## Running Tests
+
+```bash
+uv sync --extra dev --extra channels
+uv run pytest
 ```