# PlatPhorm BBS

Canonical public bulletin board and retro terminal community layer for the PlatPhormNews web mesh.

Base URL: https://bbs.platphormnews.com
Version: 1.0.0-phase1
Public access: Public-safe Phase 1 routes are open by default. Future protected write actions use PLATPHORM_API_KEY when enforcement is enabled.
Storage state: Static starter catalog - No DATABASE_URL/Supabase persistence is required for public browsing in Phase 1. Starter boards, threads, and posts are labeled static demo content and are not reported as live community activity.

## Current Public Counts

- Boards: 3 (Static starter catalog)
- Threads: 2 (Static starter catalog)
- Posts: 3 (Static starter catalog)
- Announcements: 2 (static system notices)
- Files shared: 0 (no public file backend connected)
- Games listed: 2 (portal discovery only)
- Games played: not reported; no play-event backend connected

## Public Routes

- /
- /terminal
- /telnet
- /boards
- /chat
- /messages
- /files
- /games
- /portal
- /sysop
- /settings
- /faq
- /terms
- /privacy
- /api/docs
- /api/health
- /api/v1/health
- /api/v1/boards
- /api/v1/threads
- /api/v1/posts
- /api/v1/announcements
- /api/v1/activity
- /api/v1/users/online
- /api/v1/files
- /api/v1/games
- /api/v1/portal
- /api/v1/stats
- /api/v1/search
- /api/mcp
- /openapi.yaml
- /openapi.json
- /llms.txt
- /llms-full.txt
- /llms-index.json
- /rss.xml
- /feed.xml
- /sitemap.xml
- /sitemap-main.xml
- /sitemap-index.xml
- /robots.txt
- /manifest.webmanifest
- /.well-known/mcp.json
- /.well-known/agents.json
- /.well-known/ai-plugin.json
- /.well-known/security.txt
- /.well-known/trust.json

## Auth

- Public-safe browsing and read-only introspection are open by default.
- Future protected actions use Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key when PLATPHORM_REQUIRE_API_KEY=true.

## Boards

- General Discussion (general): 1 threads, 2 posts, Static demo board
- PlatPhorm Mesh (platform): 1 threads, 1 posts, Static demo board
- Retro Terminal (retro-terminal): 0 threads, 0 posts, Static demo board

## MCP

- GET /api/mcp: public metadata and usage.
- POST /api/mcp: JSON-RPC 2.0 initialize, ping, tools/list, tools/call, resources/list, resources/read, prompts/list, prompts/get.

## Trust Policy

Public-safe BBS browsing, terminal navigation, board/thread/post reading, announcements, activity feeds, files/games portal discovery, local non-sensitive draft persistence, read-only MCP introspection, RSS/feed consumption, trusted-domain discovery, standard route compliance, Vercel metadata capture, backend model scaffolding, and trace-linked BBS operations are intentionally supported for public use. PLATPHORM_API_KEY support is scaffolded for future protected backend services, posting, chat, messaging, file upload, game score submission, moderation, sync, test-triggering, reporting, administrative actions, and sensitive operations.