Race00 - Ucode Calculator

Ucode Marathon | Calculator Project | 2025

🧮 Попередній перегляд калькулятора

🎬 Демонстрація роботи

Повнофункціональний веб-калькулятор з сучасним інтерфейсом

---

Українська 🇺🇦

⚠️ УВАГА:

Цей репозиторій містить нашу реалізацію веб-калькулятора, розроблену командою з 2 осіб в рамках Race00 проекту Ucode Marathon 2025.
Калькулятор створений на чистому JavaScript ES2015+ з використанням HTML5 та CSS3 для інтерфейсу.

Повнофункціональний калькулятор — виконує всі основні математичні операції!

🔧 Готовий до використання — відкрийте посилання на GitHub Pages нижче!

---

Про калькулятор

Ucode Calculator — це сучасний веб-калькулятор, який виконує всі стандартні математичні операції. Розроблений у рамках челенджу Race00 для об'єднання знань з п'яти спринтів Half Marathon Full Stack курсу.

⚙️ Основні функції

1. Арифметичні операції — +, -, ×, ÷
2. Додаткові функції — %, √, xⁿ, ±, !
3. Керування пам'яттю — MC, MR, M+, M-, MS
4. Спеціальні операції — C (очистити), ← (видалити), . (десяткова крапка)

Ігрова механіка калькулятора

Основні характеристики:

• Значення за замовчуванням — "0" у полі виводу
• Порожнє поле історії — початково не містить операцій
• Динамічне оновлення — знаки та числа додаються у поле виводу
• Точні обчислення — робота лише з числами, а не з рядками

Підтримувані операції:

• Базові арифметичні — додавання, віднімання, множення, ділення
• Проценти (%) — обчислення відсотків від поточного числа
• Знак (±) — зміна знаку числа на протилежний
• Десяткова крапка (.) — розділення цілої та дробової частини
• Скидання (C) — повернення до значення за замовчуванням
• Видалення (←) — видалення останнього введеного символу

Розширені функції:

• Квадратний корінь (√) — обчислення кореня числа
• Степінь (xⁿ) — піднесення числа до степеня
• Факториал (!) — обчислення факториала числа
• Пам'ять — збереження та відновлення значень

Основні особливості

• Сучасний інтерфейс з адаптивним дизайном
• Плавні анімації та візуальні ефекти
• Інтуїтивне керування мишею та клавіатурою
• Точні математичні обчислення
• Підтримка складних виразів з декількома операціями
• Візуалізація степенів з використанням верхніх індексів

Робота з калькулятором

Ucode Calculator — це потужний інструмент для математичних обчислень:

Мета: Виконання точних математичних операцій з використанням:

• Базових арифметичних функцій для повсякденних обчислень
• Розширених операцій для складних математичних задач
• Функцій пам'яті для збереження проміжних результатів

Особливості використання:

• Введення чисел та операцій через кнопки інтерфейсу
• Перегляд історії операцій у верхньому полі
• Миттєве отримання результатів
• Можливість продовження обчислень з попереднім результатом

---

🛠️ Встановлення та запуск

Системні вимоги

• Браузер: Будь-який сучасний веб-браузер (Chrome, Firefox, Safari, Edge)
• JavaScript: Підтримка ES2015+ (всі сучасні браузери)
• Інтернет: Не потрібен (працює офлайн)

🌐 GitHub Pages

Калькулятор доступний онлайн за посиланням: Ucode Calculator

---

🎮 Керування

Кнопка/Клавіша	Дія
0-9	Введення цифр
+ - × ÷	Арифметичні операції
=	Обчислення результату
C	Очистити всі дані
←	Видалити останній символ
±	Змінити знак числа
.	Десяткова крапка
%	Обчислити відсоток
√	Квадратний корінь
xⁿ	Піднесення до степеня
!	Факториал

💾 Робота з пам'яттю

Кнопка	Функція
MC	Очистити пам'ять
MR	Відновити з пам'яті
M+	Додати до пам'яті
M-	Відняти від пам'яті
MS	Зберегти в пам'ять

Особливості використання

