# ordo-desk — своя система ведения проектов

> Этот файл подгружается автоматически, когда сессия работает с файлами в `/home/meteor/apps/ordo-desk/`.
> Он — точка входа: что это за проект, где спека, где прототип, какие решения уже приняты.

## Что это

Собственная мультитенантная система ведения проектов: аккаунт (тенант) → проекты → задачи,
документы, базы, финансы. Заменяет связку Notion + Todoist + Apple Notes. Планируется на
домене **ordo.ins.is**. Кода пока нет — есть спецификация и кликабельный прототип интерфейса.

## Где что лежит

| Файл | Что внутри |
|---|---|
| `docs/01-context-and-decisions.md` | Путь решений: почему не Huly, почему не форк, почему не AppFlowy, почему своё |
| `docs/02-spec.md` | **ТЗ**: модель данных, виды баз, документы, права, API + MCP, поиск, шорткаты, PWA, десктоп, фазы работ |
| `docs/03-design-system.md` | Дизайн-система: токены, типографика, компоненты, иконки, паттерны |
| `/home/meteor/sites/ordo-proto/public/index.html` | **Исходник прототипа** (source of truth, один файл) |
| `/home/meteor/apps/ordo/specs/2026-08-14-project-over-spaces-design.md` | Спека форка Huly — **отвергнутый путь**, оставлен для истории |

Живой прототип: **https://ordo-proto.sites.meteor.group** (noindex, публичный URL без авторизации).

## Как обновить прототип

```bash
# правим один файл
$EDITOR /home/meteor/sites/ordo-proto/public/index.html
# выкладываем
docker exec meteor-api-1 node dist/scripts/site-sync.js ordo-proto
```

Папка `/home/meteor/sites/ordo-proto/` — источник истины, синк затирает всё остальное.
Подробности механики статических сайтов — `/home/meteor/sites/CLAUDE.md`.

## Принятые решения, которые не надо переоткрывать

1. **Пишем своё приложение**, не форкаем Huly и не берём AppFlowy как движок. Обоснование —
   в `docs/01-context-and-decisions.md`, там цифры по замедлению апстрима и по лицензиям.
2. **Проект — главная сущность**, всё цепляется к нему. Метка — про состояние, а не про тему.
3. **Заметки хранятся markdown-файлами** (зеркало в git), база — индекс для поиска и связей.
4. **API-first**: интерфейс и агент Hermes ходят через один и тот же JSON API, MCP — обёртка над ним.
5. **Редактор не пишем**: BlockNote/TipTap. Своё — только блок «База» внутри документа.
6. **Ordo (Huly) остаётся работать параллельно** как запасной аэродром, пока не переедет первый проект.

## Стиль работы

- Прототип — это спецификация в картинках. Любое изменение интерфейса сначала в прототипе, потом в `docs/02-spec.md`.
- Русский язык в интерфейсе и документах, кроме имён полей в схеме БД.
- Не заводить справочник людей и контактов — сознательное решение владельца.