Vangest/README.md

# <div align="center">Vangest – Excel VBA Production Management Tool</div>

---

## <div align="center">Overview</div>

Vangest is a Microsoft Excel VBA-based management tool designed to support production monitoring, machine-hour control, reporting automation and KPI visualization.

The workbook uses VBA macros, UserForms, automated PDF exports, Outlook integration and Power BI access to simplify operational reporting across different production areas.

---

# <div align="center">Main Features</div>

## User Authentication

- Login system with user/password validation
- User registration form
- Restricted access to management menus
- Workbook auto-save on exit

---

## Production Area Management

The system organizes machines by production area:

| Area | Description |
|:---:|:---:|
| Small Moulds | Small mould production machines |
| Medium Moulds | Medium mould production machines |
| Large Moulds | Large mould production machines |
| DT2 / Automation | Automation and complementary production areas |

---

## Machine Hour Registration

The workbook allows the user to insert and manage weekly machine-hour values for several machines, including:

| Small Moulds | Medium Moulds | Large Moulds |
|:---:|:---:|:---:|
| Makino D500_1 | Makino F5_nova | DMU 160P |
| Makino D500_2 | Makino F8 | DMU 340 Gantry |
| Makino V33 | DMU 70 Evo CNC | Awea |
| Kern | DMU 50 Evo | FPT60 |
| Ingersoll CNC | DMC 100V | FPT80 |
| Makino U3 | Sodick AG100L | DMC 125 |
| GF Cut 2000S | Fanuc Robocut | Sodick AQ15L |

---

# <div align="center">VBA Automation</div>

## Main VBA Functionalities

| Module / Feature | Description |
|:---:|:---:|
| Login Form | Validates user access |
| Registration Form | Adds users to the workbook database |
| Menu Form | Central navigation interface |
| Weekly Hours Form | Inserts machine-hour values |
| PDF Export | Exports predefined Excel ranges to PDF |
| Outlook Automation | Creates and sends emails with reports attached |
| Power BI Shortcut | Opens the associated Power BI dashboard |
| Cache Cleaning | Clears temporary or calculated values |
| Sheet Creation | Creates yearly sheets based on templates |

---

# <div align="center">Report Generation</div>

The workbook can generate PDF reports for:

- Small Moulds
- Medium Moulds
- Large Moulds
- DT2 / Automation
- General listings
- Weekly machine-hour summaries

Generated reports are exported from predefined Excel ranges and can be automatically attached to Outlook emails.

---

# <div align="center">Outlook Integration</div>

The VBA macros include Microsoft Outlook automation for:

- Creating email messages
- Defining recipients
- Adding subjects
- Writing automatic message bodies
- Attaching generated PDF reports
- Sending weekly reports

Example report subjects include:

```txt
Small Mould Semana
Medium Mould Semana
Large Mould Semana
DT2 Mould Semana
```

---

# <div align="center">Power BI Integration</div>

The workbook includes a shortcut to open a Power BI dashboard file:

```txt
Vangest.pbix
```

This allows the user to access KPI visualizations linked to the Excel-based production data.

---

# <div align="center">Technologies Used</div>

| Technology | Purpose |
|:---:|:---:|
| Microsoft Excel | Main platform |
| VBA | Automation logic |
| UserForms | Graphical user interface |
| Outlook VBA Automation | Email reporting |
| Power BI | KPI visualization |
| PDF Export | Report generation |
| Excel Charts | Data visualization |

---

# <div align="center">Workbook Structure</div>

```txt
Vangest.xltm.xlsm
├── Registos
├── Gráficos
├── Small Moulds
├── Medium Moulds
├── Large Moulds
├── Automation / DT2
├── UserForms
└── VBA Modules
```

---

# <div align="center">Main Workflow</div>

```txt
User Login
     ↓
Select Production Area
     ↓
Choose Machine
     ↓
Insert Weekly Values
     ↓
Update Excel Records
     ↓
Generate Reports
     ↓
Export PDF
     ↓
Send by Outlook
     ↓
Open Power BI Dashboard
```

---

# <div align="center">Key Functional Areas</div>

## Data Registration

- Weekly machine-hour input
- Machine selection through ComboBoxes
- Area-based categorization
- Automatic workbook saving

## Reporting

- PDF report generation
- Weekly report exports
- Automatic file naming with date/time

## Dashboard Support

- Excel chart-based analysis
- Power BI file launching
- KPI reporting support

## User Management

- Login validation
- User registration
- Permission-based access logic

---

# <div align="center">Requirements</div>

| Requirement | Description |
|:---:|:---:|
| Microsoft Excel | Required to run the workbook |
| VBA Macros Enabled | Required for automation |
| Microsoft Outlook | Required for email automation |
| Power BI Desktop | Required to open `.pbix` dashboards |
| Windows OS | Recommended environment |

---

# <div align="center">How to Use</div>

1. Open the workbook.
2. Enable macros.
3. Login using a valid user.
4. Access the main menu.
5. Select the desired production area.
6. Insert machine-hour values.
7. Generate reports.
8. Export PDFs.
9. Send reports through Outlook.
10. Open Power BI dashboard if needed.

---

# <div align="center">Security Notes</div>

This workbook contains VBA macros and should only be used in a trusted environment.

Before execution:

- Verify the source of the file
- Enable macros only if trusted
- Review email recipients before sending reports
- Confirm PDF outputs before distribution

---

# <div align="center">Future Improvements</div>

- Replace hardcoded paths with dynamic configuration
- Add database integration
- Improve user authentication
- Add role-based permissions
- Create automatic backup system
- Improve error handling
- Add configuration sheet for email recipients
- Migrate reporting logic to Power BI or web dashboard

---

# <div align="center">Disclaimer</div>

This workbook was developed as an internal production management and reporting automation tool.

Users remain responsible for validating inserted data, exported reports and email recipients before official use.

---

# <div align="center">Author</div>

José Garcia  
Data Scientist  
Process Digitalization & Automation