# tools - Development & Deployment Tools

Инструменты для разработки, тестирования и развертывания проекта Mnemo Cards.

## Структура

```
tools/
├── ci/                    # CI/CD workflows для Forgejo Actions
│   ├── ci-main.yml       # Главный pipeline
│   ├── ci-backend.yml    # Backend CI
│   ├── ci-web.yml        # Web app CI
│   ├── ci-mobile.yml     # Mobile app CI
│   ├── cd-deploy.yml     # Deployment
│   ├── code-quality.yml  # Quality checks
│   ├── release.yml       # Auto releases
│   └── agent.yml         # AI agent
├── deploy/               # Deployment scripts
│   ├── backend-build_app.sh    # Backend build & deploy
│   └── web-app/          # Web app deployment
│       ├── config.sh     # Configuration
│       ├── deploy.sh     # Main deploy script
│       └── nginx.conf    # Nginx config
├── docs/                 # Documentation
│   └── CI_CD_SETUP.md    # CI/CD setup guide
└── scripts/              # Utility scripts
    ├── check_deploy_ready.sh   # Pre-deploy checks
    └── test_ci_locally.sh      # Local CI/CD testing
```

## Быстрый старт

### Проверка готовности к деплою

```bash
./scripts/check_deploy_ready.sh
```

### Локальное тестирование CI/CD

```bash
./scripts/test_ci_locally.sh
```

### Настройка CI/CD

См. [CI/CD Setup Guide](docs/CI_CD_SETUP.md)

## CI/CD Workflow

1. **Code Quality** - линтинг, тесты, безопасность
2. **Build** - параллельная сборка всех компонентов
3. **Deploy** - автоматическое развертывание на сервера

### Компоненты

- **Backend** (Dart) → `api.mnemo-cards.online`
- **Web App** (Flutter) → `mnemo-cards.online`
- **Mobile App** (Flutter) → GitHub releases

## Требования

### Локальная разработка
- Flutter SDK
- Dart SDK
- Git

### Деплой
- SSH доступ к серверу `147.45.152.129`
- DNS: `mnemo-cards.online`, `api.mnemo-cards.online`
- Forgejo с настроенными secrets

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

- [CI/CD Setup](docs/CI_CD_SETUP.md) - полное руководство по настройке
- [Deploy Scripts](deploy/README.md) - скрипты деплоя
- [CI Workflows](ci/README.md) - CI/CD pipelines
- [Scripts](scripts/README.md) - вспомогательные скрипты