1. Введення виразів:

   • Вводьте числа та операції послідовно
   • Калькулятор автоматично обчислює результат
   • Підтримка складних виразів з декількома операціями

2. Робота з десятковими числами:

   • Використовуйте крапку (.) для розділення
   • Автоматична валідація формату чисел
   • Підтримка чисел з плаваючою крапкою

3. Історія операцій:

   • Верхнє поле показує поточний вираз
   • Нижнє поле показує результат
   • Можливість продовження обчислень

---

📁 Структура проекту

Ucode_Calculator/
├── index.html              
├── css/                    # Стилі
│   └── style.css          
├── js/                     # JavaScript логіка
│   └── script.js          
└── README.md              

---

👥 Команда розробників

Роль	Учасник	GitHub	Внесок
Main Developer & Designer	Володимир Вовк	1terraflops	Основна розробка, дизайн інтерфейсу
Team Lead & Co-Developer	Максим Копичко	Archie242	Керівництво проектом, програмування логіки, допомога в розробці

---

🔧 Використані технології

Мови програмування	Стилізація	Інструменти розробки	Платформи
JavaScript ES2015+ HTML5	CSS3	Git VSCode	GitHub Pages Linux Windows

---

Особливості реалізації

• Модульна архітектура: Розділення логіки, стилів та розмітки
• ES2015+ стандарт: Використання сучасних можливостей JavaScript
• Адаптивний дизайн: Працює на всіх пристроях та екранах
• Оптимізована продуктивність: Швидкі обчислення та плавний інтерфейс

---

🌟 Досягнення команди

✅ Успішно завершений Race00 в рамках Ucode Marathon
✅ Створений повнофункціональний калькулятор відповідно до всіх вимог
✅ Об'єднані знання з п'яти спринтів курсу
✅ Мінімалістичний та зручний інтерфейс для користувачів

---

📚 Що було вивчено

В процесі створення калькулятора було застосовано знання з:

• HTML5: Семантична розмітка та структура документа
• CSS3: Стилізація, анімації, адаптивний дизайн
• JavaScript ES2015+: Сучасний синтаксис, функції, обробка подій
• DOM маніпуляції: Взаємодія з елементами сторінки
• Git: Контроль версій та командна робота

---

Створено з натхненням командою для Ucode Marathon | Race00 | 2025

English 🇬🇧

⚠️ WARNING:

This repository contains our implementation of a web calculator, developed by a team of 2 people as part of the Race00 project for Ucode Marathon 2025.
The calculator is built with pure JavaScript ES2015+ using HTML5 and CSS3 for the interface.

Full-featured calculator — performs all basic mathematical operations!

🔧 Ready to use — open the GitHub Pages link below!

---

About the Calculator

Ucode Calculator is a modern web calculator that performs all standard mathematical operations. Developed as part of the Race00 challenge to combine knowledge from five sprints of the Half Marathon Full Stack course.

⚙️ Main Functions

1. Arithmetic operations — +, -, ×, ÷
2. Additional functions — %, √, xⁿ, ±, !
3. Memory management — MC, MR, M+, M-, MS
4. Special operations — C (clear), ← (delete), . (decimal point)

Calculator Mechanics

Main characteristics:

• Default value — "0" in the output field
• Empty history field — initially contains no operations
• Dynamic updating — signs and numbers are added to the output field
• Precise calculations — works only with numbers, not strings

Supported operations:

• Basic arithmetic — addition, subtraction, multiplication, division
• Percentage (%) — calculate percentage of current number
• Sign (±) — change number sign to opposite
• Decimal point (.) — separate integer and fractional parts
• Reset (C) — return to default value
• Delete (←) — remove last entered symbol

Advanced functions:

• Square root (√) — calculate square root of number
• Power (xⁿ) — raise number to power
• Factorial (!) — calculate factorial of number
• Memory — save and restore values

Key Features

• Modern interface with responsive design
• Smooth animations and visual effects
• Intuitive controls with mouse and keyboard
• Precise mathematical calculations
• Support for complex expressions with multiple operations
• Power visualization using superscripts

---

