# soda

**Repository Path**: umidteam/soda

## Basic Information

- **Project Name**: soda
- **Description**: سودا تىجارەت ياردەمچىسى 
- **Primary Language**: Dart
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-02
- **Last Updated**: 2025-12-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# تىجارەت ياردەمچىسى - ئامبار باشقۇرۇش سىستېمىسى
# Inventory Management System

<div align="center">

![Flutter](https://img.shields.io/badge/Flutter-3.0+-blue.svg)
![Dart](https://img.shields.io/badge/Dart-3.0+-blue.svg)
![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Android%20%7C%20iOS%20%7C%20Linux%20%7C%20macOS%20%7C%20Web-green.svg)
![License](https://img.shields.io/badge/License-MIT-yellow.svg)

كۆپ سۇپىلىق، تولۇق ئىقتىدارلىق ئامبار باشقۇرۇش سىستېمىسى

A comprehensive cross-platform inventory management system

</div>

---

## 📋 مۇندەرىجە / Table of Contents

- [ئومۇمىي چۈشەنچە / Overview](#overview)
- [ئىقتىدارلار / Features](#features)
- [تېخنىكىلىق سۇپا / Tech Stack](#tech-stack)
- [قاچىلاش / Installation](#installation)
- [ئىشلىتىش / Usage](#usage)
- [سانلىق ئامبار / Database](#database)
- [دوكۇمېنتلار / Documentation](#documentation)
- [ئېكران كۆرۈنۈشلىرى / Screenshots](#screenshots)
- [تەرەققىيات / Development](#development)
- [تۆھپە قوشۇش / Contributing](#contributing)
- [ئىجازەتنامە / License](#license)

---

## 🎯 ئومۇمىي چۈشەنچە / Overview

بۇ پروگرامما كىچىك ۋە ئوتتۇرا دۆلەتلىك سودىگەرلەر ئۈچۈن لايىھەلەنگەن تولۇق ئىقتىدارلىق ئامبار باشقۇرۇش سىستېمىسى. ئۇ ئامبار، سودا، خېرىدار ۋە مالىيە باشقۇرۇشنىڭ بارلىق ئاساسىي ئىقتىدارلىرىنى ئۆز ئىچىگە ئالىدۇ.

This is a comprehensive inventory management system designed for small and medium-sized businesses. It includes all essential features for inventory, sales, customer, and financial management.

### ئاساسىي ئۈستۈنلۈكلەر / Key Advantages

- ✅ **تولۇق ئىقتىدار** - بارلىق زۆرۈر ئىقتىدارلار مەۋجۇت
- ✅ **ئىشلىتىشكە قۇلاي** - ئاددىي ۋە چۈشىنىشلىك كۆرۈنمە
- ✅ **ئىشەنچلىك** - مۇستەھكەم سانلىق ئامبار ۋە زاپاسلاش
- ✅ **كېڭەيتىشچان** - كەلگۈسىدە يېڭى ئىقتىدارلار قوشۇشقا قۇلاي
- ✅ **كۆپ سۇپا** - ھەر خىل ئۈسكۈنىلەردە ئىشلىيەلەيدۇ

---

## ✨ ئىقتىدارلار / Features

### 📦 ئامبار باشقۇرۇش / Inventory Management
- مەھسۇلات قوشۇش، تەھرىرلەش، ئۆچۈرۈش
- ئامبار سانىنى يېڭىلاش
- ئاز قالغان مال ئاگاھلاندۇرۇش
- تۈر بويىچە سۈزۈش ۋە ئىزدەش
- مەھسۇلات تەپسىلاتى كۆرۈش

### 💰 سودا باشقۇرۇش / Sales Management
- يېڭى سودا قىلىش
- سېۋەت (Shopping Cart) ئىقتىدارى
- كۆپ خىل تۆلەش ئۇسۇلى (نەق پۇل، كارتا، قەرز)
- ئاپتوماتىك ئامبار يېڭىلاش
- سودا تارىخى ۋە تەپسىلاتى

### 👥 خېرىدار باشقۇرۇش / Customer Management
- خېرىدار قوشۇش ۋە تەھرىرلەش
- قەرز باشقۇرۇش
- خېرىدار ئىزدەش
- ئالاقە ئۇچۇرى ساقلاش

### 📊 مالىيە باشقۇرۇش / Financial Management
- كىرىم-چىقىم باشقۇرۇش
- قەرز باشقۇرۇش
- مالىيە ئانالىز گرافىكى
- بۈگۈنكى سودا كۆرسەتكۈچى

### 📥 مال كىرگۈزۈش / Stock Entry
- يېڭى مال كىرگۈزۈش
- تەمىنلىگۈچى ئۇچۇرى
- كىرگۈزۈش باھاسى
- ئاپتوماتىك ئامبار يېڭىلاش

### 📈 ھېسابات ۋە ستاتىستىكا / Reports & Statistics
- ئاساسىي كۆرسەتكۈچلەر Dashboard
- سودا ھېساباتى
- ئامبار ھېساباتى
- مالىيە ھېساباتى
- گرافىك كۆرسىتىش

### ⚙️ تەڭشەكلەر / Settings
- تېما تەڭشەكلىرى (قاراڭغۇ/يورۇق)
- تىل تەڭشەكلىرى
- ئۇقتۇرۇش تەڭشەكلىرى
- سانلىق ئامبار باشقۇرۇش

### 💾 سانلىق ئامبار باشقۇرۇش / Database Management
- ئاپتوماتىك زاپاسلاش
- قولدا زاپاسلاش
- ئەسلىگە كەلتۈرۈش
- كونا زاپاسلارنى تازىلاش
- سانلىق ئامبار ئۇچۇرى كۆرۈش

---

## 🛠️ تېخنىكىلىق سۇپا / Tech Stack

### Frontend
- **Flutter** 3.x - UI Framework
- **Dart** 3.x - Programming Language
- **Provider** - State Management
- **Material Design 3** - Design System

### Database
- **SQLite** - Local Database
- **Sqflite** - Flutter SQLite Plugin

### UI Components
- **FL Chart** - Charts and Graphs
- **Google Fonts** - Typography
- **Font Awesome** - Icons
- **Animated Text Kit** - Text Animations
- **Simple Animations** - UI Animations

### Tools
- **Flutter ScreenUtil** - Responsive Design
- **Path Provider** - File System Access
- **Shared Preferences** - Settings Storage
- **Intl** - Internationalization

---

## 📥 قاچىلاش / Installation

### ئالدىن تەييارلىق / Prerequisites

```bash
# Flutter SDK قاچىلاش
# Install Flutter SDK
https://flutter.dev/docs/get-started/install

# Dart SDK (Flutter بىلەن بىللە كېلىدۇ)
# Dart SDK (comes with Flutter)
```

### قاچىلاش باسقۇچلىرى / Installation Steps

```bash
# 1. كودنى چۈشۈرۈش / Clone the repository
git clone <repository-url>
cd soda

# 2. Dependencies ئېلىش / Get dependencies
flutter pub get

# 3. ئانالىز قىلىش / Analyze code
flutter analyze

# 4. ئىجرا قىلىش / Run the app
flutter run

# 5. قۇرۇش / Build for production
# Windows
flutter build windows

# Android
flutter build apk

# iOS
flutter build ios

# Web
flutter build web
```

---

## 🚀 ئىشلىتىش / Usage

### دەسلەپكى كىرىش / Default Login

```
ئىشلەتكۈچى نامى / Username: admin
پارول / Password: admin123
```

### تېز باشلاش / Quick Start

تەپسىلىي قوللانما ئۈچۈن [QUICKSTART.md](QUICKSTART.md) نى كۆرۈڭ.

For detailed guide, see [QUICKSTART.md](QUICKSTART.md).

---

## 🗄️ سانلىق ئامبار / Database

### قۇرۇلما / Schema

پروگرامما 7 ئاساسىي جەدۋەلنى ئىشلىتىدۇ:

The application uses 7 main tables:

- **products** - مەھسۇلاتلار / Products
- **sales** - سودا خاتىرىسى / Sales Records
- **sale_items** - سودا تەپسىلاتى / Sale Items
- **stock_entries** - مال كىرگۈزۈش / Stock Entries
- **stock_entry_items** - مال كىرگۈزۈش تەپسىلاتى / Stock Entry Items
- **customers** - خېرىدارلار / Customers
- **transactions** - مالىيە خاتىرىسى / Financial Transactions

### تەپسىلىي ئۇچۇر / Detailed Information

- [سانلىق ئامبار قۇرۇلمىسى / Database Schema](docs/database_schema.md)
- [سانلىق ئامبار قۇرۇش / Database Setup](docs/database_setup.md)
- [سانلىق ئامبار ئۇلىنىش / Database Connection](docs/database_connection.md)

---

## 📚 دوكۇمېنتلار / Documentation

### ئىشلەتكۈچى دوكۇمېنتى / User Documentation
- [تېز باشلاش قوللانمىسى / Quick Start Guide](QUICKSTART.md)
- [ئىقتىدار تەكشۈرۈش / Feature Verification](scripts/verify_features.md)

### تېخنىكىلىق دوكۇمېنت / Technical Documentation
- [سانلىق ئامبار قۇرۇلمىسى / Database Schema](docs/database_schema.md)
- [سانلىق ئامبار قۇرۇش / Database Setup](docs/database_setup.md)
- [سانلىق ئامبار ئۇلىنىش / Database Connection](docs/database_connection.md)

---

## 📱 ئېكران كۆرۈنۈشلىرى / Screenshots

### كىرىش ئېكرانى / Login Screen
![Login Screen](assets/images/business_assistant.jpg)

### باش بەت / Home Screen
Dashboard with key metrics and quick actions

### ئامبار باشقۇرۇش / Inventory Management
Product list with search and filter capabilities

### سودا قىلىش / Sales
Shopping cart and checkout process

---

## 👨‍💻 تەرەققىيات / Development

### ئارخىتېكتۇرا / Architecture

```
lib/
├── main.dart                 # ئاساسىي كىرىش نۇقتىسى / Main entry point
├── theme/                    # تېما تەڭشەكلىرى / Theme configuration
├── services/                 # مۇلازىمەت قاتلىمى / Service layer
├── screens/                  # ئېكران كومپونېنتلىرى / Screen components
├── utils/                    # ياردەمچى ئىقتىدارلار / Utility functions
└── docs/                     # دوكۇمېنتلار / Documentation
```

### كود سۈپىتى / Code Quality

```bash
# ئانالىز قىلىش / Analyze code
flutter analyze

# سىناق / Run tests
flutter test

# كود فورماتلاش / Format code
flutter format .
```

### تەرەققىيات مۇھىتى / Development Environment

- **IDE**: VS Code / Android Studio / IntelliJ IDEA
- **Flutter DevTools**: Debugging and profiling
- **Git**: Version control

---

## 🤝 تۆھپە قوشۇش / Contributing

تۆھپە قوشۇشنى قارشى ئالىمىز! تۆۋەندىكى باسقۇچلارنى ئىجرا قىلىڭ:

We welcome contributions! Please follow these steps:

1. Fork this repository
2. Create a new branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

### كود ئۆلچىمى / Code Standards

- Flutter/Dart style guide نى ئەگىشىڭ
- كود ئىزاھاتى يېزىڭ
- سىناق يېزىڭ
- دوكۇمېنت يېڭىلاڭ

---

## 🔮 كەلگۈسىدىكى تەرەققىيات / Future Enhancements

### قىسقا مۇددەتلىك / Short Term
- 🔄 باركود سكانېر / Barcode Scanner
- 🔄 پرىنتېر قوللاش / Printer Support
- 🔄 ئېكسپورت/ئىمپورت / Export/Import (Excel, PDF)
- 🔄 كۆپ تىل قوللاش / Multi-language Support

### ئوتتۇرا مۇددەتلىك / Medium Term
- 🔄 بۇلۇت زاپاسلاش / Cloud Backup
- 🔄 كۆپ ئىشلەتكۈچى قوللاش / Multi-user Support
- 🔄 ئونلاين سىنخرونلاش / Online Sync
- 🔄 ئىلغار ھېسابات / Advanced Reports

### ئۇزۇن مۇددەتلىك / Long Term
- 🔄 AI ئاساسلىق تەھلىل / AI-based Analysis
- 🔄 IoT ئۈسكۈنە ئۇلىنىشى / IoT Device Integration
- 🔄 ئېلېكترونلۇق تىجارەت ئۇلىنىشى / E-commerce Integration
- 🔄 ERP سىستېمىسى بىلەن ئۇلىنىش / ERP System Integration

---

## 📄 ئىجازەتنامە / License

MIT License - تەپسىلاتىنى [LICENSE](LICENSE) دىن كۆرۈڭ

MIT License - See [LICENSE](LICENSE) for details

---

## 📞 ئالاقە / Contact

- **GitHub**: [Repository Link]
- **Email**: [Contact Email]
- **Website**: [Project Website]

---

## 🙏 رەھمەت / Acknowledgments

- Flutter تەرەققىيات گۇرۇپپىسى / Flutter Team
- بارلىق تۆھپە قوشقۇچىلار / All Contributors
- ئوچۇق كود جەمئىيىتى / Open Source Community

---

<div align="center">

**Made with ❤️ using Flutter**

**Flutter ئىشلىتىپ ❤️ بىلەن ياسالغان**

</div>