# Silos

A collaborative workspace platform — your knowledge, your team, one place.

## Tech Stack

- **Frontend:** React + TypeScript + Tailwind CSS
- **Backend:** FastAPI + SQLAlchemy
- **Database:** PostgreSQL (users, auth) + MongoDB (whiteboards, sketches)

## Quick Start

### 1. Start databases

```bash
docker compose up -d
```

### 2. Backend

```bash
cd backend
copy .env.example .env
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000
```

### 3. Frontend

```bash
cd frontend
npm install
npm run dev
```

- Landing page: [http://localhost:5173](http://localhost:5173)
- Login page: [http://localhost:5173/login](http://localhost:5173/login)
- API docs: [http://localhost:8000/docs](http://localhost:8000/docs)

## Project Structure

```
Silos/
├── frontend/     # React + Tailwind
├── backend/      # FastAPI
└── docker-compose.yml
```

## Feature Progress

### Phase-wise Confluence-inspired platform roadmap

The platform is being delivered in focused phases so each collaboration and
content-management capability is usable before the next layer is added.

#### Phase 1 — Page hierarchy and lifecycle foundation (complete)

- Added `parent_page_id` to document creation, updates, responses, and frontend
  document records.
- Added parent validation so a page cannot parent itself, attach to an
  inaccessible page, or attach directly to a space as a page parent.
- Added child-page creation from the current page.
- Added hierarchical sidebar navigation with expand/collapse behavior.
- Added a three-dot page actions menu with child-page creation, duplication,
  archive, permanent delete, and close actions.
- Archived pages are excluded from normal dashboard and space navigation.
- Existing space membership, sharing, and explicit Edit → Update → Publish
  behavior remain intact.

Validation completed:

- `cd frontend && npm run build`
- `python -m compileall backend\app`

#### Phase 2 — Templates and page creation flows (complete)

- Added reusable Silo page templates for blank pages, meeting notes, project
  plans, and how-to guides.
- Added page-template creation to the global Create menu.
- Updated the Templates flyout to use the same shared page-template definitions.
- New pages created inside a space preserve the space relationship.
- New pages created from a page context preserve the parent-child relationship.
- Added a Confluence-inspired inline `+` action beside each Silo page in the
  sidebar. It creates a child page under that page and opens it immediately.

Validation completed:

- `cd frontend && npm run build`
- `python -m compileall backend\app`

#### Phase 3 — Sidebar page management and richer creation flows (complete)

- Replicated the Confluence-inspired sidebar hierarchy treatment with
  disclosure arrows for parent pages and bullet markers for leaf/child pages.
- Added inline child-page `+` controls beside page names.
- Added per-page three-dot menus with Edit, Rename, Star, Copy link, Make a
  copy, Move, Archive, and Delete actions.
- Added inline page renaming with Enter/save behavior.
- Added a Move page dialog with top-level placement and parent-page selection.
- Prevented moving a page below itself or one of its descendants.
- Added shared styling for the sidebar page-action menu.

Validation completed:

- `cd frontend && npm run build`
- `python -m compileall backend\app`

#### Phase 4 — Collaboration foundation (complete)

- Added persisted comments for accessible documents.
- Added threaded-comment parent validation at the API boundary.
- Added author-only comment deletion.
- Added a page-level Comments panel with loading, empty, error, create, and
  delete states.
- Reused existing document sharing and editor/viewer permissions for comment
  access.
- Added a comments entry point beside the page Edit/Update/Publish controls.
- Added MongoDB indexes for document comment retrieval.

Validation completed:

- `cd frontend && npm run build`
- `python -m compileall backend\app`

#### Phase 5 — User-authored templates and categories (complete)

- Added owner-scoped persisted templates in MongoDB.
- Added template categories, descriptions, emoji labels, and starter content.
- Added template CRUD endpoints under `/api/v1/templates`.
- Added template indexes and authenticated ownership checks.
- Added a Templates flyout flow for creating, filtering, using, and deleting
  user templates.
- Custom templates create new Silo pages while preserving their starter
  content and draft state.

Validation completed:

- `cd frontend && npm run build`
- `python -m compileall backend\app`

#### Phase 6 — Template sharing and placement selection (complete)

- Added owner-controlled template sharing by email or username.
- Shared templates are included in the authenticated template library.
- Added a template sharing dialog with explicit dismissal.
- Added placement selection for pages created from custom templates:
  top-level, selected space, or selected parent page.
- Preserved the existing hierarchy and document-access validation path for
  placement targets.

Validation completed:

- `cd frontend && npm run build`
- `python -m compileall backend\app`

#### Phase 7 — Collaboration expansion (complete)

- Added `@username` mention parsing against registered users.
- Added persisted mention notifications with unread/read state.
- Added a workspace notification bell and notification dropdown.
- Added persisted page activity entries for comment creation and
  comment resolution/reopening.
- Added an Activity view alongside the Comments panel.
- Added nested threaded replies using the existing `parent_id` model.
- Added resolve/reopen controls with access-checked API mutations.
- Preserved the existing WebSocket collaboration presence and live content
  channel, including peer updates when users join or leave.

Validation completed:

- `cd frontend && npm run build`
- `python -m compileall backend\app`
- FastAPI application import and route registration

#### Phase 8 — History, publishing, and operational polish (complete)

- Added persisted document version snapshots before content/title updates.
- Added version history listing and access-controlled restore.
- Added HTML and plain-text page export endpoints and page controls.
- Added keyboard save (`Ctrl/Cmd+S`) and Escape dismissal for history.
- Added accessible names, live editor status, history labels, and notification
  controls.
- Preserved the existing MongoDB text index and access-aware search behavior.
- Added three Playwright browser regression specs covering history, export, and
  keyboard/accessibility journeys.
- Added `npm run test:e2e` and `runtime-validation-report.md`.

Validation completed:

- `cd frontend && npm run build`
- `python -m compileall backend\app`
- FastAPI application import and route registration
- `cd frontend && npm run test:e2e` (3 tests skipped without test credentials)

### Dashboard onboarding

- Returning users see recent documents ordered by their last visited activity.
- New users see a getting-started panel instead of blank Recent and Activity sections.
- New users can browse templates, create a page, create a whiteboard, or create a space.

### Pages and whiteboards

- Pages and whiteboards open in read-only mode after login or re-login.
- Users must select **Edit** before changing content or titles.
- **Update** explicitly saves the current draft and returns the document to read-only mode.
- **Publish** saves the page or whiteboard and marks it as published.
- Page editing includes active Bold, Italic, Underline, and strikethrough states; paragraph/heading/quote/code styles; ordered and unordered lists; left/center/right alignment; an expanded text and highlight colour palette; grouped searchable emoji picker; styled tables; tabs; info panels; mentions; links; image/video URL insertion; and image file upload.
- Formatting selections are preserved when a toolbar control or popover is clicked. Link, media, colour, emoji, insert, and slash-command windows close when the user clicks elsewhere or presses Escape.
- Whiteboards retain their existing drawing, selection, table, text, sticky-note, pan, zoom, undo, and redo tools while preventing mutations until Edit is selected.

The frontend build is verified with:

```bash
cd frontend
npm run build
```