Fix route order: Move POST /recommendations/check before GET /recommendations/{user_id} to prevent 405 error

Smart_Budget_Recommendation_API.postman_collection.json

@@ -1,398 +1,246 @@
 {
 	"info": {
-	  "_postman_id": "smart-budget-recommendation-api",
-	  "name": "Smart Budget Recommendation API",
-	  "description": "API collection for Smart Budget Recommendation service deployed on Hugging Face",
-	  "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
-	},
-	"auth": {
-	  "type": "bearer",
-	  "bearer": [
-		{
-		  "key": "token",
-		  "value": "{{hf_token}}",
-		  "type": "string"
-		}
-	  ]
+		"_postman_id": "smart-budget-recommendation-api",
+		"name": "Smart Budget Recommendation API",
+		"description": "API collection for Smart Budget Recommendation service",
+		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
 	},
 	"item": [
-	  {
-		"name": "Health Check",
-		"request": {
-		  "method": "GET",
-		  "header": [],
-		  "url": {
-			"raw": "https://logicgoinfotechspaces-smart-budget-recommendation.hf.space/health",
-			"protocol": "https",
-			"host": [
-			  "logicgoinfotechspaces-smart-budget-recommendation",
-			  "hf",
-			  "space"
-			],
-			"path": [
-			  "health"
-			]
-		  },
-		  "description": "Check if the API and database are running"
-		}
-	  },
-	  {
-		"name": "Root Endpoint",
-		"request": {
-		  "method": "GET",
-		  "header": [],
-		  "url": {
-			"raw": "https://logicgoinfotechspaces-smart-budget-recommendation.hf.space/",
-			"protocol": "https",
-			"host": [
-			  "logicgoinfotechspaces-smart-budget-recommendation",
-			  "hf",
-			  "space"
-			],
-			"path": [
-			  ""
-			]
-		  }
-		}
-	  },
-	  {
-		"name": "Create Expense",
-		"request": {
-		  "method": "POST",
-		  "header": [
-			{
-			  "key": "Content-Type",
-			  "value": "application/json"
-			}
-		  ],
-		  "body": {
-			"mode": "raw",
-			"raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"amount\": 3800,\n  \"category\": \"Groceries\",\n  \"description\": \"Monthly groceries\",\n  \"date\": \"2025-01-15T00:00:00\",\n  \"type\": \"expense\"\n}"
-		  },
-		  "url": {
-			"raw": "https://logicgoinfotechspaces-smart-budget-recommendation.hf.space/expenses",
-			"protocol": "https",
-			"host": [
-			  "logicgoinfotechspaces-smart-budget-recommendation",
-			  "hf",
-			  "space"
-			],
-			"path": [
-			  "expenses"
-			]
-		  },
-		  "description": "Create a new expense record"
-		}
-	  },
-	  {
-		"name": "Get Expenses",
-		"request": {
-		  "method": "GET",
-		  "header": [],
-		  "url": {
-			"raw": "https://logicgoinfotechspaces-smart-budget-recommendation.hf.space/expenses?user_id={{user_id}}&limit=20",
-			"protocol": "https",
-			"host": [
-			  "logicgoinfotechspaces-smart-budget-recommendation",
-			  "hf",
-			  "space"
-			],
-			"path": [
-			  "expenses"
-			],
-			"query": [
-			  {
-				"key": "user_id",
-				"value": "{{user_id}}",
-				"description": "User identifier"
-			  },
-			  {
-				"key": "limit",
-				"value": "20",
-				"description": "Maximum number of expenses to return"
-			  }
-			]
-		  },
-		  "description": "Get expenses for a specific user"
-		}
-	  },
-	  {
-		"name": "Create Budget",
-		"request": {
-		  "method": "POST",
-		  "header": [
-			{
-			  "key": "Content-Type",
-			  "value": "application/json"
-			}
-		  ],
-		  "body": {
-			"mode": "raw",
-			"raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"category\": \"Groceries\",\n  \"amount\": 4000,\n  \"period\": \"monthly\",\n  \"start_date\": \"2025-02-01T00:00:00\",\n  \"end_date\": \"2025-02-28T00:00:00\"\n}"
-		  },
-		  "url": {
-			"raw": "https://logicgoinfotechspaces-smart-budget-recommendation.hf.space/budgets",
-			"protocol": "https",
-			"host": [
-			  "logicgoinfotechspaces-smart-budget-recommendation",
-			  "hf",
-			  "space"
-			],
-			"path": [
-			  "budgets"
-			]
-		  },
-		  "description": "Create a new budget"
-		}
-	  },
-	  {
-		"name": "Get Budgets",
-		"request": {
-		  "method": "GET",
-		  "header": [],
-		  "url": {
-			"raw": "https://logicgoinfotechspaces-smart-budget-recommendation.hf.space/budgets?user_id={{user_id}}",
-			"protocol": "https",
-			"host": [
-			  "logicgoinfotechspaces-smart-budget-recommendation",
-			  "hf",
-			  "space"
-			],
-			"path": [
-			  "budgets"
-			],
-			"query": [
-			  {
-				"key": "user_id",
-				"value": "{{user_id}}"
-			  }
-			]
-		  },
-		  "description": "Get budgets for a specific user"
-		}
-	  },
-	  {
-		"name": "Get Smart Budget Recommendations",
-		"request": {
-		  "method": "GET",
-		  "header": [],
-		  "url": {
-			"raw": "https://logicgoinfotechspaces-smart-budget-recommendation.hf.space/recommendations/{{user_id}}?month=2&year=2025",
-			"protocol": "https",
-			"host": [
-			  "logicgoinfotechspaces-smart-budget-recommendation",
-			  "hf",
-			  "space"
-			],
-			"path": [
-			  "recommendations",
-			  "{{user_id}}"
-			],
-			"query": [
-			  {
-				"key": "month",
-				"value": "2",
-				"description": "Target month (1-12), optional - defaults to next month"
-			  },
-			  {
-				"key": "year",
-				"value": "2025",
-				"description": "Target year, optional - defaults to next year"
-			  }
-			]
-		  },
-		  "description": "Get smart budget recommendations based on past spending behavior. Uses expenses, then budgets as fallback."
-		}
-	  },
-	  {
-		"name": "Get Category Expenses",
-		"request": {
-		  "method": "GET",
-		  "header": [],
-		  "url": {
-			"raw": "https://logicgoinfotechspaces-smart-budget-recommendation.hf.space/category-expenses/{{user_id}}?months=3",
-			"protocol": "https",
-			"host": [
-			  "logicgoinfotechspaces-smart-budget-recommendation",
-			  "hf",
-			  "space"
-			],
-			"path": [
-			  "category-expenses",
-			  "{{user_id}}"
-			],
-			"query": [
-			  {
-				"key": "months",
-				"value": "3",
-				"description": "Number of months to analyze (default: 3)"
-			  }
-			]
-		  },
-		  "description": "Get average expenses by category for the past N months"
-		}
-	  },
-	  {
-		"name": "Sample Expenses - Create Multiple",
-		"item": [
-		  {
-			"name": "Groceries - Month 1 (Sept 2024)",
-			"request": {
-			  "method": "POST",
-			  "header": [
+		{
+			"name": "Health & Status",
+			"item": [
+				{
+					"name": "Root",
+					"request": {
+						"method": "GET",
+						"header": [],
+						"url": {
+							"raw": "{{base_url}}/",
+							"host": ["{{base_url}}"],
+							"path": [""]
+						},
+						"description": "Root endpoint"
+					}
+				},
 				{
-				  "key": "Content-Type",
-				  "value": "application/json"
+					"name": "Health Check",
+					"request": {
+						"method": "GET",
+						"header": [],
+						"url": {
+							"raw": "{{base_url}}/health",
+							"host": ["{{base_url}}"],
+							"path": ["health"]
+						},
+						"description": "Health check endpoint"
+					}
 				}
-			  ],
-			  "body": {
-				"mode": "raw",
-				"raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"amount\": 3500,\n  \"category\": \"Groceries\",\n  \"description\": \"Monthly groceries - September 2024\",\n  \"date\": \"2024-09-15T00:00:00\",\n  \"type\": \"expense\"\n}"
-			  },
-			  "url": {
-				"raw": "https://logicgoinfotechspaces-smart-budget-recommendation.hf.space/expenses",
-				"protocol": "https",
-				"host": [
-				  "logicgoinfotechspaces-smart-budget-recommendation",
-				  "hf",
-				  "space"
-				],
-				"path": [
-				  "expenses"
-				]
-			  }
-			}
-		  },
-		  {
-			"name": "Groceries - Month 2 (Oct 2024)",
-			"request": {
-			  "method": "POST",
-			  "header": [
+			]
+		},
+		{
+			"name": "Expenses",
+			"item": [
 				{
-				  "key": "Content-Type",
-				  "value": "application/json"
+					"name": "Create Expense",
+					"request": {
+						"method": "POST",
+						"header": [
+							{
+								"key": "Content-Type",
+								"value": "application/json"
+							}
+						],
+						"body": {
+							"mode": "raw",
+							"raw": "{\n  \"user_id\": \"68a834c3f4694b11efedacd2\",\n  \"amount\": 5000.0,\n  \"category\": \"Groceries\",\n  \"description\": \"Monthly groceries\",\n  \"date\": \"2025-12-25T10:00:00Z\",\n  \"type\": \"expense\"\n}"
+						},
+						"url": {
+							"raw": "{{base_url}}/expenses",
+							"host": ["{{base_url}}"],
+							"path": ["expenses"]
+						},
+						"description": "Create a new expense"
+					}
+				},
+				{
+					"name": "Get Expenses",
+					"request": {
+						"method": "GET",
+						"header": [],
+						"url": {
+							"raw": "{{base_url}}/expenses?user_id=68a834c3f4694b11efedacd2",
+							"host": ["{{base_url}}"],
+							"path": ["expenses"],
+							"query": [
+								{
+									"key": "user_id",
+									"value": "68a834c3f4694b11efedacd2"
+								}
+							]
+						},
+						"description": "Get expenses for a user"
+					}
 				}
-			  ],
-			  "body": {
-				"mode": "raw",
-				"raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"amount\": 3800,\n  \"category\": \"Groceries\",\n  \"description\": \"Monthly groceries - October 2024\",\n  \"date\": \"2024-10-15T00:00:00\",\n  \"type\": \"expense\"\n}"
-			  },
-			  "url": {
-				"raw": "https://logicgoinfotechspaces-smart-budget-recommendation.hf.space/expenses",
-				"protocol": "https",
-				"host": [
-				  "logicgoinfotechspaces-smart-budget-recommendation",
-				  "hf",
-				  "space"
-				],
-				"path": [
-				  "expenses"
-				]
-			  }
-			}
-		  },
-		  {
-			"name": "Groceries - Month 3 (Nov 2024)",
-			"request": {
-			  "method": "POST",
-			  "header": [
+			]
+		},
+		{
+			"name": "Budgets",
+			"item": [
+				{
+					"name": "Create Budget",
+					"request": {
+						"method": "POST",
+						"header": [
+							{
+								"key": "Content-Type",
+								"value": "application/json"
+							}
+						],
+						"body": {
+							"mode": "raw",
+							"raw": "{\n  \"user_id\": \"68a834c3f4694b11efedacd2\",\n  \"category\": \"688c80ca990b63f0e945ecf1\",\n  \"amount\": 10000.0,\n  \"period\": \"monthly\",\n  \"start_date\": \"2025-12-01T00:00:00Z\",\n  \"end_date\": \"2025-12-31T23:59:59Z\"\n}"
+						},
+						"url": {
+							"raw": "{{base_url}}/budgets",
+							"host": ["{{base_url}}"],
+							"path": ["budgets"]
+						},
+						"description": "Create a new budget"
+					}
+				},
 				{
-				  "key": "Content-Type",
-				  "value": "application/json"
+					"name": "Get Budgets",
+					"request": {
+						"method": "GET",
+						"header": [],
+						"url": {
+							"raw": "{{base_url}}/budgets?user_id=68a834c3f4694b11efedacd2",
+							"host": ["{{base_url}}"],
+							"path": ["budgets"],
+							"query": [
+								{
+									"key": "user_id",
+									"value": "68a834c3f4694b11efedacd2"
+								}
+							]
+						},
+						"description": "Get budgets for a user"
+					}
 				}
-			  ],
-			  "body": {
-				"mode": "raw",
-				"raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"amount\": 4000,\n  \"category\": \"Groceries\",\n  \"description\": \"Monthly groceries - November 2024\",\n  \"date\": \"2024-11-15T00:00:00\",\n  \"type\": \"expense\"\n}"
-			  },
-			  "url": {
-				"raw": "https://logicgoinfotechspaces-smart-budget-recommendation.hf.space/expenses",
-				"protocol": "https",
-				"host": [
-				  "logicgoinfotechspaces-smart-budget-recommendation",
-				  "hf",
-				  "space"
-				],
-				"path": [
-				  "expenses"
-				]
-			  }
-			}
-		  },
-		  {
-			"name": "Transport - Month 1 (Sept 2024)",
-			"request": {
-			  "method": "POST",
-			  "header": [
+			]
+		},
+		{
+			"name": "Recommendations",
+			"item": [
 				{
-				  "key": "Content-Type",
-				  "value": "application/json"
+					"name": "Get Budget Recommendations",
+					"request": {
+						"method": "GET",
+						"header": [],
+						"url": {
+							"raw": "{{base_url}}/recommendations/68a834c3f4694b11efedacd2?month=1&year=2026",
+							"host": ["{{base_url}}"],
+							"path": ["recommendations", "68a834c3f4694b11efedacd2"],
+							"query": [
+								{
+									"key": "month",
+									"value": "1",
+									"description": "Target month (1-12), optional"
+								},
+								{
+									"key": "year",
+									"value": "2026",
+									"description": "Target year, optional"
+								}
+							]
+						},
+						"description": "Get smart budget recommendations for a user based on past spending behavior"
+					}
+				},
+				{
+					"name": "Check and Get Recommendations",
+					"request": {
+						"method": "POST",
+						"header": [
+							{
+								"key": "Content-Type",
+								"value": "application/json"
+							}
+						],
+						"body": {
+							"mode": "raw",
+							"raw": "{\n  \"user_id\": \"68a834c3f4694b11efedacd2\",\n  \"category_id\": \"688c80ca990b63f0e945ecf1\"\n}"
+						},
+						"url": {
+							"raw": "{{base_url}}/recommendations/check?month=1&year=2026",
+							"host": ["{{base_url}}"],
+							"path": ["recommendations", "check"],
+							"query": [
+								{
+									"key": "month",
+									"value": "1",
+									"description": "Target month (1-12), optional"
+								},
+								{
+									"key": "year",
+									"value": "2026",
+									"description": "Target year, optional"
+								}
+							]
+						},
+						"description": "Check if user has previous data for a category and return recommendations if available"
+					}
 				}
-			  ],
-			  "body": {
-				"mode": "raw",
-				"raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"amount\": 2000,\n  \"category\": \"Transport\",\n  \"description\": \"Monthly transport - September 2024\",\n  \"date\": \"2024-09-20T00:00:00\",\n  \"type\": \"expense\"\n}"
-			  },
-			  "url": {
-				"raw": "https://logicgoinfotechspaces-smart-budget-recommendation.hf.space/expenses",
-				"protocol": "https",
-				"host": [
-				  "logicgoinfotechspaces-smart-budget-recommendation",
-				  "hf",
-				  "space"
-				],
-				"path": [
-				  "expenses"
-				]
-			  }
-			}
-		  },
-		  {
-			"name": "Transport - Month 2 (Oct 2024)",
-			"request": {
-			  "method": "POST",
-			  "header": [
+			]
+		},
+		{
+			"name": "Category Expenses",
+			"item": [
 				{
-				  "key": "Content-Type",
-				  "value": "application/json"
+					"name": "Get Category Expenses",
+					"request": {
+						"method": "GET",
+						"header": [],
+						"url": {
+							"raw": "{{base_url}}/category-expenses/68a834c3f4694b11efedacd2?months=3",
+							"host": ["{{base_url}}"],
+							"path": ["category-expenses", "68a834c3f4694b11efedacd2"],
+							"query": [
+								{
+									"key": "months",
+									"value": "3",
+									"description": "Number of months to analyze (default: 3)"
+								}
+							]
+						},
+						"description": "Get average expenses by category for the past N months"
+					}
 				}
-			  ],
-			  "body": {
-				"mode": "raw",
-				"raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"amount\": 2200,\n  \"category\": \"Transport\",\n  \"description\": \"Monthly transport - October 2024\",\n  \"date\": \"2024-10-20T00:00:00\",\n  \"type\": \"expense\"\n}"
-			  },
-			  "url": {
-				"raw": "https://logicgoinfotechspaces-smart-budget-recommendation.hf.space/expenses",
-				"protocol": "https",
-				"host": [
-				  "logicgoinfotechspaces-smart-budget-recommendation",
-				  "hf",
-				  "space"
-				],
-				"path": [
-				  "expenses"
-				]
-			  }
-			}
-		  }
-		]
-	  }
+			]
+		}
 	],
 	"variable": [
-	  {
-		"key": "base_url",
-		"value": "https://logicgoinfotechspaces-smart-budget-recommendation.hf.space",
-		"type": "string"
-	  },
-	  {
-		"key": "user_id",
-		"value": "68a834c3f4694b11efedacd2",
-		"type": "string"
-	  },
-	  {
-		"key": "hf_token",
-		"value": "",
-		"type": "string"
-	  }
-	]
-  }
+		{
+			"key": "base_url",
+			"value": "https://logicgoinfotechspaces-smart-budget-recommendation.hf.space",
+			"type": "string",
+			"description": "Hugging Face Space URL (lowercase, hyphens). Check your Space page for the exact URL. For local development, use: http://localhost:7860"
+		},
+		{
+			"key": "hf_token",
+			"value": "",
+			"type": "string",
+			"description": "Hugging Face Access Token (optional, only if space is private). Get from: https://huggingface.co/settings/tokens"
+		}
+	],
+	"auth": {
+		"type": "bearer",
+		"bearer": [
+			{
+				"key": "token",
+				"value": "{{hf_token}}",
+				"type": "string"
+			}
+		]
+	}
+}

