docs: remove obsolete documentation files
This commit is contained in:
BIN
docs/Archive.zip
BIN
docs/Archive.zip
Binary file not shown.
@@ -1,10 +0,0 @@
|
|||||||
# Changelog
|
|
||||||
|
|
||||||
## v2.0.0
|
|
||||||
- создан стабильный bootstrap v2
|
|
||||||
- добавлена чистая структура проекта
|
|
||||||
- добавлено компактное верхнее меню 3 / 3 / 1
|
|
||||||
- добавлены базовые handlers
|
|
||||||
- help перенесен в раздел `Система`
|
|
||||||
- добавлены Docker-файлы
|
|
||||||
- добавлена стартовая документация
|
|
||||||
@@ -1,189 +0,0 @@
|
|||||||
# Git Setup Flow: dzentra_bot
|
|
||||||
|
|
||||||
## Полный процесс: от `git init` до первого `push` в Gitea
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📍 0. Перейти в корень проекта
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cd ~/vsprojects/dzentra_bot
|
|
||||||
pwd
|
|
||||||
```
|
|
||||||
|
|
||||||
Ожидаемо:
|
|
||||||
```
|
|
||||||
.../vsprojects/dzentra_bot
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🧱 1. Инициализация Git
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git init
|
|
||||||
```
|
|
||||||
|
|
||||||
Проверка:
|
|
||||||
```bash
|
|
||||||
git status
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📦 2. Проверка `.gitignore`
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cat .gitignore
|
|
||||||
```
|
|
||||||
|
|
||||||
Должны быть строки:
|
|
||||||
```
|
|
||||||
app/.env
|
|
||||||
app/.venv/
|
|
||||||
__pycache__/
|
|
||||||
.DS_Store
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ➕ 3. Добавить все файлы
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git add .
|
|
||||||
```
|
|
||||||
|
|
||||||
Проверка:
|
|
||||||
```bash
|
|
||||||
git status
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 💾 4. Первый commit
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git commit -m "bootstrap v2 stable start"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🔗 5. Подключить удалённый репозиторий (Gitea)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git remote add origin https://gitadmin@git.segeba.by/gitadmin/dzentra_bot.git
|
|
||||||
```
|
|
||||||
|
|
||||||
Проверка:
|
|
||||||
```bash
|
|
||||||
git remote -v
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🌿 6. Установить ветку main
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git branch -M main
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🔐 7. Настроить сохранение токена (macOS)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git config --global credential.helper osxkeychain
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🚀 8. Первый push
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git push -u origin main
|
|
||||||
```
|
|
||||||
|
|
||||||
При запросе:
|
|
||||||
|
|
||||||
### Username:
|
|
||||||
```
|
|
||||||
gitadmin
|
|
||||||
```
|
|
||||||
|
|
||||||
### Password:
|
|
||||||
👉 вставить **Personal Access Token из Gitea**
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ✅ 9. Проверка
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git status
|
|
||||||
git branch -vv
|
|
||||||
```
|
|
||||||
|
|
||||||
Проверить в Gitea — файлы должны появиться.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
# 🔁 Дальнейшая работа
|
|
||||||
|
|
||||||
## Каждый цикл разработки
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git status
|
|
||||||
git add .
|
|
||||||
git commit -m "описание изменения"
|
|
||||||
git push
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
# 🖥 Работа с проектом
|
|
||||||
|
|
||||||
## Запуск бота
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cd app
|
|
||||||
source .venv/bin/activate
|
|
||||||
python -m src.main
|
|
||||||
```
|
|
||||||
|
|
||||||
## Git всегда из корня
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cd ~/vsprojects/dzentra_bot
|
|
||||||
git status
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
# 🚀 Deploy на Synology
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git pull
|
|
||||||
sudo docker compose -f infra/compose/docker-compose.yml up --build -d
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
# ⚠️ Важно
|
|
||||||
|
|
||||||
Не коммитить:
|
|
||||||
|
|
||||||
```
|
|
||||||
app/.env
|
|
||||||
app/.venv
|
|
||||||
ключи
|
|
||||||
пароли
|
|
||||||
логи
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
# 🎯 Итог
|
|
||||||
|
|
||||||
Git используется как:
|
|
||||||
- система контроля версий
|
|
||||||
- история проекта
|
|
||||||
- мост между Mac и Synology
|
|
||||||
@@ -1,65 +0,0 @@
|
|||||||
# 🧭 Терминология: биржа → UI бота → код
|
|
||||||
|
|
||||||
| 🏦 Термин биржи | 🤖 UI бота (как показываем) | 🧠 В коде (модель) | 💬 Комментарий |
|
|
||||||
|------------------------------|------------------------------------|--------------------------------|---------------|
|
|
||||||
| Купить | Купить (LONG) | `side = "BUY"` | Открытие long |
|
|
||||||
| Продать | Продать (SHORT) | `side = "SELL"` | Открытие short |
|
|
||||||
| Режим левереджа | 📈 Левередж | `trade_mode = "leverage"` | Основной режим |
|
|
||||||
| Режим торгов | 💱 Торги / Спот | `trade_mode = "spot"` | Без плеча |
|
|
||||||
| Купить сейчас | ⚡ MARKET | `order_type = "MARKET"` | Исполнение сразу |
|
|
||||||
| Купить когда цена = X | 🎯 LIMIT | `order_type = "LIMIT"` | Отложенный ордер |
|
|
||||||
| Цена | Цена | `price` | Только для LIMIT |
|
|
||||||
| Количество / Размер | Количество | `quantity` | Базовая величина |
|
|
||||||
| % от баланса | 5% / 10% / ... | `quantity` (расчёт) | UI-обёртка |
|
|
||||||
| Левередж | Плечо | `leverage` | Пока нет в модели |
|
|
||||||
| Доступно | Доступно | `available_balance` | из context |
|
|
||||||
| Ориентир цены (Last/Bid/Ask) | Ориентир цены | `reference_price` | для UI |
|
|
||||||
| Стоп-лосс | Стоп-лосс | `stop_loss` | будущий параметр |
|
|
||||||
| Тейк-профит | Тейк-профит | `take_profit` | будущий параметр |
|
|
||||||
| Сумма ордера | Сумма | `notional` | `price * quantity` |
|
|
||||||
| Мин. сумма | Мин. сумма | `min_notional` | правило биржи |
|
|
||||||
| Шаг количества | Шаг | `step_size` | правило |
|
|
||||||
| Мин. количество | Минимум | `min_qty` | правило |
|
|
||||||
| Черновик | Черновик | `draft` | статус |
|
|
||||||
| Подтвердить | Подтвердить | — | UI-действие |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🔥 Основные принципы
|
|
||||||
|
|
||||||
### 1. UI ≠ код
|
|
||||||
- UI: язык биржи (понятный пользователю)
|
|
||||||
- Код: строгая техническая модель
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 2. MARKET / LIMIT — это тип ордера
|
|
||||||
- не путать с режимом торговли (левередж / спот)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 3. LONG / SHORT
|
|
||||||
- LONG = `BUY`
|
|
||||||
- SHORT = `SELL`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 4. Текущий статус модели
|
|
||||||
|
|
||||||
✔ Уже есть:
|
|
||||||
- `side`
|
|
||||||
- `order_type`
|
|
||||||
- `quantity`
|
|
||||||
- `price`
|
|
||||||
|
|
||||||
🔜 Нужно добавить:
|
|
||||||
- `leverage`
|
|
||||||
- `stop_loss`
|
|
||||||
- `take_profit`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🧭 Итог
|
|
||||||
|
|
||||||
Пользователь видит **терминологию биржи**,
|
|
||||||
система работает на **нормализованной модели**.
|
|
||||||
Reference in New Issue
Block a user