2025-11-16 13:54:50 +00:00
|
|
|
|
# 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** - автоматическое развертывание на сервера
|
|
|
|
|
|
|
|
|
|
|
|
### Компоненты
|
|
|
|
|
|
|
2025-11-19 22:41:54 +00:00
|
|
|
|
- **Backend** (Dart) → `api.mnemo-cards.online`
|
|
|
|
|
|
- **Web App** (Flutter) → `mnemo-cards.online`
|
2025-11-16 13:54:50 +00:00
|
|
|
|
- **Mobile App** (Flutter) → GitHub releases
|
|
|
|
|
|
|
|
|
|
|
|
## Требования
|
|
|
|
|
|
|
|
|
|
|
|
### Локальная разработка
|
|
|
|
|
|
- Flutter SDK
|
|
|
|
|
|
- Dart SDK
|
|
|
|
|
|
- Git
|
|
|
|
|
|
|
|
|
|
|
|
### Деплой
|
|
|
|
|
|
- SSH доступ к серверу `147.45.152.129`
|
2025-11-19 22:41:54 +00:00
|
|
|
|
- DNS: `mnemo-cards.online`, `api.mnemo-cards.online`
|
2025-11-16 13:54:50 +00:00
|
|
|
|
- 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) - вспомогательные скрипты
|