app/main.py

@@ -183,36 +183,6 @@ async def get_budgets(user_id: str):
         del budget["_id"]
     return budgets
 
-@app.get("/recommendations/{user_id}", response_model=List[BudgetRecommendation])
-async def get_budget_recommendations(user_id: str, month: Optional[int] = None, year: Optional[int] = None):
-    """
-    Get smart budget recommendations for a user based on past spending behavior.
-    
-    Example response:
-    {
-        "budget_name": "Groceries",
-        "average_expense": 3800,
-        "recommended_budget": 4000,
-        "reason": "Your average monthly grocery expense is Rs.3,800. We suggest setting your budget to Rs.4,000 for next month.",
-        "confidence": 0.85,
-        "action": "increase"
-    }
-    """
-    if not month or not year:
-        # Default to next month
-        next_month = datetime.now().replace(day=1) + timedelta(days=32)
-        month = next_month.month
-        year = next_month.year
-    
-    recommendations = recommender.get_recommendations(user_id, month, year)
-    return recommendations
-
-@app.get("/category-expenses/{user_id}", response_model=List[CategoryExpense])
-async def get_category_expenses(user_id: str, months: int = 3):
-    """Get average expenses by category for the past N months"""
-    category_expenses = recommender.get_category_averages(user_id, months)
-    return category_expenses
-
 @app.post("/recommendations/check", response_model=RecommendationResponse)
 async def check_and_get_recommendations(request: RecommendationRequest, month: Optional[int] = None, year: Optional[int] = None):
     """
@@ -267,6 +237,37 @@ async def check_and_get_recommendations(request: RecommendationRequest, month: O
             message=f"User does not have previous data for category_id: {request.category_id}. Please create a budget or add expenses for this category first."
         )
 
+@app.get("/recommendations/{user_id}", response_model=List[BudgetRecommendation])
+async def get_budget_recommendations(user_id: str, month: Optional[int] = None, year: Optional[int] = None):
+    """
+    Get smart budget recommendations for a user based on past spending behavior.
+    
+    Example response:
+    {
+        "category": "Groceries",
+        "category_id": "688c80ca990b63f0e945ecf1",
+        "average_expense": 3800,
+        "recommended_budget": 4000,
+        "reason": "Your average monthly grocery expense is Rs.3,800. We suggest setting your budget to Rs.4,000 for next month.",
+        "confidence": 0.85,
+        "action": "increase"
+    }
+    """
+    if not month or not year:
+        # Default to next month
+        next_month = datetime.now().replace(day=1) + timedelta(days=32)
+        month = next_month.month
+        year = next_month.year
+    
+    recommendations = recommender.get_recommendations(user_id, month, year)
+    return recommendations
+
+@app.get("/category-expenses/{user_id}", response_model=List[CategoryExpense])
+async def get_category_expenses(user_id: str, months: int = 3):
+    """Get average expenses by category for the past N months"""
+    category_expenses = recommender.get_category_averages(user_id, months)
+    return category_expenses
+
 if __name__ == "__main__":
     import uvicorn
     uvicorn.run(app, host="0.0.0.0", port=8000)