63 lines
2.6 KiB
Markdown
63 lines
2.6 KiB
Markdown
# AEVS CLI — Simplified Version
|
||
|
||
> CLI-инструмент для синхронизации `.env` файлов между машинами одного пользователя.
|
||
|
||
## Документация
|
||
|
||
| Файл | Описание |
|
||
|------|----------|
|
||
| [01-overview.md](./01-overview.md) | Обзор проекта, архитектура, scope |
|
||
| [02-configuration.md](./02-configuration.md) | Конфигурационные файлы (глобальный и локальный) |
|
||
| [03-commands.md](./03-commands.md) | Детальное описание всех команд CLI |
|
||
| [04-types.md](./04-types.md) | Go типы, интерфейсы, константы |
|
||
| [05-scenarios.md](./05-scenarios.md) | Сценарии использования с примерами |
|
||
| [06-errors.md](./06-errors.md) | Обработка ошибок, exit codes, логирование |
|
||
|
||
## Quick Start
|
||
|
||
```bash
|
||
# 1. Настроить credentials (один раз на машине)
|
||
aevs config
|
||
|
||
# 2. Инициализировать проект
|
||
cd my-project
|
||
aevs init
|
||
|
||
# 3. Загрузить env файлы в storage
|
||
aevs push
|
||
|
||
# 4. На другой машине — скачать
|
||
aevs pull my-project
|
||
```
|
||
|
||
## Команды
|
||
|
||
| Команда | Описание |
|
||
|---------|----------|
|
||
| `aevs config` | Настройка credentials для S3 |
|
||
| `aevs init [name]` | Инициализация проекта |
|
||
| `aevs push` | Загрузить файлы в storage |
|
||
| `aevs pull [name]` | Скачать файлы из storage |
|
||
| `aevs list` | Список проектов в storage |
|
||
| `aevs status` | Статус синхронизации |
|
||
|
||
## Ключевые отличия от v1 (01-opus-docs)
|
||
|
||
| Аспект | v1 (сложная) | v2 (упрощённая) |
|
||
|--------|--------------|-----------------|
|
||
| Целевая аудитория | Команда | Один пользователь |
|
||
| Backend | REST API сервер | S3 storage |
|
||
| Версионирование | Встроенное (timestamps) | S3 versioning |
|
||
| Merge | Интерактивный | Не нужен |
|
||
| Конфликты | Разрешение конфликтов | Последний push побеждает |
|
||
| Команды | 6+ с множеством флагов | 6 простых |
|
||
| Код | ~1000+ строк | ~300-500 строк |
|
||
| Время разработки | 2-3 дня | 4-6 часов |
|
||
|
||
## Tech Stack
|
||
|
||
- **Language:** Go
|
||
- **CLI Framework:** cobra
|
||
- **Storage:** AWS S3 (или совместимые: MinIO, R2, Spaces)
|
||
- **Config:** YAML (gopkg.in/yaml.v3)
|