Документация InvWiz

Начало работы

InvWiz — это бот для управления инвентаризацией через Telegram. Для начала работы:

Напишите @ykengongo
Выберите тариф
Получите данные для входа

Команды бота

⚙️ Системные команды

/start - Запустить бота
/ping - Проверить статус соединения
/help - Показать список команд
/status - Проверить статус подключения

🔌 Управление подключением

connect <имя> <пароль> - Подключиться к боту

📦 Управление товарами

canon <название> - Добавить новый товар
items - Просмотреть все товары
sale <название> <кол-во> <цена> - Записать продажу
buy <название> <кол-во> <цена> - Записать покупку
history [n] - Посмотреть последние n операций

💰 Финансовые операции

cash - Проверить баланс
deposit <сумма> - Внести деньги
withdraw <сумма> - Снять деньги
profit <цена_покупки> <цена_продажи> - Рассчитать процент прибыли  
calc <цена_покупки> <процент> - Рассчитать цену продажи

👤 Управление пользователями (только для администраторов)

register <имя> <пароль> - Создать нового пользователя
unregister <имя> - Удалить пользователя
users - Показать список пользователей
backup - Создать резервную копию базы данных

Bot Commands

⚙️ System Commands

/start - Start the bot
/ping - Check connection status 
/help - Show commands list
/status - Check connection status

🔌 Connection Management

connect   - Connect to bot

📦 Inventory Management

canon  - Add new product
items - View all items
sale    - Record a sale
buy    - Record a purchase
history [n] - View last n operations

💰 Financial Operations

cash - Check balance
deposit  - Add money
withdraw  - Withdraw money
profit   - Calculate profit percentage
calc   - Calculate selling price
month [month] [year] - View monthly statistics

👤 User Management (admin only)

register   - Create new user
unregister  - Delete user
users - Show users list
backup - Create database backup

Настройка

🔑 Настройка окружения

Создайте файл .env в корневой директории проекта:

TOKEN=ваш_токен_бота
SALT=ваш_секретный_ключ

⚙️ Конфигурация базы данных

Запустите скрипт настройки:

python setup.py create_db    # Создать базу данных
python setup.py set_token    # Установить токен бота
python setup.py create_user  # Создать первого пользователя

Configuration

🔑 Environment Setup

Create .env file in the project root:

TOKEN=your_bot_token
SALT=your_secret_key

⚙️ Database Configuration

Run the setup script:

python setup.py create_db    # Create database
python setup.py set_token    # Set bot token
python setup.py create_user  # Create first user

Использование

📝 Примеры использования

Добавление товара

canon iPhone 15
➜ Товар 'iPhone 15' успешно добавлен

Запись покупки

buy iPhone 15 5 85000
➜ Куплено 5 единиц товара 'iPhone 15' по цене 85000₽

Запись продажи

sale iPhone 15 1 95000
➜ Продан 1 iPhone 15
➜ Цена покупки: 85000₽
➜ Прибыль: 10000₽ (11.76%)

Просмотр истории

history 5
➜ Последние 5 операций:
1. Продажа: iPhone 15 (1 шт.) - 95000₽
2. Покупка: iPhone 15 (5 шт.) - 85000₽
3. ...

Usage

📝 Usage Examples

Adding Product

canon iPhone 15
➜ Product 'iPhone 15' added successfully

Recording Purchase

buy iPhone 15 5 85000
➜ Bought 5 units of 'iPhone 15' at 85000₽

Recording Sale

sale iPhone 15 1 95000
➜ Sold 1 iPhone 15
➜ Purchase price: 85000₽
➜ Profit: 10000₽ (11.76%)

Viewing History

history 5
➜ Last 5 operations:
1. Sale: iPhone 15 (1 pc) - 95000₽
2. Purchase: iPhone 15 (5 pcs) - 85000₽
3. ...

Частые вопросы

❓ Как начать использовать бота?

Напишите @ykengongo в Telegram и следуйте инструкциям для получения доступа.

💾 Как создать резервную копию?

Используйте команду backup для создания резервной копии базы данных.

🔐 Как сменить пароль?

Администратор может использовать команду register с существующим именем пользователя для обновления пароля.

📊 Как получить статистику?

Используйте команды:

history - для просмотра истории операций
cash - для просмотра баланса
items - для просмотра товаров

FAQ

❓ How to start using the bot?

Message @ykengongo on Telegram and follow instructions to get access.

💾 How to create a backup?

Use the backup command to create a database backup.

🔐 How to change password?

Administrator can use register command with existing username to update the password.

📊 How to get statistics?

Use these commands:

history - to view operations history
cash - to view balance
items - to view products

InvWiz Documentation

Getting Started

InvWiz is an inventory management bot for Telegram. To get started:

Message @ykengongo
Choose your plan
Get your login credentials