LinkFlow/draft.txt at main · TalonProbeite/LinkFlow · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
project_root/
├── frontend/             # Твоя верстка и логика интерфейса
│   ├── index.html          # Главная страница (каталог)
│   ├── product.html        # Страница товара
│   ├── css/
│   │   └── style.css       # Твои стили по макету
│   ├── js/
│   │   ├── api.js          # Логика общения с бэкендом (fetch)
│   │   ├── main.js         # Скрипты для главной страницы
│   │   └── product.js      # Скрипты для карточки товара
│   └── assets/              # HTML, CSS, JS (твой простой фронт)
├── backend/               # Python код
│   ├── app/
│   │   ├── main.py        # Точка входа (запуск FastAPI + подключение Bot)
│   │   ├── models/        # Таблицы БД (SQLAlchemy) — "Как данные лежат в БД"
│   │   │   ├── user.py
│   │   │   └── link.py
│   │   ├── schemas/       # Схемы Pydantic — "Как данные выглядят в API"
│   │   │   ├── user.py
│   │   │   └── link.py
│   │   ├── repositories/  # Работа с БД — "Функции поиска/записи в базу"
│   │   │   └── stats_repo.py
│   │   ├── routers/       # Эндпоинты API — "Пути, по которым стучится фронт"
│   │   │   ├── dashboard.py
│   │   │   └── invite.py
│   │   └── bot/
│   │   ├── __init__.py
│   │   ├── bot_instance.py  # Bot, Dispatcher, запуск polling
│   │   ├── handlers.py      # Хэндлеры
│   │   └── services.py      # ФУНКЦИИ бота (API Telegram)
│   └── requirements.txt
└── .env                   # Токены и настройки


Префикс,Когда использовать,Пример
feat:,Добавление новой функциональности для пользователя.,feat: add product list filtering by category
fix:,Исправление ошибки (бага).,fix: resolve crash when cart is empty
docs:,"Изменения только в документации (README, комменты).",docs: update api installation instructions
style:,"Правки, не влияющие на логику (пробелы, форматирование, точки с запятой).",style: reformat models.py using black
refactor:,"Изменение кода, которое не исправляет баг и не добавляет фичу (улучшение структуры).",refactor: simplify user authentication logic
perf:,Изменения для улучшения производительности.,perf: speed up product search query
test:,Добавление или исправление тестов.,test: add unit tests for cart calculations
chore:,"Обновление зависимостей, конфигов, сборки (всё, что не касается кода приложения).",chore: update pydantic version
build:,"Изменения в системе сборки или внешних зависимостях (webpack, docker, npm).",build: setup docker-compose for dev environment
ci:,"Настройка GitHub Actions, GitLab CI и других систем интеграции.",ci: add linter check on pull request


=== GIT ШПАРГАЛКА (БАЗОВОЕ) ===

1. ОБНОВЛЕНИЕ ВЕТКИ (PULL)
   git pull origin имя_ветки       # стянуть изменения с удаленного репозитория
   git fetch origin               # получить изменения без слияния
   git merge origin/имя_ветки    # вручную слить изменения после fetch

2. СОЗДАНИЕ ВЕТКИ
   git branch имя_новой_ветки     # создать ветку
   git checkout -b имя_ветки      # создать И переключиться на нее
   git push -u origin имя_ветки   # отправить новую ветку на удаленный репозиторий

3. ПЕРЕИМЕНОВАНИЕ КОММИТА (последнего)
   git commit --amend -m "новый текст"   # изменить сообщение последнего коммита
   git push --force origin ветка         # осторожно! заменить удаленный коммит

4. СЛИЯНИЕ ВЕТОК (MERGE)
   git checkout основная_ветка           # перейти в ветку, КУДА сливаем
   git merge ветка_для_слияния           # слить другую ветку в текущую
   git mergetool                         # GUI для разрешения конфликтов

5. ОСНОВНЫЕ КОМАНДЫ:
   - git status                         # что изменилось
   - git add .                          # добавить все изменения
   - git commit -m "сообщение"          # зафиксировать изменения
   - git push origin ветка              # отправить коммиты на сервер
   - git log --oneline                  # история коммитов (кратко)
   - git diff                           # посмотреть изменения

6. РАБОТА С УДАЛЕННЫМ РЕПОЗИТОРИЕМ:
   git remote -v                        # список удаленных репозиториев
   git clone ссылка                     # скопировать удаленный репозиторий
   git pull                             # стянуть изменения (fetch + merge)

7. ОТМЕНА ИЗМЕНЕНИЙ:
   git reset --hard HEAD~1              # удалить последний коммит (осторожно!)
   git checkout -- файл.txt             # отменить изменения в файле

=== ПАМЯТКА ===
* Всегда делайте git status перед коммитом
* Сначала pull, потом push, чтобы избежать конфликтов
* Ветка master/main — основная, в нее сливаем через pull request