🛠️ Installation and Launch

System Requirements

• Browser: Any modern web browser (Chrome, Firefox, Safari, Edge)
• JavaScript: ES2015+ support (all modern browsers)
• Internet: Not required (works offline)

🌐 GitHub Pages

Calculator is available online at: Ucode Calculator

---

🎮 Controls

Button/Key	Action
0-9	Enter digits
+ - × ÷	Arithmetic operations
=	Calculate result
C	Clear all data
←	Delete last symbol
±	Change number sign
.	Decimal point
%	Calculate percentage
√	Square root
xⁿ	Raise to power
!	Factorial

💾 Memory Operations

Button	Function
MC	Clear memory
MR	Recall from memory
M+	Add to memory
M-	Subtract from memory
MS	Store in memory

---

📁 Project Structure

Ucode_Calculator/
├── index.html              
├── css/                    # Styles
│   └── style.css          
├── js/                     # JavaScript logic
│   └── script.js          
└── README.md              

---

👥 Development Team

Role	Member	GitHub	Contribution
Main Developer & Designer	Volodymyr Vovk	1terraflops	Main development, interface design
Team Lead & Co-Developer	Maksym Kopychko	Archie242	Project management, logic programming, development assistance

---

🔧 Technologies Used

Programming Languages	Styling	Development Tools	Platforms
JavaScript ES2015+ HTML5	CSS3	Git VSCode	GitHub Pages Linux Windows

---

Implementation Features

• Modular architecture: Separation of logic, styles and markup
• ES2015+ standard: Using modern JavaScript features
• Responsive design: Works on all devices and screens
• Optimized performance: Fast calculations and smooth interface

---

🌟 Team Achievements

✅ Successfully completed Race00 as part of Ucode Marathon
✅ Created full-featured calculator according to all requirements
✅ Combined knowledge from five course sprints
✅ Minimalist and user-friendly interface for users

---

📚 What Was Learned

During calculator creation, knowledge was applied from:

• HTML5: Semantic markup and document structure
• CSS3: Styling, animations, responsive design
• JavaScript ES2015+: Modern syntax, functions, event handling
• DOM manipulations: Interaction with page elements
• Git: Version control and teamwork

---

Created with inspiration by the team for Ucode Marathon | Race00 | 2025

Deutsch 🇩🇪

⚠️ ACHTUNG:

Dieses Repository enthält unsere Implementierung eines Web-Rechners, entwickelt von einem 2-köpfigen Team im Rahmen des Race00-Projekts für Ucode Marathon 2025.
Der Rechner ist mit reinem JavaScript ES2015+ unter Verwendung von HTML5 und CSS3 für die Benutzeroberfläche erstellt.

Vollwertiger Rechner — führt alle grundlegenden mathematischen Operationen aus!

🔧 Einsatzbereit — öffnen Sie den GitHub Pages-Link unten!

---

Über den Rechner

Ucode Calculator ist ein moderner Web-Rechner, der alle standardmäßigen mathematischen Operationen ausführt. Entwickelt als Teil der Race00-Herausforderung zur Vereinigung des Wissens aus fünf Sprints des Half Marathon Full Stack-Kurses.

⚙️ Hauptfunktionen

1. Arithmetische Operationen — +, -, ×, ÷
2. Zusätzliche Funktionen — %, √, xⁿ, ±, !
3. Speicherverwaltung — MC, MR, M+, M-, MS
4. Spezielle Operationen — C (löschen), ← (entfernen), . (Dezimalpunkt)

Rechner-Mechanik

Hauptmerkmale:

• Standardwert — "0" im Ausgabefeld
• Leeres Verlaufsfeld — enthält anfangs keine Operationen
• Dynamische Aktualisierung — Zeichen und Zahlen werden zum Ausgabefeld hinzugefügt
• Präzise Berechnungen — arbeitet nur mit Zahlen, nicht mit Strings

Unterstützte Operationen:

