# Soado Boards (Full Context)

> Soado Boards is a collaborative web platform for creating digital group message boards. Owners create a board, share a public link, collect text and image messages, moderate publication, enable reactions, present messages in multiple display modes, and export outcomes to PDF.

This file is the long-form LLM context index for Soado. It complements `/llms.txt` and provides deeper operational and product context.

## Canonical Entry Points

- [Homepage](https://www.soado.com/): Product overview and acquisition entry.
- [Register](https://www.soado.com/register): Account creation.
- [Login](https://www.soado.com/login): Authentication entry.
- [Dashboard](https://www.soado.com/dashboard): Owner control center (auth required).
- [Admin Panel](https://www.soado.com/admin): Platform admin workspace (admin role required).

## Core Domain Model

### Users
- Identity and access object.
- Role values: `user`, `admin`.
- Typical lifecycle: register -> login -> create/manage boards.

### Boards
- Parent object for collaboration.
- Key behavior fields:
  - `status`: `Open` or `Closed`
  - `allow_media`: enable/disable image uploads
  - `allow_reactions`: enable/disable emoji reactions
  - `review_before_publish`: moderation gate for messages
  - `analytics_public`: controls public analytics visibility
  - `theme`, `color_scheme`: board appearance
- Public addressing uses a board slug: `{public_slug}`.

### Messages
- User-generated content items inside a board.
- Content: text + signature, optional image.
- Moderation lifecycle:
  - `pending`
  - `approved`
  - `hidden`
- Ordering and display:
  - `order_index`
  - optional visual `effect`

### Reactions
- Emoji interaction attached to messages.
- Session-scoped toggles (not account-scoped voting).
- Supported set: `👍`, `👏`, `😃`, `❤️`, `😆`, `🍪`.

### Analytics
- Event and session tracking for engagement measurement.
- Includes page views, contribution behavior, reaction events, referrer signals.
- Visibility controlled per board (`analytics_public`) with owner/admin override.

## Role and Permission Semantics

### Guest (Anonymous)
- Can open public board links.
- Can submit a message only if board is `Open`.
- Can react when reactions are enabled.
- No board management permissions.

### Registered User (Owner)
- Can create and delete own boards.
- Can edit board settings and appearance.
- Can moderate messages (approve/hide/edit/reorder/effects/delete).
- Can use presentation modes and export.
- Can view private analytics for own boards.


## Status Models

### Board Contribution Status
- `Open`: accepts new submissions.
- `Closed`: rejects new submissions.

### Message Moderation Status
- `pending`: waiting for owner review (when moderation is enabled).
- `approved`: visible to non-owner viewers.
- `hidden`: suppressed from non-owner view.

## Main User Workflows

### 1) Create and Share
1. Owner creates board from dashboard.
2. System generates public board URL (`/board/{public_slug}`).
3. Owner distributes link through external channels.

### 2) Contribute
1. Contributor opens board.
2. If `Open`, contributor submits message and optional image (if enabled).
3. Message enters moderation path:
- `pending` when review is enabled.
- `approved` when review is disabled.

### 3) Moderate and Curate
1. Owner reviews pending/visible content.
2. Owner can approve/hide/edit/delete messages.
3. Owner can reorder messages and apply display effects.

### 4) Present and Deliver
1. Owner switches to presentation mode.
2. Owner runs slideshow/carousel/post-it/envelope experiences.
3. Owner exports board artifact to PDF.

## Board and Presentation URLs

- [Board View](https://www.soado.com/board/{public_slug}): Primary reading and contribution surface.
- [Export Studio](https://www.soado.com/board/{public_slug}/export): Owner/admin export workspace.
- [Board Analytics](https://www.soado.com/analytics/{public_slug}): Engagement dashboard.
- [Slideshow](https://www.soado.com/slideshow/{public_slug}): Sequential full-screen message playback.
- [Presenter Carousel](https://www.soado.com/presenter/{public_slug}): 3D carousel presentation format.
- [Post-it Board](https://www.soado.com/postit/{public_slug}): Animated sticky-note wall format.
- [Envelope Mode](https://www.soado.com/envelope/{public_slug}): Envelope reveal experience.

## Public Content

- [About](https://www.soado.com/page/about-us)
- [Contact](https://www.soado.com/page/contact)
- [Privacy Policy](https://www.soado.com/page/privacy)
- [Terms of Service](https://www.soado.com/page/tos)
- [Occasion Page Example](https://www.soado.com/card/farewell)
- [Sitemap XML](https://www.soado.com/sitemap.xml)

## API Capability Index (High-Level)

### Auth
- Register
- Login
- Logout

### Boards
- Create board
- List owner boards
- Get board by slug with messages
- Update board settings
- Update board appearance
- Delete board

### Messages
- Create message (with optional media)
- Reorder messages
- Update message moderation/content/effect
- Delete message

### Reactions
- Toggle per-message reaction by session

### Analytics
- Page view event logging
- Board analytics retrieval
- Admin/global analytics retrieval

## Product Constraints and Operational Notes

- Mutating requests require CSRF token.
- Message text and signature length limits are enforced server-side.
- Media upload is policy-gated and validated server-side.
- Board share model is URL-based (no invite ACL model by default).
- Analytics visibility is board-configurable.
- Moderation is owner-centric in current model.


## Routing Patterns (Reference)

- `/`
- `/login`
- `/register`
- `/dashboard`
- `/admin`
- `/board/{public_slug}`
- `/board/{public_slug}/export`
- `/analytics/{public_slug}`
- `/slideshow/{public_slug}`
- `/presenter/{public_slug}`
- `/postit/{public_slug}`
- `/envelope/{public_slug}`
- `/page/{slug}`
- `/card/{slug}`
- `/sitemap.xml`

## Optional

- [llms.txt](https://www.soado.com/llms.txt): Minimal LLM index.