https://github.com/waltermillan/collatzconjecture

This conjecture was enunciated by the German mathematician Lothar Collatz in 1937, and consists of applying operations to a positive integer following these two conditions: If the number is even, it is divided by 2. If the number is odd, it is multiplied by 3 and 1 is added to the result.
https://github.com/waltermillan/collatzconjecture

angular-cli csharp css html netcore-webapi typescript

Last synced: 7 months ago
JSON representation

This conjecture was enunciated by the German mathematician Lothar Collatz in 1937, and consists of applying operations to a positive integer following these two conditions: If the number is even, it is divided by 2. If the number is odd, it is multiplied by 3 and 1 is added to the result.

• Host: GitHub
• URL: https://github.com/waltermillan/collatzconjecture
• Owner: waltermillan
• Created: 2025-03-08T20:00:35.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2025-05-10T21:31:37.000Z (8 months ago)
• Last Synced: 2025-05-10T22:26:24.024Z (8 months ago)
• Topics: angular-cli, csharp, css, html, netcore-webapi, typescript
• Language: C#
• Homepage:
• Size: 660 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 📍 CollatzConjecture Project

- Given a positive integer, we seek to generate all the numbers in the Collatz series until reaching the sequence: 4, 2, 1.

- Display historical query information stored in MongoDB.

---

## 📅 Changelog

- **02/04/2025**:

  - **Full Stack**: Added history tracking functionality. Fixed minor bugs.

- **01/04/2025**:

  - **Backend**: Added connection to MongoDB database. Integrated Serilog. 

  - **Frontend**: Added graphical libraries: `@swimlane/ngx-charts`, `d3`, `@angular/cdk`, `@angular/animations`.

- **08/03/2025**:

  - **Backend/Frontend**: Initial upload of code including entities, interfaces, models, and services. Removed `frontend/.vscode` directory.

---

## 🎯 Objective

Practice .NET (C#), Design Patterns, and Onion Architecture.

### Technologies:

- **.NET (C#)** and **SQL Server**

- **Angular (TypeScript)**

- **Design Patterns**

- **Onion Architecture**

---

## 🚀 Features

### 🔧 Backend

Implements common design patterns including BaseEntity, Repository, UnitOfWork, and Factory (for task instance creation).

- Based on **Onion Architecture**

- Applies key **Design Patterns**:

  - `BaseEntity`

  - `UnitOfWork`

  - `Repository` (for data access)

  - `DTO` (Data Transfer Object)

- **Key Libraries**:

  - **Logging**:

    - `Serilog`

    - `Serilog.Settings.Configuration`

    - `Serilog.Sinks.Console`

  - **ORM**:

    - `Microsoft.EntityFrameworkCore`

    - `Microsoft.EntityFrameworkCore.Design`

    - `Microsoft.EntityFrameworkCore.SqlServer`

    - `Microsoft.EntityFrameworkCore.Tools`

    - `MongoDB.Driver` (for connecting to MongoDB)

  - **UI**:

    - `@swimlane/ngx-charts` 18.2.14 (for line charts)

    - `@angular/animations` 18.2.14 (for UI transitions)

---

### 💻 Frontend

- Built with **Angular 18.0.2 / 18.2.14**

- Features:

  - Reactive Forms

  - `AuthService` and HTTP Interceptors

  - Modular architecture

  - Service and model generation

  - Chart visualization using `@swimlane/ngx-charts`

---

### 🗄️ Database

- Uses **MongoDB**, deployed with **Docker Desktop**

- Includes:

  - Entity-Relationship diagram (based on SQL Server schema design)

  - Sample data files (`.json`)

  - **DDL scripts** for schema definition

  - **DML scripts** for sample data insertion

---

## 🧪 Installation

### ✅ Prerequisites

Ensure the following tools are installed:

- [.NET SDK 9.0.200](https://dotnet.microsoft.com/)

- [SQL Express](https://www.microsoft.com/es-es/sql-server/sql-server-downloads)

- [Node.js + npm](https://nodejs.org/) (for the frontend)

- [Postman 11.44.3](https://www.postman.com/downloads/)

- [MongoDB Compass 1.46.1](https://www.mongodb.com/try/download/compass)

---

### 🔧 Setup Steps

1. Clone the repository:

    ```bash

    git clone https://github.com/waltermillan/CollatzConjecture.git

    ```

2. Follow the setup video guide:

    - [Version 1 - Display Version](https://youtu.be/jPAvHBNRJhk)

3. Complete the remaining setup steps as outlined in the project documentation.

---

## 📄 License

This project is licensed under the [MIT License](LICENSE).