Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

feat(ruddr): add 4 missing tables to the Ruddr source (#129995)

Tom Owersbb96e7046a15
diff --git a/products/warehouse_sources/backend/temporal/data_imports/sources/COVERAGE_GAPS_APPENDIX.md b/products/warehouse_sources/backend/temporal/data_imports/sources/COVERAGE_GAPS_APPENDIX.md
index 7e5bcb2ec3a5..a3e49995f228 100644
--- a/products/warehouse_sources/backend/temporal/data_imports/sources/COVERAGE_GAPS_APPENDIX.md
+++ b/products/warehouse_sources/backend/temporal/data_imports/sources/COVERAGE_GAPS_APPENDIX.md
@@ -10483,7 +10483,7 @@ Note: Per-version download counts are already included in the synced `versions`
## Ruddr — **thin**
-Today (13): `allocations`, `clients`, `invoice_items`, `invoices`, `members`, `pipeline_activities`, `project_prepayments`, `project_roles`, `project_tasks`, `projects`, `task_categories`, `time_entries`, `timesheet_attestations`
+Today (17): `allocations`, `clients`, `invoice_items`, `invoices`, `members`, `opportunities`, `opportunity_stages`, `pipeline_activities`, `project_health_reports`, `project_members`, `project_prepayments`, `project_roles`, `project_tasks`, `projects`, `task_categories`, `time_entries`, `timesheet_attestations`
Diffed against: <https://docs.ruddr.io/llms.txt>
@@ -10494,17 +10494,17 @@ Diffed against: <https://docs.ruddr.io/llms.txt>
- [x] `invoices` — billing and revenue, entirely absent from the current 5 tables (high)
- [x] `invoice-items` — line-item revenue tied back to projects and time entries (high)
- [x] `allocations` — planned resource allocation to compare against logged time entries (high)
-- [ ] `project-members` — membership table joining members to the projects we already sync (high)
-- [ ] `opportunities` — the sales pipeline, a whole analytical domain currently unavailable (high)
-- [ ] `opportunity-stages` — lookup table resolving the stage IDs carried on opportunities (high)
+- [x] `project-members` — membership table joining members to the projects we already sync (high)
+- [x] `opportunities` — the sales pipeline, a whole analytical domain currently unavailable (high)
+- [x] `opportunity-stages` — lookup table resolving the stage IDs carried on opportunities (high)
- [x] `project-roles` — lookup resolving the role IDs on project members and time entries (high)
- [ ] `project-expenses` — cost side of project profitability (medium)
- [ ] `payments` — cash collection against invoices (medium)
- [ ] `timesheets` — submission and approval state wrapping the time entries we sync (medium)
-- [ ] `project-health-reports` — periodic project status history, a natural trend series (medium)
+- [x] `project-health-reports` — periodic project status history, a natural trend series (medium)
- [ ] `practices` — lookup resolving the practice/org-unit IDs on members and projects (medium)
-Note: Ruddr documents roughly 78 list endpoints; the connector exposes 13. Beyond those listed, whole domains are unsynced: project budget items (service/product/other/expense, plus monthly variants), revenue recognition entries, revenue adjustments, credit notes, tax rates, cost periods, exchange rate periods, utilization target periods, contacts, companies, expense reports, holidays, skills, disciplines, job titles and member levels. Static endpoint catalog, no dynamic discovery.
+Note: Ruddr documents roughly 78 list endpoints; the connector exposes 17. Beyond those listed, whole domains are unsynced: project budget items (service/product/other/expense, plus monthly variants), revenue recognition entries, revenue adjustments, credit notes, tax rates, cost periods, exchange rate periods, utilization target periods, contacts, companies, expense reports, holidays, skills, disciplines, job titles and member levels. Static endpoint catalog, no dynamic discovery.
## RunPod — adequate
diff --git a/products/warehouse_sources/sources/ruddr/canonical_descriptions.py b/products/warehouse_sources/sources/ruddr/canonical_descriptions.py
index 14405ba66afd..1c55e5b6d0f3 100644
--- a/products/warehouse_sources/sources/ruddr/canonical_descriptions.py
+++ b/products/warehouse_sources/sources/ruddr/canonical_descriptions.py
@@ -236,4 +236,98 @@ CANONICAL_DESCRIPTIONS: CanonicalDescriptions = {
"modifiedAt": "When the allocation was last modified. Null for allocations from time entries or holidays.",
},
},
+ "project_members": {
+ "description": "A workspace member assigned to a project team in Ruddr, with their project rates and budget.",
+ "docs_url": "https://docs.ruddr.io/api-reference/project-members/list-project-members",
+ "columns": {
+ "id": "The unique ID of the project member.",
+ "typeId": "The project member type (collaborator or administrator).",
+ "isActive": "Whether the member is active on the project team.",
+ "isBillable": "Whether the member is billable on the project. Used only when the project does not use roles.",
+ "rate": "The member's billing rate for the project. Used only when the project does not use roles.",
+ "overrideCostRate": "Whether the member's cost rate is overridden for this project.",
+ "costCurrency": "The ISO 4217 currency code of the overridden cost rate.",
+ "costPerHour": "The overridden cost per hour for this project member.",
+ "overheadCostPerHour": "The overridden overhead cost per hour for this project member.",
+ "createdAt": "When the project member was created.",
+ "member": "The workspace member assigned to the project.",
+ "project": "The project this member belongs to.",
+ "roles": "The project roles assigned to this member. Null when the project does not use roles.",
+ "budget": "The member's budget hours for the project.",
+ "monthlyBudget": "The member's monthly budget hours for the project.",
+ "rateCards": "The member's rates on each project rate card, earliest first.",
+ },
+ },
+ "opportunities": {
+ "description": "A sales opportunity in a Ruddr pipeline.",
+ "docs_url": "https://docs.ruddr.io/api-reference/opportunities/list-opportunities",
+ "columns": {
+ "id": "The unique ID of the opportunity.",
+ "name": "The name of the opportunity.",
+ "description": "A description of the opportunity.",
+ "nextSteps": "The next steps for the opportunity.",
+ "amount": "The monetary amount of the opportunity.",
+ "probability": "The probability that the opportunity closes successfully, as a decimal between 0 and 1.",
+ "priorityId": "The priority level of the opportunity.",
+ "openDate": "The date the opportunity was opened.",
+ "closeDate": "The expected close date of the opportunity.",
+ "currency": "The 3-letter currency code of the opportunity.",
+ "weightedAmount": "The amount multiplied by the probability.",
+ "owner": "The owner of the opportunity.",
+ "opportunityLeadSource": "The lead source of the opportunity.",
+ "opportunityType": "The type of the opportunity.",
+ "tags": "The tags on the opportunity.",
+ "practice": "The practice associated with the opportunity.",
+ "businessUnit": "The business unit associated with the opportunity.",
+ "company": "The company associated with the opportunity.",
+ "projects": "The projects associated with the opportunity.",
+ "opportunityStage": "The current stage of the opportunity.",
+ "opportunityPipeline": "The pipeline the opportunity belongs to.",
+ "timeSpent": "The total time spent in minutes across all pipeline activities.",
+ "salesforceId": "The Salesforce opportunity ID, when synced through the Salesforce integration.",
+ "hubspotId": "The HubSpot deal ID, when synced through the HubSpot integration.",
+ "createdAt": "When the opportunity was created.",
+ "modifiedAt": "When the opportunity was last modified.",
+ },
+ },
+ "opportunity_stages": {
+ "description": "A stage in a Ruddr opportunity pipeline.",
+ "docs_url": "https://docs.ruddr.io/api-reference/opportunity-stages/list-opportunity-stages",
+ "columns": {
+ "id": "The unique ID of the opportunity stage.",
+ "name": "The name of the opportunity stage.",
+ "description": "The description of the opportunity stage.",
+ "probability": "The win probability for opportunities at this stage, as a decimal between 0 and 1.",
+ "statusId": "The status of the stage.",
+ "isActive": "Whether the opportunity stage is active.",
+ "opportunityPipelineId": "The ID of the opportunity pipeline the stage belongs to.",
+ "createdAt": "When the opportunity stage was created.",
+ },
+ },
+ "project_health_reports": {
+ "description": "A dated health report on a Ruddr project, with health ratings and budget against actual metrics.",
+ "docs_url": "https://docs.ruddr.io/api-reference/project-health-reports/list-project-health-reports",
+ "columns": {
+ "id": "The unique ID of the health report.",
+ "date": "The date of the health report.",
+ "project": "The project this health report belongs to.",
+ "useBudget": "Whether budget metrics are included in this report.",
+ "budgetHealthId": "The budget health status of the project.",
+ "clientSatisfactionId": "The client satisfaction level of the project.",
+ "scheduleHealthId": "The schedule health status of the project.",
+ "teamSatisfactionId": "The team satisfaction level of the project.",
+ "score": "The overall score of the health report.",
+ "totalHours": "The actual total hours logged against the project in this period.",
+ "totalRevenue": "The actual total revenue for the project in this period.",
+ "totalCost": "The actual total cost for the project in this period.",
+ "totalGrossMargin": "The actual total gross margin for the project, as a decimal.",
+ "budgetTotalHours": "The total budgeted hours for the project.",
+ "budgetTotalRevenue": "The total budgeted revenue for the project.",
+ "budgetTotalCost": "The total budgeted cost for the project.",
+ "notes": "General commentary for the health report.",
+ "createdBy": "The member who created the health report.",
+ "modifiedBy": "The member who last modified the health report.",
+ "createdAt": "When the health report was created.",
+ },
+ },
}
diff --git a/products/warehouse_sources/sources/ruddr/settings.py b/products/warehouse_sources/sources/ruddr/settings.py
index c99174e7c021..03bf29b13d4a 100644
--- a/products/warehouse_sources/sources/ruddr/settings.py
+++ b/products/warehouse_sources/sources/ruddr/settings.py
@@ -26,6 +26,10 @@ RUDDR_ENDPOINTS: dict[str, RuddrEndpointConfig] = {
"invoices": RuddrEndpointConfig(name="invoices", path="/invoices"),
"invoice_items": RuddrEndpointConfig(name="invoice_items", path="/invoice-items"),
"allocations": RuddrEndpointConfig(name="allocations", path="/allocations"),
+ "project_members": RuddrEndpointConfig(name="project_members", path="/project-members"),
+ "opportunities": RuddrEndpointConfig(name="opportunities", path="/opportunities"),
+ "opportunity_stages": RuddrEndpointConfig(name="opportunity_stages", path="/opportunity-stages"),
+ "project_health_reports": RuddrEndpointConfig(name="project_health_reports", path="/project-health-reports"),
}
ENDPOINTS = tuple(RUDDR_ENDPOINTS.keys())
diff --git a/products/warehouse_sources/sources/ruddr/tests/test_ruddr.py b/products/warehouse_sources/sources/ruddr/tests/test_ruddr.py
index 0c3696d1fc8f..dd6ae51fc7ef 100644
--- a/products/warehouse_sources/sources/ruddr/tests/test_ruddr.py
+++ b/products/warehouse_sources/sources/ruddr/tests/test_ruddr.py
@@ -67,6 +67,10 @@ class TestPagination:
("invoices", "https://www.ruddr.io/api/workspace/invoices"),
("invoice_items", "https://www.ruddr.io/api/workspace/invoice-items"),
("allocations", "https://www.ruddr.io/api/workspace/allocations"),
+ ("project_members", "https://www.ruddr.io/api/workspace/project-members"),
+ ("opportunities", "https://www.ruddr.io/api/workspace/opportunities"),
+ ("opportunity_stages", "https://www.ruddr.io/api/workspace/opportunity-stages"),
+ ("project_health_reports", "https://www.ruddr.io/api/workspace/project-health-reports"),
]
)
def test_request_targets_endpoint_path(self, endpoint: str, expected_url: str) -> None: