diff --git a/README.md b/README.md
new file mode 100644
index 00000000..d4669c5c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,345 @@
+#
Imputation – Automated Reporting & Power BI Analytics Platform
+
+---
+
+## Overview
+
+Imputation is a Python-based automation and Business Intelligence platform designed to generate structured operational reports and feed analytical dashboards in Power BI.
+
+The project is divided into two main components:
+
+| Component | Purpose |
+|:---:|:---:|
+| `reportcreator.ipynb` | Automatically generates operational reports |
+| `Untitled-1.ipynb` | Processes and prepares data for Power BI |
+| `BDpowerbi.xlsx` | Central analytical database |
+| `imputation.pbix` | Interactive Power BI dashboard |
+
+The solution was developed to automate the complete workflow between:
+
+- Data collection
+- Data transformation
+- Report generation
+- KPI analysis
+- Interactive dashboard visualization
+
+---
+
+# Main Architecture
+
+```txt
+Operational Data
+ ↓
+reportcreator.ipynb
+ ↓
+Structured Reports
+ ↓
+Untitled-1.ipynb
+ ↓
+BDpowerbi.xlsx
+ ↓
+imputation.pbix
+ ↓
+Power BI Dashboards
+```
+
+---
+
+# Project Components
+
+| File | Description |
+|:---:|:---:|
+| `reportcreator.ipynb` | Report generation engine |
+| `Untitled-1.ipynb` | Data transformation & Power BI loader |
+| `BDpowerbi.xlsx` | Analytical database |
+| `imputation.pbix` | Power BI dashboard |
+| `README.md` | Project documentation |
+
+---
+
+# ReportCreator Module
+
+## Purpose
+
+The `reportcreator.ipynb` notebook is responsible for:
+
+- Processing operational information
+- Structuring report data
+- Automating report generation
+- Standardizing outputs
+- Preparing data for analytical consumption
+
+---
+
+## Main Features
+
+| Feature | Description |
+|:---:|:---:|
+| Automated Reporting | Generates structured operational reports |
+| Data Formatting | Normalizes report information |
+| Data Structuring | Organizes analytical fields |
+| Operational Summaries | Creates report summaries |
+| Export Preparation | Prepares output for Power BI ingestion |
+
+---
+
+# Power BI Loader Module
+
+## Purpose
+
+The `Untitled-1.ipynb` notebook acts as the ETL/data preparation layer used to populate the Power BI analytical database.
+
+Its main role is to:
+
+- Read generated report data
+- Clean and transform information
+- Prepare analytical datasets
+- Feed the Power BI database
+
+---
+
+## Main Features
+
+| Feature | Description |
+|:---:|:---:|
+| Data Cleaning | Removes invalid or incomplete data |
+| Data Transformation | Formats analytical fields |
+| KPI Preparation | Structures metrics for dashboards |
+| Excel Integration | Updates `BDpowerbi.xlsx` |
+| Analytical Structuring | Optimizes data for Power BI |
+
+---
+
+# Analytical Database
+
+## BDpowerbi.xlsx
+
+This Excel file serves as the central analytical repository used by Power BI.
+
+### Purpose
+
+- Store transformed operational data
+- Maintain KPI-ready datasets
+- Serve as Power BI datasource
+- Centralize reporting information
+
+---
+
+# Power BI Dashboard
+
+## imputation.pbix
+
+The Power BI dashboard provides interactive analytical visualization of the processed operational data.
+
+---
+
+## Dashboard Capabilities
+
+| Capability | Description |
+|:---:|:---:|
+| KPI Monitoring | Performance indicators |
+| Operational Analysis | Process visualization |
+| Interactive Filtering | Dynamic slicers and filters |
+| Trend Analysis | Historical evolution |
+| Report Visualization | Structured dashboard insights |
+
+---
+
+# Technologies Used
+
+| Technology | Purpose |
+|:---:|:---:|
+| Python | Main programming language |
+| Jupyter Notebook | Automation environment |
+| Pandas | Data processing |
+| OpenPyXL | Excel integration |
+| Power BI | Dashboard visualization |
+| Excel | Analytical database |
+| DAX | KPI calculations |
+
+---
+
+# Workflow
+
+## Step 1 – Report Generation
+
+`reportcreator.ipynb`
+
+- Generates operational reports
+- Structures report data
+- Standardizes analytical information
+
+↓
+
+## Step 2 – Data Preparation
+
+`Untitled-1.ipynb`
+
+- Reads generated reports
+- Cleans data
+- Transforms datasets
+- Loads analytical structures
+
+↓
+
+## Step 3 – Database Population
+
+`BDpowerbi.xlsx`
+
+- Stores transformed information
+- Centralizes KPI datasets
+
+↓
+
+## Step 4 – Dashboard Visualization
+
+`imputation.pbix`
+
+- Displays dashboards
+- Generates interactive analytics
+- Supports KPI monitoring
+
+---
+
+# Main Functionalities
+
+## Automated Reporting
+
+- Structured report generation
+- Standardized output formatting
+- Data organization
+
+---
+
+## ETL Processing
+
+- Extraction
+- Transformation
+- Loading
+- Cleaning
+- Validation
+
+---
+
+## Business Intelligence
+
+- KPI dashboards
+- Analytical metrics
+- Interactive visualization
+- Trend analysis
+
+---
+
+# Requirements
+
+| Requirement | Description |
+|:---:|:---:|
+| Python 3.10+ | Required |
+| Jupyter Notebook | Notebook execution |
+| Power BI Desktop | Dashboard visualization |
+| Excel | Database handling |
+
+---
+
+# Required Libraries
+
+Install dependencies:
+
+```bash
+pip install pandas openpyxl notebook
+```
+
+---
+
+# How to Use
+
+## 1. Generate Reports
+
+Open:
+
+```txt
+reportcreator.ipynb
+```
+
+Execute all cells.
+
+---
+
+## 2. Load Power BI Database
+
+Open:
+
+```txt
+Untitled-1.ipynb
+```
+
+Execute all cells to update:
+
+```txt
+BDpowerbi.xlsx
+```
+
+---
+
+## 3. Open Power BI Dashboard
+
+Launch:
+
+```txt
+imputation.pbix
+```
+
+Refresh the datasource if necessary.
+
+---
+
+# Intended Use Cases
+
+- Operational reporting
+- KPI automation
+- Process analytics
+- Data transformation workflows
+- Business Intelligence reporting
+- Dashboard automation
+- ETL prototyping
+
+---
+
+# Future Improvements
+
+- SQL database integration
+- Real-time Power BI refresh
+- Web dashboard deployment
+- API integration
+- Automated scheduling
+- Cloud ETL pipelines
+- Machine learning analytics
+
+---
+
+# Security Notes
+
+This project may process operational and analytical business data.
+
+Users should:
+
+- Protect Excel datasets
+- Validate generated reports
+- Secure Power BI dashboards
+- Control data access permissions
+
+---
+
+# Disclaimer
+
+This project was developed for automation, reporting and Business Intelligence purposes.
+
+Users remain responsible for validating analytical outputs and operational decisions before production usage.
+
+---
+
+# Author
+
+José Garcia
+Data Scientist
+Business Intelligence & Process Digitalization
\ No newline at end of file