• Grundlegende Arithmetik — Addition, Subtraktion, Multiplikation, Division
• Prozent (%) — Prozentsatz der aktuellen Zahl berechnen
• Vorzeichen (±) — Zahlenvorzeichen zum Gegenteil ändern
• Dezimalpunkt (.) — Ganzzahl- und Bruchteil trennen
• Zurücksetzen (C) — zum Standardwert zurückkehren
• Löschen (←) — letztes eingegebenes Symbol entfernen

Erweiterte Funktionen:

• Quadratwurzel (√) — Quadratwurzel der Zahl berechnen
• Potenz (xⁿ) — Zahl zur Potenz erheben
• Fakultät (!) — Fakultät der Zahl berechnen
• Speicher — Werte speichern und wiederherstellen

Hauptmerkmale

• Modernes Interface mit responsivem Design
• Flüssige Animationen und visuelle Effekte
• Intuitive Steuerung mit Maus und Tastatur
• Präzise mathematische Berechnungen
• Unterstützung für komplexe Ausdrücke mit mehreren Operationen
• Potenz-Visualisierung mit Hochstellung

---

🛠️ Installation und Start

Systemanforderungen

• Browser: Jeder moderne Webbrowser (Chrome, Firefox, Safari, Edge)
• JavaScript: ES2015+ Unterstützung (alle modernen Browser)
• Internet: Nicht erforderlich (funktioniert offline)

🌐 GitHub Pages

Rechner ist online verfügbar unter: Ucode Calculator

---

🎮 Steuerung

Taste/Schaltfläche	Aktion
0-9	Ziffern eingeben
+ - × ÷	Arithmetische Operationen
=	Ergebnis berechnen
C	Alle Daten löschen
←	Letztes Symbol löschen
±	Zahlenvorzeichen ändern
.	Dezimalpunkt
%	Prozentsatz berechnen
√	Quadratwurzel
xⁿ	Zur Potenz erheben
!	Fakultät

💾 Speicheroperationen

Schaltfläche	Funktion
MC	Speicher löschen
MR	Aus Speicher abrufen
M+	Zum Speicher hinzufügen
M-	Vom Speicher subtrahieren
MS	Im Speicher ablegen

---

📁 Projektstruktur

Ucode_Calculator/
├── index.html              
├── css/                    # Stile
│   └── style.css          
├── js/                     # JavaScript-Logik
│   └── script.js          
└── README.md              

---

👥 Entwicklungsteam

Rolle	Mitglied	GitHub	Beitrag
Hauptentwickler & Designer	Volodymyr Vovk	1terraflops	Hauptentwicklung, Interface-Design
Teamleiter & Co-Entwickler	Maksym Kopychko	Archie242	Projektmanagement, Logik-Programmierung, Entwicklungsunterstützung

---

🔧 Verwendete Technologien

Programmiersprachen	Stilgestaltung	Entwicklungstools	Plattformen
JavaScript ES2015+ HTML5	CSS3	Git VSCode	GitHub Pages Linux Windows

---

Implementierungsmerkmale

• Modulare Architektur: Trennung von Logik, Stilen und Markup
• ES2015+ Standard: Verwendung moderner JavaScript-Features
• Responsives Design: Funktioniert auf allen Geräten und Bildschirmen
• Optimierte Leistung: Schnelle Berechnungen und flüssige Benutzeroberfläche

---

🌟 Team-Erfolge

✅ Erfolgreich abgeschlossenes Race00 im Rahmen von Ucode Marathon
✅ Vollwertiger Rechner erstellt entsprechend aller Anforderungen
✅ Wissen kombiniert aus fünf Kurs-Sprints
✅ Minimalistisches und benutzerfreundliches Interface für Benutzer

---

📚 Was gelernt wurde

Bei der Rechner-Erstellung wurde Wissen angewendet aus:

• HTML5: Semantisches Markup und Dokumentstruktur
• CSS3: Stilgestaltung, Animationen, responsives Design
• JavaScript ES2015+: Moderne Syntax, Funktionen, Event-Handling
• DOM-Manipulationen: Interaktion mit Seitenelementen
• Git: Versionskontrolle und Teamarbeit

---

Mit Inspiration erstellt vom Team für Ucode Marathon | Race00 | 2025