Ascenda Synthesis Platform

Overview

The Ascenda Synthesis Platform is a TypeScript-based application designed to synthesize data from multiple suppliers. It fetches raw data, maps it to a standardized format, and returns a consolidated list of formatted data to the user. The app supports scalability by allowing new suppliers to be easily integrated.

---

Table of Contents

• 1. Setup Instructions
• 2. Project Structure
• 3. Features
• 4. Architecture
• 5. Testing
• 6. Custom Logger
• 7. Extensible Code
• 8. Tech Stack

---

Setup Instructions

1. Prerequisites

Ensure you have the following installed:

• Node.js (v20.16.0 or higher )
• npm

2. Clone the Repository

git clone git@github.com:MinhTriet0612/ParseRawDataAssignment.git

3. Install Dependencies

cd ParseRawDataAssignment
npm install

4. Run the Application

npm start $1 $2 # $1: Hotel ID , $2: Destination ID

or

./runner.sh $1 $2 # $1: Hotel ID , $2: Destination ID

5. Run Tests

npm test

6. Run Code Coverage

npm run coverage

---

Project Structure

./src
├── app.ts                      # Main entry point of the application
├── context                     # Stores global state
├── controller
│   ├── OperationType.ts        # Enum defining operation types
│   └── SupplierController.ts   # Controller for managing suppliers and operations
├── factory
│   └── SupplierFactory.ts      # Factory for creating supplier-specific operations
├── logger
│   └── Logger.ts               # Utility for logging messages and errors
├── mapper                      # Contains class for mapping query data
├── model                       # Contains domain models
├── operations
│   ├── Operation.ts            # Abstract operation class
│   ├── SupplierOperation.ts    # Base operation class for supplier-related tasks
│   └── impl                    # Concrete implementations of operations
├── pipeline
│   └── Pipeline.ts             # Pipeline for executing operations in sequence
└── queryDTOs                   #  Data transfer objects for binding and transfering supplier data structure
./test
├── controller
├── factory
└── mapper

Features

• Fetch data from multiple suppliers via their URLs.
• Map supplier-specific raw data into a standardized format.
• Queue-based operation pipeline for sequential processing.
• Easy integration for adding new suppliers and new model types dynamically.

---

Architecture

Components

1. Controller:

   • Allocates operations to the corresponding supplier handler based on the URL.
   • Manages a queue of operations for processing supplier data.

2. Operation:

   • Fetches raw data from the assigned supplier.
   • Each operation is unique to a specific supplier.

3. Mapper:

   • Maps supplier-specific data into a standardized format for consistent outputs.

Design Patterns

• Factory Pattern:
  Creates new operation instances dynamically for each supplier URL.
• Pipeline Pattern:
  Ensures sequential execution of operations in a modular and controlled manner.

---

Testing

Overview

• Jest is used for testing the application,
• Primarily focusing on mapper functions to ensure correct data transformation.
• Limitation: The fetch() method for API calls is not mocked in tests, which may lead to dependency on live API responses.

Code Coverage

---------------------------|---------|----------|---------|---------|-------------------------
File                       | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s       
---------------------------|---------|----------|---------|---------|-------------------------
All files                  |   90.71 |    76.07 |   94.28 |   90.44 |                         
 controller                |      80 |    83.33 |   71.42 |   77.77 |                         
  OperationType.ts         |     100 |      100 |     100 |     100 |                         
  SupplierController.ts    |      75 |       75 |   66.66 |      75 | 30-32,39                
 factory                   |   92.85 |       80 |   66.66 |   92.85 |                         
  SupplierFactory.ts       |   92.85 |       80 |   66.66 |   92.85 | 34                      
 logger                    |    87.5 |        0 |     100 |    87.5 |                         
  Logger.ts                |    87.5 |        0 |     100 |    87.5 | 14                      
 mapper                    |     100 |    88.54 |     100 |     100 |                         
  AcmeQueryMapper.ts       |     100 |      100 |     100 |     100 |                         
  PaperFliesQueryMapper.ts |     100 |    88.04 |     100 |     100 | 11-39                   
  PatagoniaQueryMapper.ts  |     100 |      100 |     100 |     100 |                         
 model                     |    92.7 |    80.32 |     100 |   92.55 |                         
  Amentity.ts              |   86.66 |       80 |     100 |   84.61 | 15,27                   
  Hotel.ts                 |     100 |    82.45 |     100 |     100 | 23-29,49-55,65-66,74-80 
  ImageStore.ts            |   81.25 |    66.66 |     100 |   81.25 | 15,27,39                
  Location.ts              |    91.3 |    80.55 |     100 |    91.3 | 14,26                   
 operations                |      70 |       50 |   83.33 |      70 |                         
  SupplierOperation.ts     |      70 |       50 |   83.33 |      70 | 18,23-24,36-37,42       
 operations/impl           |   82.05 |     4.34 |     100 |   80.55 |                         
  AcmeOperation.ts         |     100 |      100 |     100 |     100 |                         
  PaperFliesOperation.ts   |   69.56 |     4.34 |     100 |   68.18 | 31-41,47                
  PatagoniaOperation.ts    |     100 |      100 |     100 |     100 |                         
 pipeline                  |     100 |      100 |     100 |     100 |                         
  Pipeline.ts              |     100 |      100 |     100 |     100 |                         
---------------------------|---------|----------|---------|---------|-------------------------

---

Custom Logger

A simple logger that writes log messages to a file (./app.log) with a timestamp and log level (INFO or ERROR).

Features

• Logs messages to a log file with the format [timestamp] [log level] [message].
• Supports two log levels: INFO and ERROR.
• Writes logs to ./app.log.
• Timestamp is represented as milliseconds since the epoch.
• Example: [2024-11-24T09:54:18.383Z] [ERROR] Failed to fetch data from https://test-api.com/hotels

---

Extensible Code

This project is designed to be highly extensible and reusable, supporting the addition of new operations, models, and data sources without modifying the core pipeline or controller logic.

Adding New Operations

1. Use the addUrlQuery(url: string) method in the SupplierController to add a new operation. The SupplierOperationFactory will automatically create and add the appropriate operation based on the provided URL.
2. The Pipeline<T> class allows adding operations for any model (T) by implementing the Operation<T> interface.

Adding New Models

• To extend beyond the Hotel model, define a new model (e.g., Flight, Car) and its associated operations.
• The Pipeline<T> is generic, making it easy to process data for any model as long as compatible operations are implemented.

Adding New Data Sources

• The operationMap in SupplierOperationFactory enables easy integration of new data sources.
• Simply map the new source's URL to a corresponding OperationType, and the app will handle it using the appropriate parsing and processing logic.
• This mechanism ensures that adding new suppliers or data sources requires minimal changes.

Reusability

• The modular design ensures that components like the pipeline, operations, and factories can be reused across different parts of the application or in new projects.
• The operationMap can be extended or adapted for new suppliers with custom parsing logic, making it reusable in different contexts.

Benefits

• Operations, models, and data sources can be added without altering the core structure.
• The pipeline executes operations sequentially, ensuring scalability.
• The system is flexible and reusable, supporting seamless integration of new models, data sources, and more complex operations with minimal effort.

---

Tech Stack

• Language: TypeScript
• Testing Framework: Jest