Number To Words

Overview

This app convert numeric values to written currency format:

• Input: 123.45
• Output: ONE HUNDRED TWENTY-THREE DOLLARS AND FORTY-FIVE CENTS

Live Demo

The application is deployed and accessible on the Azure.

Features

• Convert numeric amounts to written words
• Support for decimal values up to two decimal places (like real world)
• Comprehensive unit testing with edge cases
• File logging with Serilog

Prerequisites

• .NET 8.0 SDK
• IIS (for local windows deployment testing)

Building the Application

Using .NET CLI

1. Restore dependencies:

dotnet restore

3. Build the solution:

dotnet build

4. Run the application:

dotnet run 

IIS Deployment

For hosting on IIS, follow the official Microsoft documentation.

Azure App Service Deployment

This application is currently deployed on Azure App Service. For deploying your own instance. For a detailed walkthrough, refer to this tutorial.

Project Structure

Numbers-To-Words-Currency-Converter/
├── Numbers-To-Words-Core/           # Web application project
│   ├── Controllers/                 # MVC Controllers
│   ├── Models/                      # View Models
│   ├── Services/                    # Service layer with business logic
│   ├── Views/                       # Views
│   └── wwwroot/                     # Static files
├── Numbers-To-Words-UnitTest/       # Unit tests project
│   ├── Services/                    # Service layer tests
│   └── TestData/                    # Test data files
├── DESIGN_DECISION.md               # Architecture decisions
└── TEST_PLAN.md                     # Testing strategy