init: initial setup for one suit documents

Author: krushit-redsoft

.github/workflows/deploy.yml

@@ -0,0 +1,24 @@
+name: Deploy MkDocs
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+
+      - name: Set up Python
+        uses: actions/setup-python@v3
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: Deploy MkDocs
+        run: mkdocs gh-deploy

.gitignore

@@ -0,0 +1 @@
+venv

README.md

@@ -1,2 +1,96 @@
-# one-docs
-Docs for OneLead and OneInbox product
+# one-docs (One Suite Documentation)
+
+Welcome to the official documentation for One Suite, which includes the following products:
+- **OneLead** - A Frappe-based app for Meta and Google integration. [OneLead Repository](https://github.com/redsoftware-hq/onelead)
+- **OneInbox** - A unified inbox solution. [OneInbox Repository](https://github.com/redsoftware-hq/oneinbox)
+- **OneInbox_WhatsApp** - WhatsApp integration for seamless communication. [(Forked frappe_whatsapp)](https://github.com/shridarpatil/frappe_whatsapp)
+
+This repository contains the documentation for these products, built using **MkDocs** with the Material theme. The documentation is hosted on GitHub Pages.
+
+## Local Setup
+
+To run the documentation locally and make changes, follow these steps:
+
+### Prerequisites
+Ensure you have the following installed:
+- **Python (3.x)**: [Download here](https://www.python.org/downloads/)
+- **Git**: [Download here](https://git-scm.com/downloads)
+
+
+### Installation Steps
+1. **Clone the Repository**
+   ```bash
+   git clone https://github.com/YOUR_GITHUB_USERNAME/one-docs.git
+   cd one-docs
+   ```
+2. **(Optional) Virtual Environment**
+   ```bash
+    python -m venv venv
+    source venv/bin/activate  # On Mac/Linux
+    venv\Scripts\activate     # On Windows
+   ```
+
+3. **Install Dependencies**
+   ```bash
+   pip install mkdocs-material
+   ```
+   or
+  ```bash
+  pip install -r requirements.txt
+  ```
+
+4. **Run Locally**
+   ```bash
+   mkdocs serve
+   ```
+   This will start a local server at:
+   ```bash
+   http://127.0.0.1:8000/
+   ```
+   Open this link in your browser to preview the documentation.
+
+5. **Stop the Server**
+   To stop the local server, press **Ctrl + C** in the terminal.
+
+---
+
+## Contribution Guide
+
+We welcome contributions to improve this documentation. Follow these guidelines to contribute:
+
+### 1. If You Make Changes in OneLead or OneInbox
+- If you **raise a Pull Request (PR) in OneLead or OneInbox**, please ensure that you **also update the relevant documentation in this repository**.
+- Attach the **OneLead/OneInbox PR** to the **documentation PR** for reference.
+- Ensure that the documentation clearly explains any new features, API changes, or installation steps.
+
+### 2. Make Your Changes
+- Edit Markdown files in the `docs/` directory.
+- Follow the existing structure when adding new documentation.
+- Use **clear and concise language**.
+- Include **code snippets, screenshots, or examples** where relevant.
+- Run `mkdocs serve` to preview your changes before submitting a PR.
+
+### 3. Follow Contribution Guidelines
+- Ensure documentation is **accurate and up to date**.
+- Use **proper formatting and Markdown syntax**.
+- Keep descriptions **clear and user-friendly**.
+- For API changes, **include request and response examples**.
+- If adding a new section, update `mkdocs.yml` for navigation.
+
+
+## Deployment  (restricted to maintainers and auto-deploy on PR merge)
+
+To deploy updates to GitHub Pages, run:
+```bash
+mkdocs gh-deploy
+```
+This will build and publish the documentation at:
+```
+https://yourusername.github.io/one-docs/
+```
+
+
+## License
+This documentation is released under the **MIT License**.
+
+For any questions or feedback, feel free to open an issue in this repository.

docs/index.md

@@ -0,0 +1,19 @@
+# OneLead - Lead Management Solution
+
+OneLead is a **Frappe-based lead management system** designed to seamlessly integrate with multiple lead sources, including **Meta (Facebook) Leads** and **Google Leads**. It automates lead collection, processing, and assignment within your business workflow.
+
+## Lead Sources
+
+### 🔹 Meta Leads
+OneLead integrates with **Meta (Facebook) Lead Ads**, allowing businesses to **automatically capture** leads from Facebook and Instagram ad campaigns, map them to internal CRM systems, and assign them to sales teams.
+
+### 🔹 Google Leads
+With OneLead's **Google Lead Integration**, you can fetch leads directly from **Google Ads Lead Form Extensions**, ensuring that every inquiry is instantly available in your CRM for follow-up.
+
+## Features
+- 🔄 **Automated lead fetching** from Meta & Google.
+- 📌 **Custom mapping** to internal lead structures.
+- 📊 **Lead tracking & assignment** based on business rules.
+- 🔗 **Webhook-based integration** for real-time updates.
+
+Proceed to **Meta Integration** for detailed setup instructions.

docs/oneinbox/index.md

@@ -0,0 +1,17 @@
+# Meta Integration for OneLead
+
+OneLead provides **seamless integration with Meta (Facebook) Lead Ads**, ensuring that leads from your Facebook and Instagram campaigns are instantly available in your CRM.
+
+## How It Works
+- **Captures leads** from Facebook Lead Forms via webhooks.
+- **Maps leads** to internal CRM structures based on configurations.
+- **Assigns leads** to users or teams automatically.
+- **Tracks lead performance** through analytics.
+
+## Key Setup Steps
+1. **Register a Meta App** on the [Facebook Developer Portal](https://developers.facebook.com/).
+2. **Configure Webhooks** to receive real-time lead data.
+3. **Generate and validate User Access Tokens**.
+4. **Map Meta Ad Pages and Forms** inside OneLead.
+
+For a complete guide on **Meta Webhook Configuration**, go to [Meta Webhook Config](meta_webhook_config.md).