Update app READMEs for monorepo

Remove stale submodule references, port numbers, and Running sections.
Add fragment composition details. Create READMEs for federation and account.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

blog/README.md

@@ -1,39 +1,26 @@
 # Blog App (Coop)
 
-Blog, authentication, and content management service for the Rose Ash cooperative platform. Handles Ghost CMS integration, user auth, and admin settings.
-
-## Architecture
-
-One of five Quart microservices sharing a single PostgreSQL database:
-
-| App | Port | Domain |
-|-----|------|--------|
-| **blog (coop)** | 8000 | Auth, blog, admin, menus, snippets |
-| market | 8001 | Product browsing, Suma scraping |
-| cart | 8002 | Shopping cart, checkout, orders |
-| events | 8003 | Calendars, bookings, tickets |
-| federation | 8004 | ActivityPub, fediverse social |
+Content management, Ghost CMS sync, navigation, and the prose editor for the Rose Ash cooperative platform. Runs database migrations on startup and serves as the primary content hub.
 
 ## Structure
 
 ```
 app.py                  # Application factory (create_base_app + blueprints)
 path_setup.py           # Adds project root + app dir to sys.path
-config/app-config.yaml  # App URLs, feature flags, SumUp config
-models/                 # Blog-domain models (+ re-export stubs for shared models)
-bp/                     # Blueprints
-  auth/                 #   Magic link login, account, newsletters
-  blog/                 #   Post listing, Ghost CMS sync
+entrypoint.sh           # Container entrypoint (migrations, Redis flush, start)
+bp/
+  blog/                 #   Post listing, Ghost CMS sync, webhooks
   post/                 #   Single post view and admin
   admin/                #   Settings admin interface
   menu_items/           #   Navigation menu management
   snippets/             #   Reusable content snippets
-templates/              # Jinja2 templates
+  fragments/            #   nav-tree fragment for cross-app navigation
+models/                 # Re-export stubs pointing to shared/models/
 services/               # register_domain_services() — wires blog + calendar + market + cart
-shared/                 # Submodule -> git.rose-ash.com/coop/shared.git
+templates/              # Blog-specific templates (override shared/)
 ```
 
-## Cross-Domain Communication
+## Cross-domain communication
 
 All inter-app communication uses typed service contracts (no HTTP APIs):
 
@@ -41,20 +28,14 @@ All inter-app communication uses typed service contracts (no HTTP APIs):
 - `services.market.*` — marketplace queries via MarketService protocol
 - `services.cart.*` — cart summary via CartService protocol
 - `services.federation.*` — AP publishing via FederationService protocol
-- `shared.services.navigation` — site navigation tree
 
-## Domain Events
+## Fragments served
 
-- `auth/routes.py` emits `user.logged_in` via `shared.events.emit_event`
-- Ghost sync emits `post.published` / `post.updated` for federation
+- **nav-tree** — site navigation tree, fetched by all other apps
 
-## Running
+## Fragments consumed
 
-```bash
-export DATABASE_URL_ASYNC=postgresql+asyncpg://user:pass@localhost/coop
-export REDIS_URL=redis://localhost:6379/0
-export SECRET_KEY=your-secret-key
-
-alembic -c shared/alembic.ini upgrade head
-hypercorn app:app --bind 0.0.0.0:8000
-```
+- **cart-mini** (from cart) — cart icon + badge
+- **auth-menu** (from account) — sign-in / user menu
+- **container-nav** (from events, market) — sidebar widgets
+- **container-cards** (from events) — event cards on listing pages