From b289c8f33a75f2a1411ca57c0e56751847e73d19 Mon Sep 17 00:00:00 2001
From: Alexander Popov <iiiypuk@fastmail.fm>
Date: Thu, 13 Mar 2025 12:59:33 +0300
Subject: [PATCH] =?UTF-8?q?=D0=9E=D0=B1=D0=BD=D0=BE=D0=B2=D0=BB=D0=B5?=
 =?UTF-8?q?=D0=BD=D0=B8=D0=B5=20=D0=B4=D0=BE=D0=BA=D1=83=D0=BC=D0=B5=D0=BD?=
 =?UTF-8?q?=D1=82=D0=B0=D1=86=D0=B8=D0=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CHANGELOG.md   |  0
 LICENSE        |  2 +-
 README.md      | 80 +++++++++++++++++++++++++++++++++++++++++++++++++-
 pyproject.toml | 19 ++++++++++--
 4 files changed, 97 insertions(+), 4 deletions(-)
 create mode 100644 CHANGELOG.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..e69de29
diff --git a/LICENSE b/LICENSE
index b2bcf61..35c933c 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,6 +1,6 @@
 MIT No Attribution
 
-Copyright 2024 Alexander Popov
+Copyright 2025 Alexander Popov
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this
 software and associated documentation files (the "Software"), to deal in the Software
diff --git a/README.md b/README.md
index 8ca02ea..4bd98c8 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,81 @@
-# TODO
+---
+gitea: none
+include_toc: true
+---
+
+# 🎴 Бот для ведения статистики клана в AniCard
+
+## 📦 Возможности
+
+- [ ] Сохранение статистики побед в КВ членов клана
+- [ ] Сохранение статистики пожертвований в сокровищницу членов клана
+
+
+## 💽 Установка и использование
+
+### 📄 Подготовка файла конфигурации
+
+Настройки приложения хранится в файле `.env`.
+Пример файла с настройками называется `env.example`.
+
+```sh
+cp env.example .env
+```
+
+Разбор файла настроек:
+
+- `APP_ID`  — Идентификатор приложения Telegram.
+- `APP_HASH` — Хэш  приложения Telegram.
+- `ACCOUNT` — Имя аккаунта пользователя Telegram (_например `db_o_qp`_).
+- `LOG_PATH` — Путь в файлу логов (_например `/tmp/test.log`_).
+- `DB_PATH` — Путь к файлу базы данных SQLite3 (_например `./db.sqlite`_).
+
+
+### 🐦‍🔥 Настройка виртуального окружения и загрузка бибилотек
+
+Создание и активация виртуального окружения.
+
+```sh
+python3 -m venv venv
+. ./venv/bin/activate
+```
+
+Установка библиотек.
+
+```sh
+pip3 install -r requirements.txt
+```
+
+
+### ▶️ Первый запуск
+
+В время первого запуска появится запрос данных авторизации от библиотеки `Pyrogram`.
+
+```text
+Welcome to Pyrogram (version 2.0.106)
+Pyrogram is free software and comes with ABSOLUTELY NO WARRANTY. Licensed
+under the terms of the GNU Lesser General Public License v3.0 (LGPL-3.0).
+
+Enter phone number or bot token: 898********
+Is "898********" correct? (y/N): y
+The confirmation code has been sent via Telegram app
+Enter confirmation code: 14628
+```
+
+
+### 🧤 Systemd
+
+> ⚠️ В процессе написания...
+
+
+# 📑 TODO
 
 - [ ] Добавить уведомления, если что-то пошло не так
+
+
+# 💼 Используемые библиотеки
+
+- **Pyrogram** — Telegram клиент
+- **python-dotenv** — Работа с `.env` файлами
+- **loguru** — Логирование
+- **black** — Форматирование кода
diff --git a/pyproject.toml b/pyproject.toml
index 92afe8c..8b14488 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,3 +1,18 @@
+[project]
+dynamic = [ "version" ]
+name = "..."
+description = "..."
+authors = [ {name = "Alexander Popov", email = "iiiypuk@fastmail.fm"}, ]
+readme = "README.md"
+license = { text = "MIT-0 License" }
+dependencies = [ ]
+requires-python = ">= 3.8"
+
+classifiers=[ 'License :: OSI Approved :: MIT No Attribution License (MIT-0)', ]
+
+[project.urls]
+Changelog = "https://change.me//CHANGELOG.md"
+
 [tool.black]
-line-length = 123
-skip-string-normalization = 1
+skip-string-normalization = true
+line-length = 132