README.md

# Траектория / Восход

`trajectory-dev` — dev-workspace продукта **Восход**, первого пользовательского продукта внутри системы **Траектория**.

Траектория — это более широкая система и будущая продуктовая категория для работы с цифровой траекторией человека, группы или организации: событиями, решениями, обязательствами, заметками, отклонениями и следующими шагами.

Восход — week-first продукт, который помогает человеку под смешанной нагрузкой собрать понятную неделю, удержать фокус на ближайших шагах и мягко вернуться к управляемости после срыва, перегруза или смены обстоятельств.

Целевая формула runtime:

**timeline событий + один активный вопрос + один канал ответа + State Flow Machine + knowledge tree.**

## Документы

Документация разделена на два контура.

### Product contour

Пока не вынесен в отдельный каталог. Product doctrine и стратегическая память живут в текущем наборе `docs/*.md`, прежде всего:
- `docs/TRAJECTORY_NORTH_STAR.md`
- `docs/DECISIONS.md`
- `docs/ROADMAP.md`

### Development contour

Canonical docs живут в `docs/**/*.md`; отдельный bridge-каталог `docs/dev/` не используется.

Для Codex-managed разработки: техническая стратегия, roadmap программирования, доменная модель, статус реализации, testing/deploy and iteration memory.

Ключевые файлы:
- `docs/CONTEXT_INDEX.md`
- `docs/TECHNICAL_STRATEGY.md`
- `docs/DEVELOPMENT_LOOP.md`
- `docs/ROADMAP.md`
- `docs/PROJECT_STATUS.md`
- `docs/SYSTEM_MAP.md`
- `docs/DOMAIN_MODEL.md`
- `docs/TESTING.md`

Общая карта: `docs/README.md`.

Инструкции для Codex: `AGENTS.md`.

## Текущий stack

- Next.js App Router
- TypeScript
- Tailwind CSS
- Auth.js credentials auth
- Google Calendar OAuth integration
- Drizzle ORM + PostgreSQL
- bcryptjs
- date-fns and date-fns-tz

## Environments

- Dev repo: `$HOME/apps/trajectory-dev`
- Prod repo: `$HOME/apps/trajectory-prod`
- Dev DB: `trajectory_dev`
- Prod DB: `trajectory_prod`
- Dev public URL: `https://dev.journeyup.ru`
- Prod public URL: `https://journeyup.ru`
- Future analysis/admin contour: `https://analysis.journeyup.ru`

Dev and prod use separate folders, databases and `.env.local` files.

## Run dev

```bash
cd $HOME/apps/trajectory-dev
pnpm dev
```

Open:

- `http://127.0.0.1:3001`

## Checks

```bash
pnpm test
pnpm typecheck
pnpm lint
pnpm build
```

Full local check:

```bash
pnpm check
```

Public dev smoke:

```bash
scripts/smoke-public-dev.sh
```

Persistent browser profile for manual/Codex smoke:

```bash
scripts/open-dev-browser.sh
```

Detailed testing policy: `docs/TESTING.md`.

## Current implemented layer

High-level implemented runtime includes:
- auth and self-service registration;
- closed-beta access gating;
- public landing, login/register and protected runtime;
- projects, events, calendar views, boards;
- notes tree and note links;
- capture inbox and AI audit primitives;
- legacy tutorial runtime / target State Flow Machine flows and bounded write-through flows;
- Home v2 shell on `/dashboard`;
- Google Calendar preview/import/review/apply boundary plus one managed connect flow;
- owner-only operator/runtime diagnostics.

The source of truth for current implementation is `docs/PROJECT_STATUS.md` and `docs/SYSTEM_MAP.md`.