Стандарт: Архитектура организации

┌─────────────────────────────────────────────────────────────────────┐
│                                                                     │
│   ИЗМЕРЕНИЕ 1: ТИП ОРГАНИЗАЦИИ                                     │
│   ─────────────────────────────                                     │
│   Для кого/зачем существует организация                            │
│                                                                     │
│   ┌────────────┬────────────┬────────────┐                         │
│   │  personal  │  nonprofit │ commercial │                         │
│   │ (для себя) │(для пользы)│(для прибыли│                         │
│   └────────────┴────────────┴────────────┘                         │
│                                                                     │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│   ИЗМЕРЕНИЕ 2: СЛОЙ АРХИТЕКТУРЫ                                    │
│   ─────────────────────────────                                     │
│   Какой аспект организации описывается                             │
│                                                                     │
│   ┌───────────┬──────────┬──────┬─────────────┬────────────┐       │
│   │ MOTIVATION│ BUSINESS │ DATA │ APPLICATION │ TECHNOLOGY │       │
│   │  (зачем)  │  (кто)   │(что) │   (чем)     │   (где)    │       │
│   └───────────┴──────────┴──────┴─────────────┴────────────┘       │
│                                                                     │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│   ИЗМЕРЕНИЕ 3: УРОВЕНЬ МАСШТАБА                                    │
│   ─────────────────────────────                                     │
│   Степень детализации / размер сущности                            │
│                                                                     │
│   ┌──────────────┬─────────────┬──────────┬──────────┐             │
│   │ Организация  │ Направление │ Единица  │ Элемент  │             │
│   │    (L1)      │    (L2)     │   (L3)   │   (L4)   │             │
│   └──────────────┴─────────────┴──────────┴──────────┘             │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

type: personal
characteristics:
  owner: "Один человек"
  stakeholders: "Только владелец"
  governance: "Полная автономия"
  metrics: "Личная удовлетворённость"
  lifecycle: "Пока интересно"

examples:
  - "Личная база знаний (PKM)"
  - "Конфигурации (dotfiles)"
  - "Учебные проекты"
  - "Хобби-проекты"
  - "Персональный блог"

type: nonprofit
characteristics:
  owner: "Учредители / сообщество"
  stakeholders: "Участники, благополучатели, доноры"
  governance: "Устав, правление"
  metrics: "Социальный эффект"
  lifecycle: "Пока есть миссия и ресурсы"

examples:
  - "Open-source проект"
  - "Благотворительный фонд"
  - "Профессиональная ассоциация"
  - "Клуб по интересам"
  - "Образовательная инициатива"

type: commercial
characteristics:
  owner: "Учредители / акционеры"
  stakeholders: "Клиенты, сотрудники, инвесторы, партнёры"
  governance: "Юридическая форма, договоры"
  metrics: "Выручка, прибыль, ROI"
  lifecycle: "Пока прибыльно или перспективно"

examples:
  - "Интернет-магазин"
  - "SaaS-сервис"
  - "Консалтинговая компания"
  - "Производство"
  - "Франшиза"

┌─────────────────────────────────────────────────────────────────────┐
│                                                                     │
│                         MOTIVATION                                  │
│                    ─────────────────────                            │
│                 Почему? Зачем? (смысл, цели)                       │
│           Миссия, видение, стратегия, ценности                     │
│                                                                     │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│                          BUSINESS                                   │
│                    ─────────────────────                            │
│              Кто? Как? (процессы, роли)                            │
│       Оргструктура, процессы, операции, регламенты                 │
│                                                                     │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│                            DATA                                     │
│                    ─────────────────────                            │
│                   Что? (данные, сущности)                          │
│         Модели данных, справочники, хранилища                      │
│                                                                     │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│                        APPLICATION                                  │
│                    ─────────────────────                            │
│            Чем? (софт, системы, автоматизация)                     │
│         Приложения, сервисы, интеграции, API                       │
│                                                                     │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│                        TECHNOLOGY                                   │
│                    ─────────────────────                            │
│           Где? (инфраструктура, железо, сети)                      │
│         Серверы, хранилища, сети, датацентры                       │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

MOTIVATION
    │
    │ определяет цели для
    ▼
BUSINESS ◄─────────────────────► DATA
    │                              │
    │ использует                   │ хранит
    ▼                              ▼
APPLICATION ◄──────────────────────┘
    │
    │ работает на
    ▼
TECHNOLOGY

L1: Компания (100%)
    │
    ├── L2: Розница (40%)
    ├── L2: Опт (35%)
    └── L2: Маркетплейсы (25%)
              │
              ├── L3: OZON (60%)
              ├── L3: Wildberries (30%)
              └── L3: Яндекс.Маркет (10%)

Для любой сущности проверить:

□ ПОЧЕМУ?   — причина/проблема понятна
□ ЗАЧЕМ?    — цель определена
□ ЧТО?      — сущность описана
□ КТО?      — участники известны
□ КАК?      — способ определён
□ ЧЕМ?      — ресурсы известны
□ ГДЕ?      — место определено
□ КОГДА?    — время установлено
□ СКОЛЬКО?  — метрики заданы

Если на какой-то вопрос нет ответа — описание неполное.

{organization}/
│
├── index.yaml                       ← Метаданные организации
├── CLAUDE.md                        ← Контекст для AI
│
├── motivation/                      ← СЛОЙ: МОТИВАЦИЯ
│   ├── VISION.md                    ←   Миссия и видение
│   ├── STRATEGY.md                  ←   Стратегия
│   ├── goals/                       ←   Цели
│   │   ├── {goal-1}/
│   │   │   ├── index.yaml
│   │   │   └── tasks/               ←   Задачи цели
│   │   └── {goal-2}/
│   └── metrics/                     ←   KPI/OKR
│       └── kpi.yaml
│
├── business/                        ← СЛОЙ: БИЗНЕС
│   ├── structure/                   ←   Оргструктура
│   │   └── org-chart.md
│   ├── {direction-1}/               ←   Направление
│   │   ├── index.yaml
│   │   ├── CLAUDE.md
│   │   ├── processes/               ←   Процессы
│   │   │   ├── {process-1}.md
│   │   │   └── {process-2}.md
│   │   └── roles/                   ←   Роли
│   │       └── {role}.md
│   ├── {direction-2}/
│   └── operations/                  ←   Текущие операции
│       └── runbooks/
│
├── data/                            ← СЛОЙ: ДАННЫЕ
│   ├── schema/                      ←   Общая схема
│   │   └── erd.md
│   ├── {domain-1}/                  ←   Домен
│   │   ├── index.yaml
│   │   ├── {entity-1}.md            ←   Сущность
│   │   └── {entity-2}.md
│   ├── {domain-2}/
│   └── dictionaries/                ←   Справочники
│       └── {dictionary}.yaml
│
├── app/                             ← СЛОЙ: ПРИЛОЖЕНИЯ
│   ├── landscape.md                 ←   Обзор систем
│   ├── {system-1}/                  ←   Система
│   │   ├── index.yaml
│   │   ├── CLAUDE.md
│   │   ├── design/                  ←   Архитектура
│   │   ├── {service-1}/             ←   Сервис
│   │   │   ├── index.yaml
│   │   │   └── src/                 ←   Код
│   │   └── {service-2}/
│   ├── {system-2}/
│   └── shared/                      ←   Общие библиотеки
│       └── {library}/
│
├── infra/                           ← СЛОЙ: ИНФРАСТРУКТУРА
│   ├── topology.md                  ←   Топология
│   ├── {cluster-1}/                 ←   Кластер
│   │   ├── index.yaml
│   │   ├── {server-1}/              ←   Сервер
│   │   │   └── config/
│   │   └── {server-2}/
│   ├── {cluster-2}/
│   ├── network/                     ←   Сети
│   │   └── domains.yaml
│   └── storage/                     ←   Хранилища
│       └── {storage}.yaml
│
└── management/                      ← УПРАВЛЕНИЕ
    ├── STATUS.md                    ←   Текущий статус
    ├── TODO.md                      ←   Задачи
    ├── ROADMAP.md                   ←   План развития
    └── DECISIONS.md                 ←   Принятые решения

{project}/
├── index.yaml
├── CLAUDE.md
├── app/
│   └── {system}/
│       └── src/
└── management/
    └── TODO.md

# ═══════════════════════════════════════════════════════════════════
# ИДЕНТИФИКАЦИЯ
# ═══════════════════════════════════════════════════════════════════
name: "Название"                          # Человекочитаемое имя
type: commercial                          # personal | nonprofit | commercial
layer: business                           # motivation | business | data | app | infra
level: direction                          # organization | direction | unit | element
status: active                            # draft | active | paused | archived

# ═══════════════════════════════════════════════════════════════════
# СМЫСЛ (9 вопросов — заполняются по мере необходимости)
# ═══════════════════════════════════════════════════════════════════
why: "Причина существования"              # ПОЧЕМУ?
purpose: "Цель"                           # ЗАЧЕМ?
what: "Определение"                       # ЧТО?
who:                                      # КТО?
  owner: "Владелец"
  users: ["Пользователь 1", "Пользователь 2"]
how: "Способ работы"                      # КАК?
tools: ["Инструмент 1", "Инструмент 2"]   # ЧЕМ?
where: "Местоположение"                   # ГДЕ?
when:                                     # КОГДА?
  created: "2025-01-01"
  updated: "2025-12-20"
  deadline: null
metrics:                                  # СКОЛЬКО?
  key1: value1
  key2: value2

# ═══════════════════════════════════════════════════════════════════
# СВЯЗИ
# ═══════════════════════════════════════════════════════════════════
parent: "../"                             # Родительский элемент
children:                                 # Дочерние элементы
  - "child-1/"
  - "child-2/"
depends_on:                               # Зависимости (использует)
  - "../other-system/"
provides_to:                              # Предоставляет (кому)
  - "../consumer/"

# ═══════════════════════════════════════════════════════════════════
# ДОПОЛНИТЕЛЬНО (опционально)
# ═══════════════════════════════════════════════════════════════════
tags: ["tag1", "tag2"]
version: "1.0.0"

name: "Пиротехника"
type: commercial
layer: null                               # Организация охватывает все слои
level: organization
status: active

why: "Клиенты не могут купить фейерверки онлайн"
purpose: "Продавать пиротехнику через интернет"
what: "Торговая компания"
who:
  owner: "Иванов И.И."
  stakeholders: ["Клиенты", "Поставщики", "Сотрудники"]

children:
  - "motivation/"
  - "business/"
  - "data/"
  - "app/"
  - "infra/"

metrics:
  revenue_monthly: 500000
  orders_monthly: 200
  employees: 5

name: "Маркетплейсы"
type: commercial
layer: business
level: direction
status: active

why: "Нужен дополнительный канал продаж"
purpose: "Продавать на OZON, Wildberries"
what: "Канал продаж через маркетплейсы"
who:
  owner: "Менеджер МП"
  users: ["Покупатели маркетплейсов"]

parent: "../"
children:
  - "processes/"
  - "roles/"
depends_on:
  - "../app/ozon-integration/"
  - "../app/pim/"

metrics:
  revenue_share: 0.25
  orders_monthly: 50

name: "OZON интеграция"
type: commercial
layer: app
level: unit
status: active

why: "Ручная работа с OZON занимает много времени"
purpose: "Автоматизировать работу с OZON"
what: "Система интеграции с OZON Seller API"
who:
  owner: "Разработчик"
  users: ["Менеджер МП"]
how: "REST API + scheduled jobs"
tools: ["Python", "FastAPI", "PostgreSQL"]
where: "dev-pro сервер"

parent: "../"
children:
  - "api/"
  - "sync/"
  - "reports/"
depends_on:
  - "../../data/products/"
  - "../../data/orders/"
  - "../../infra/production/dev-pro/"

metrics:
  uptime: 0.995
  sync_frequency: "hourly"

draft → active → paused → archived
                    ↓
                  active
                    ↓
               deprecated → archived

pirotehnika/                         ← commercial, L1
│
├── motivation/
│   ├── VISION.md                    ← "Лучший магазин фейерверков в СПб"
│   └── goals/
│       ├── revenue-2025/            ← Цель: выручка 10М
│       └── ozon-launch/             ← Цель: запуск на OZON
│
├── business/
│   ├── retail/                      ← L2: Розница
│   │   ├── processes/
│   │   │   ├── order-processing.md  ← L3: Процесс обработки заказов
│   │   │   └── fulfillment.md       ← L3: Процесс отгрузки
│   │   └── roles/
│   │       └── manager.md
│   ├── wholesale/                   ← L2: Опт
│   └── marketplaces/                ← L2: Маркетплейсы
│       └── processes/
│           └── ozon-workflow.md
│
├── data/
│   ├── products/                    ← L2: Домен товаров
│   │   ├── product.md               ← L3: Сущность товара
│   │   └── category.md
│   └── orders/                      ← L2: Домен заказов
│       ├── order.md
│       └── order-item.md
│
├── app/
│   ├── site/                        ← L2: Система сайтов
│   │   ├── pirotehnika.spb.ru/      ← L3: Основной сайт
│   │   └── pirofey.ru/              ← L3: Второй бренд
│   ├── ozon/                        ← L2: Система интеграции OZON
│   │   ├── api/                     ← L3: API сервис
│   │   └── sync/                    ← L3: Синхронизация
│   └── pim/                         ← L2: Система каталога
│
└── infra/
    ├── production/                  ← L2: Продакшен кластер
    │   ├── beget-server/            ← L3: Сервер сайтов
    │   └── dev-pro/                 ← L3: Сервер сервисов
    └── storage/
        └── s3/                      ← L3: Хранилище файлов

my-pkm/                              ← personal, L1
│
├── index.yaml
├── CLAUDE.md
│
├── motivation/
│   └── VISION.md                    ← "Не терять знания и идеи"
│
├── data/
│   ├── notes/                       ← Заметки
│   ├── projects/                    ← Проекты
│   └── resources/                   ← Ресурсы
│
├── app/
│   └── obsidian/                    ← Obsidian vault
│       └── config/
│
└── management/
    └── TODO.md

awesome-library/                     ← nonprofit, L1
│
├── index.yaml
├── CLAUDE.md
│
├── motivation/
│   ├── VISION.md                    ← "Упростить X для разработчиков"
│   └── goals/
│       └── v2-release/
│
├── business/
│   ├── community/                   ← Сообщество
│   │   └── processes/
│   │       ├── contributing.md
│   │       └── code-review.md
│   └── roles/
│       ├── maintainer.md
│       └── contributor.md
│
├── app/
│   └── library/                     ← Сама библиотека
│       ├── src/
│       ├── tests/
│       └── docs/
│
└── infra/
    └── ci-cd/                       ← GitHub Actions

□ Определить тип (personal/nonprofit/commercial)
□ Создать корневую папку
□ Создать index.yaml с базовыми полями
□ Создать CLAUDE.md с контекстом
□ Определить основные направления (L2)
□ Для каждого направления создать index.yaml
□ Наметить ключевые системы (app/)
□ Определить инфраструктуру (infra/)
□ Создать management/TODO.md