# go-learn — обучающий сайт по игре Го

**v0.3.1 · 2026-08-07** · статус: этапы 0–11 завершены; ручная приёмка v1 —
за владельцем (см. docs/PROJECT_STATE.md)

Интерактивный курс Го с нуля до ~10 кю + симулятор партии против ИИ.
Клиентский: статическая сборка на шаред-хостинг, движок и ИИ — в браузере;
опциональный бэкенд (личный кабинет, синхронизация прогресса) — PHP 8 + SQLite.
Язык сайта — русский. Без монетизации и сбора данных.

## Модули

| Пакет          | Назначение                                                      | Статус |
| -------------- | --------------------------------------------------------------- | ------ |
| packages/core  | Движок правил: доска, группы, ко/суперко, подсчёт, SGF, история | готово |
| packages/board | Отрисовка доски Canvas 2D: геометрия, рендер, тач-ввод          | готово |
| packages/ai    | ИИ: эвристика ур. 1–3, MCTS ур. 4–6 в Web Worker                | готово |
| apps/web       | Astro-сайт: курс, цумэ-го, /play, прогресс, кабинет             | готово |
| server         | Опциональный бэкенд PHP 8 + SQLite (кабинет, sync; этапы 8–8.1) | готово |

## Старт

```bash
npm install
npm run gates   # форматтер + линтер + типы + тесты
```

Требования: Node.js ≥ 20.

## Документация

- Точка входа для ИИ-агентов: AGENTS.md
- Состояние проекта: docs/PROJECT_STATE.md
- Контракты модулей: docs/INTERFACES.md
- Решения: docs/decisions/ (ADR)
- Методология: prestart-litany.md (read-only архив)

## Лицензия

MIT (LICENSE). Сторонние компоненты — THIRD_PARTY_LICENSES.md, цумэ-го и веса
сетей — CREDITS.md.