ROOMZ OUTLOOK ADD-IN
======================

PURPOSE
-------
While a user is replying to or composing an email in Outlook, this add-in:
1. Opens a RoomZ task pane.
2. Looks up a booking by order ID.
3. Generates the existing RoomZ proforma PDF.
4. Attaches the actual PDF directly to that Outlook draft.

This version does NOT use Microsoft Graph, Microsoft Entra, SendGrid, Web Share,
or a download to the user's computer.

SERVER INSTALLATION
-------------------
1. Copy the entire outlook_addin folder into:

   /rooms/modules/reservations/outlook_addin/

2. Confirm the existing PDF generator is located at:

   /rooms/modules/reservations/proforma_invoice.php

3. The included manifest is already configured for:

   www.macsoftlabs.co.zw

4. The final task pane URL must be reachable over HTTPS:

   https://YOUR-DOMAIN/rooms/modules/reservations/outlook_addin/taskpane.html

5. Keep RoomZ login active in the Outlook add-in pane. The API uses the existing
   RoomZ PHP session and require_login().

INSTALL FOR TESTING
-------------------
Use the completed manifest.xml after replacing the domain.

In Outlook on the web / new Outlook:
- Open an email and click Reply.
- Open Apps / Get Add-ins / Manage add-ins.
- Choose Add a custom add-in or Upload custom add-in.
- Upload manifest.xml.

Microsoft changes menu labels from time to time. An administrator can also
deploy the manifest centrally from Microsoft 365 Integrated Apps.

USER WORKFLOW
-------------
1. Open an email and click Reply.
2. Click the RoomZ / Attach RoomZ PDF command.
3. Enter the booking ID.
4. Click Find.
5. Click Attach PDF to this reply.
6. Continue typing and send the email normally.

IMPORTANT
---------
- HTTPS is required.
- The add-in works only in compose/reply mode.
- The user's RoomZ session must be authenticated inside the add-in webview.
- The API limits PDFs to 3 MB for broad Outlook compatibility.
- Do not expose the API without require_login().
