architect/_archive/2025-11-26-cleanup/templates/project/@service-template/README.md

Шаблон @service- проекта

Тип: External Service Project
Версия: 1.0.0

Назначение

Шаблон для создания проектов интеграции с внешними сервисами через API.

Когда использовать

Создание проекта

Claude, создать @service- проект для API {name}

Переменные

Создаваемая структура

projects/@service-{PROJECT_NAME}/
├── design/
   └── PROJECT.md
├── management/
   ├── README.md
   └── API.md                    # Документация API
├── infrastructure/
   ├── CONNECTION.md             # API credentials
   ├── WEBHOOKS.md               # Настройки webhooks
   └── LIMITS.md                 # Квоты и лимиты
└── solution/integration/
    └── examples/
        ├── python/
        ├── javascript/
        └── curl/

Отличие от @web-

Критерий @service- @web-
Доступ API + Web UI Только Web UI
Автоматизация ✅ Да (через API) ❌ Нет
Документация Примеры кода Процедуры (шаги)
Использование Интеграция в код Ручная работа

Примеры

Платёжный API

projects/@service-stripe/
├── infrastructure/
   ├── CONNECTION.md             # API key: sk_live_xxxxx
   ├── WEBHOOKS.md               # webhook secret
   └── LIMITS.md                 # 100 req/sec
└── solution/integration/examples/
    ├── python/
       └── create_payment.py
    └── curl/
        └── test_api.sh

Cloud платформа

projects/@service-aws/
├── infrastructure/
   ├── CONNECTION.md             # AWS credentials
   └── LIMITS.md                 # EC2 limits, S3 quotas
└── solution/integration/examples/
    ├── python/
       ├── s3_upload.py
       └── ec2_list.py
    └── bash/
        └── aws_cli_examples.sh

Следующие шаги после создания

  1. Заполнить CONNECTION.md с API credentials
  2. Протестировать API доступ
  3. Создать примеры интеграции в solution/integration/
  4. Документировать лимиты и квоты
  5. Настроить webhooks (если поддерживаются)