🖥️ PC Components

Мобильное приложение для управления каталогом компонентов ПК
Создавайте конфигурации, просматривайте готовые сборки и управляйте каталогом компонентов

---

📋 Описание

PC Components — это современное Android-приложение, разработанное для энтузиастов сборки компьютеров. Приложение позволяет просматривать каталог компонентов ПК, создавать собственные конфигурации, изучать готовые сборки и управлять персональным профилем.

✨ Ключевые возможности

• 🔍 Каталог компонентов - Обширная база данных с фильтрацией по категориям
• 🔧 Сборщик ПК - Интуитивный инструмент создания конфигураций
• 💻 Готовые сборки - Коллекция протестированных конфигураций
• 👤 Профиль пользователя - Персонализация и управление аккаунтом
• 🛡️ Админ-панель - Модерация контента для администраторов
• 🔐 Безопасная аутентификация - Вход через email или Google

🏗️ Архитектура

Основные компоненты

📁 n.android.pc/
├── 🏠 MainActivity # Главный экран с навигацией
├── 🔐 AuthActivity # Аутентификация пользователей
├── ⚙️ AdminPanelActivity # Панель администратора
├── 📱 Fragments/
│ ├── Components # Каталог компонентов
│ ├── Assembly # Сборщик ПК
│ ├── ReadyAssembly # Готовые сборки
│ └── Profile # Профиль пользователя
├── 🗂️ Models/
│ ├── Component # Модель компонента
│ ├── PCBuild # Модель сборки ПК
│ ├── ReadyPC # Модель готовой сборки
│ └── User # Модель пользователя
└── 🔧 Managers/
├── BuildManager # Управление сборками
├── ReadyPCManager # Управление готовыми ПК
└── RoleManager # Управление ролями

Технологический стек

Компонент	Технология	Версия
Язык программирования	Java	11
SDK	Android SDK	24-35
Backend	Firebase	BOM 33.14.0
UI Framework	Material Design	1.12.0
Изображения	Glide	4.16.0
База данных	Firebase Realtime DB	-
Аутентификация	Firebase Auth	23.2.0

🚀 Быстрый старт

Предварительные требования

• Android Studio Arctic Fox или новее
• JDK 11 или выше
• Android SDK с уровнем API 24+
• Google Services аккаунт для Firebase

Установка

1. Клонирование репозитория

   git clone https://github.com/your-username/PCcomponents.git
   cd PCcomponents

2. Настройка Firebase

   • Создайте проект в Firebase Console
   • Добавьте Android-приложение с package name: n.android.pc
   • Скачайте google-services.json в папку app/
   • Настройте Authentication (Email/Password, Google)
   • Создайте Realtime Database

3. Сборка приложения

   ./gradlew build

4. Установка на устройство

   ./gradlew installDebug

Структура базы данных Firebase

{
"components": {
"cpu": { "component_id": { "name": "...", "price": "...", "specs": "..." } },
"gpu": { "component_id": { "name": "...", "price": "...", "specs": "..." } },
"ram": { "component_id": { "name": "...", "price": "...", "specs": "..." } }
},
"builds": {
"user_id": {
"build_id": { "name": "...", "components": {...}, "totalPrice": "..." }
}
},
"ready-pcs": {
"pc_id": { "name": "...", "components": {...}, "price": "...", "category": "..." }
},
"users": {
"user_id": { "name": "...", "email": "...", "role": "user/admin" }
}
}

🛠️ Команды разработки

Сборка

# Debug сборка
./gradlew assembleDebug
# Release сборка
./gradlew assembleRelease
# Очистка проекта
./gradlew clean

Тестирование

# Unit тесты
./gradlew test# Интеграционные тесты
./gradlew connectedAndroidTest

Качество кода

# Проверка линтером
./gradlew lint
# Генерация отчета линтера
./gradlew lintDebug

📱 Скриншоты

🤝 Участие в разработке

Мы приветствуем ваш вклад в развитие проекта!

Как внести изменения

1. Fork проекта
2. Создайте feature branch (git checkout -b feature/amazing-feature)
3. Commit ваши изменения (git commit -m 'Add amazing feature')
4. Push в branch (git push origin feature/amazing-feature)
5. Откройте Pull Request

Стиль кода

• Следуйте Java Code Conventions
• Используйте осмысленные имена переменных и методов
• Добавляйте комментарии к сложной логике
• Покрывайте новый код тестами

📄 Лицензия

Этот проект лицензирован под MIT License - см. файл LICENSE для деталей.

📞 Контакты

• Email: nn80nn80nn80nn80nn@gmail.com
• GitHub: nn80nn(https://github.com/nn80nn)
• Telegram: @nn80nnnn

---

Сделано с ❤️ для сообщества PC энтузиастов

⬆️ Наверх