@cloudgrid-io/mcp 0.12.0 → 0.14.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/src/corpus/capability-map.md +82 -2
- package/src/corpus/examples/crm/index.md +273 -0
- package/src/corpus/examples/kanban/index.md +256 -0
- package/src/corpus/templates/_cloudgrid.yaml.reference +228 -0
- package/src/corpus/templates/admin-dashboard/README.md +75 -0
- package/src/corpus/templates/admin-dashboard/cloudgrid.yaml +233 -0
- package/src/corpus/templates/admin-dashboard/index.md +81 -0
- package/src/corpus/templates/admin-dashboard/services/web/app/api/orders/route.js +64 -0
- package/src/corpus/templates/admin-dashboard/services/web/app/api/users/route.js +63 -0
- package/src/corpus/templates/admin-dashboard/services/web/app/layout.js +39 -0
- package/src/corpus/templates/admin-dashboard/services/web/app/page.js +73 -0
- package/src/corpus/templates/admin-dashboard/services/web/app/resource-table.js +94 -0
- package/src/corpus/templates/admin-dashboard/services/web/lib/db.js +32 -0
- package/src/corpus/templates/admin-dashboard/services/web/package.json +16 -0
- package/src/corpus/templates/ai-app/cloudgrid.yaml +225 -11
- package/src/corpus/templates/ai-app/index.md +3 -11
- package/src/corpus/templates/ai-knowledge-base/AGENTS.md +254 -0
- package/src/corpus/templates/ai-knowledge-base/README.md +28 -0
- package/src/corpus/templates/ai-knowledge-base/cloudgrid.yaml +238 -0
- package/src/corpus/templates/ai-knowledge-base/index.md +81 -0
- package/src/corpus/templates/analytics-dashboard/README.md +85 -0
- package/src/corpus/templates/analytics-dashboard/cloudgrid.yaml +232 -0
- package/src/corpus/templates/analytics-dashboard/index.md +316 -0
- package/src/corpus/templates/analytics-dashboard/services/web/app/api/events/route.js +60 -0
- package/src/corpus/templates/analytics-dashboard/services/web/app/event-form.js +100 -0
- package/src/corpus/templates/analytics-dashboard/services/web/app/layout.js +41 -0
- package/src/corpus/templates/analytics-dashboard/services/web/app/page.js +54 -0
- package/src/corpus/templates/analytics-dashboard/services/web/lib/db.js +32 -0
- package/src/corpus/templates/analytics-dashboard/services/web/package.json +16 -0
- package/src/corpus/templates/api-dashboard/README.md +84 -0
- package/src/corpus/templates/api-dashboard/cloudgrid.yaml +233 -0
- package/src/corpus/templates/api-dashboard/index.md +310 -0
- package/src/corpus/templates/api-dashboard/services/web/app/api/requests/route.js +62 -0
- package/src/corpus/templates/api-dashboard/services/web/app/dashboard.js +156 -0
- package/src/corpus/templates/api-dashboard/services/web/app/layout.js +42 -0
- package/src/corpus/templates/api-dashboard/services/web/app/page.js +39 -0
- package/src/corpus/templates/api-dashboard/services/web/lib/db.js +32 -0
- package/src/corpus/templates/api-dashboard/services/web/package.json +16 -0
- package/src/corpus/templates/api-docs/README.md +28 -0
- package/src/corpus/templates/api-docs/cloudgrid.yaml +228 -0
- package/src/corpus/templates/api-docs/index.html +136 -0
- package/src/corpus/templates/api-docs/index.md +28 -0
- package/src/corpus/templates/api-service/cloudgrid.yaml +224 -9
- package/src/corpus/templates/api-service/index.md +3 -11
- package/src/corpus/templates/app-with-data/cloudgrid.yaml +226 -8
- package/src/corpus/templates/app-with-data/index.md +3 -8
- package/src/corpus/templates/appointment-booking/AGENTS.md +223 -0
- package/src/corpus/templates/appointment-booking/README.md +16 -0
- package/src/corpus/templates/appointment-booking/cloudgrid.yaml +250 -0
- package/src/corpus/templates/appointment-booking/index.md +72 -0
- package/src/corpus/templates/approval-workflow/AGENTS.md +170 -0
- package/src/corpus/templates/approval-workflow/README.md +12 -0
- package/src/corpus/templates/approval-workflow/cloudgrid.yaml +237 -0
- package/src/corpus/templates/approval-workflow/index.md +58 -0
- package/src/corpus/templates/billing-dashboard/AGENTS.md +199 -0
- package/src/corpus/templates/billing-dashboard/README.md +18 -0
- package/src/corpus/templates/billing-dashboard/cloudgrid.yaml +235 -0
- package/src/corpus/templates/billing-dashboard/index.md +87 -0
- package/src/corpus/templates/blog-cms/README.md +94 -0
- package/src/corpus/templates/blog-cms/cloudgrid.yaml +233 -0
- package/src/corpus/templates/blog-cms/index.md +358 -0
- package/src/corpus/templates/blog-cms/services/web/app/admin/admin-editor.js +133 -0
- package/src/corpus/templates/blog-cms/services/web/app/admin/page.js +33 -0
- package/src/corpus/templates/blog-cms/services/web/app/api/posts/route.js +84 -0
- package/src/corpus/templates/blog-cms/services/web/app/layout.js +47 -0
- package/src/corpus/templates/blog-cms/services/web/app/page.js +56 -0
- package/src/corpus/templates/blog-cms/services/web/app/posts/[slug]/page.js +45 -0
- package/src/corpus/templates/blog-cms/services/web/lib/db.js +32 -0
- package/src/corpus/templates/blog-cms/services/web/package.json +16 -0
- package/src/corpus/templates/booking-system/AGENTS.md +189 -0
- package/src/corpus/templates/booking-system/README.md +17 -0
- package/src/corpus/templates/booking-system/cloudgrid.yaml +248 -0
- package/src/corpus/templates/booking-system/index.md +86 -0
- package/src/corpus/templates/calendar-scheduler/AGENTS.md +226 -0
- package/src/corpus/templates/calendar-scheduler/README.md +25 -0
- package/src/corpus/templates/calendar-scheduler/cloudgrid.yaml +259 -0
- package/src/corpus/templates/calendar-scheduler/index.md +85 -0
- package/src/corpus/templates/changelog/README.md +27 -0
- package/src/corpus/templates/changelog/cloudgrid.yaml +228 -0
- package/src/corpus/templates/changelog/index.html +80 -0
- package/src/corpus/templates/changelog/index.md +28 -0
- package/src/corpus/templates/company-website/README.md +54 -0
- package/src/corpus/templates/company-website/cloudgrid.yaml +233 -0
- package/src/corpus/templates/company-website/index.html +309 -0
- package/src/corpus/templates/company-website/index.md +29 -0
- package/src/corpus/templates/course-platform/AGENTS.md +161 -0
- package/src/corpus/templates/course-platform/README.md +26 -0
- package/src/corpus/templates/course-platform/cloudgrid.yaml +237 -0
- package/src/corpus/templates/course-platform/index.md +70 -0
- package/src/corpus/templates/crm/README.md +72 -0
- package/src/corpus/templates/crm/cloudgrid.yaml +233 -0
- package/src/corpus/templates/crm/index.md +71 -0
- package/src/corpus/templates/crm/services/web/app/api/contacts/route.js +80 -0
- package/src/corpus/templates/crm/services/web/app/contact-manager.js +102 -0
- package/src/corpus/templates/crm/services/web/app/layout.js +35 -0
- package/src/corpus/templates/crm/services/web/app/page.js +34 -0
- package/src/corpus/templates/crm/services/web/lib/db.js +32 -0
- package/src/corpus/templates/crm/services/web/package.json +16 -0
- package/src/corpus/templates/dashboard/cloudgrid.yaml +228 -4
- package/src/corpus/templates/dashboard/index.md +3 -5
- package/src/corpus/templates/deck/cloudgrid.yaml +228 -4
- package/src/corpus/templates/deck/index.md +3 -5
- package/src/corpus/templates/directory/README.md +75 -0
- package/src/corpus/templates/directory/cloudgrid.yaml +233 -0
- package/src/corpus/templates/directory/index.md +334 -0
- package/src/corpus/templates/directory/services/web/app/api/entries/route.js +63 -0
- package/src/corpus/templates/directory/services/web/app/directory-list.js +146 -0
- package/src/corpus/templates/directory/services/web/app/layout.js +44 -0
- package/src/corpus/templates/directory/services/web/app/page.js +38 -0
- package/src/corpus/templates/directory/services/web/lib/db.js +32 -0
- package/src/corpus/templates/directory/services/web/package.json +16 -0
- package/src/corpus/templates/docs-site/README.md +28 -0
- package/src/corpus/templates/docs-site/cloudgrid.yaml +228 -0
- package/src/corpus/templates/docs-site/index.html +122 -0
- package/src/corpus/templates/docs-site/index.md +28 -0
- package/src/corpus/templates/erp/AGENTS.md +116 -0
- package/src/corpus/templates/erp/README.md +17 -0
- package/src/corpus/templates/erp/cloudgrid.yaml +235 -0
- package/src/corpus/templates/erp/index.md +81 -0
- package/src/corpus/templates/event-board/README.md +74 -0
- package/src/corpus/templates/event-board/cloudgrid.yaml +233 -0
- package/src/corpus/templates/event-board/index.md +299 -0
- package/src/corpus/templates/event-board/services/web/app/api/events/route.js +61 -0
- package/src/corpus/templates/event-board/services/web/app/event-form.js +118 -0
- package/src/corpus/templates/event-board/services/web/app/layout.js +39 -0
- package/src/corpus/templates/event-board/services/web/app/page.js +34 -0
- package/src/corpus/templates/event-board/services/web/lib/db.js +32 -0
- package/src/corpus/templates/event-board/services/web/package.json +16 -0
- package/src/corpus/templates/expense-tracker/README.md +76 -0
- package/src/corpus/templates/expense-tracker/cloudgrid.yaml +233 -0
- package/src/corpus/templates/expense-tracker/index.md +305 -0
- package/src/corpus/templates/expense-tracker/services/web/app/api/expenses/route.js +61 -0
- package/src/corpus/templates/expense-tracker/services/web/app/expense-form.js +145 -0
- package/src/corpus/templates/expense-tracker/services/web/app/layout.js +42 -0
- package/src/corpus/templates/expense-tracker/services/web/app/page.js +34 -0
- package/src/corpus/templates/expense-tracker/services/web/lib/db.js +32 -0
- package/src/corpus/templates/expense-tracker/services/web/package.json +16 -0
- package/src/corpus/templates/feature-request-board/README.md +87 -0
- package/src/corpus/templates/feature-request-board/cloudgrid.yaml +233 -0
- package/src/corpus/templates/feature-request-board/index.md +317 -0
- package/src/corpus/templates/feature-request-board/services/web/app/api/requests/route.js +92 -0
- package/src/corpus/templates/feature-request-board/services/web/app/board.js +91 -0
- package/src/corpus/templates/feature-request-board/services/web/app/layout.js +43 -0
- package/src/corpus/templates/feature-request-board/services/web/app/page.js +35 -0
- package/src/corpus/templates/feature-request-board/services/web/lib/db.js +32 -0
- package/src/corpus/templates/feature-request-board/services/web/package.json +16 -0
- package/src/corpus/templates/financial-dashboard/README.md +80 -0
- package/src/corpus/templates/financial-dashboard/cloudgrid.yaml +233 -0
- package/src/corpus/templates/financial-dashboard/index.md +326 -0
- package/src/corpus/templates/financial-dashboard/services/web/app/api/entries/route.js +63 -0
- package/src/corpus/templates/financial-dashboard/services/web/app/entry-board.js +130 -0
- package/src/corpus/templates/financial-dashboard/services/web/app/layout.js +46 -0
- package/src/corpus/templates/financial-dashboard/services/web/app/page.js +31 -0
- package/src/corpus/templates/financial-dashboard/services/web/lib/db.js +32 -0
- package/src/corpus/templates/financial-dashboard/services/web/package.json +16 -0
- package/src/corpus/templates/forum/AGENTS.md +196 -0
- package/src/corpus/templates/forum/README.md +12 -0
- package/src/corpus/templates/forum/cloudgrid.yaml +237 -0
- package/src/corpus/templates/forum/index.md +66 -0
- package/src/corpus/templates/hr-portal/AGENTS.md +174 -0
- package/src/corpus/templates/hr-portal/README.md +14 -0
- package/src/corpus/templates/hr-portal/cloudgrid.yaml +237 -0
- package/src/corpus/templates/hr-portal/index.md +56 -0
- package/src/corpus/templates/internal-tools-portal/AGENTS.md +201 -0
- package/src/corpus/templates/internal-tools-portal/README.md +17 -0
- package/src/corpus/templates/internal-tools-portal/cloudgrid.yaml +237 -0
- package/src/corpus/templates/internal-tools-portal/index.md +62 -0
- package/src/corpus/templates/inventory/README.md +71 -0
- package/src/corpus/templates/inventory/cloudgrid.yaml +233 -0
- package/src/corpus/templates/inventory/index.md +68 -0
- package/src/corpus/templates/inventory/services/web/app/api/items/route.js +88 -0
- package/src/corpus/templates/inventory/services/web/app/inventory-manager.js +101 -0
- package/src/corpus/templates/inventory/services/web/app/layout.js +36 -0
- package/src/corpus/templates/inventory/services/web/app/page.js +37 -0
- package/src/corpus/templates/inventory/services/web/lib/db.js +32 -0
- package/src/corpus/templates/inventory/services/web/package.json +16 -0
- package/src/corpus/templates/invoice/README.md +71 -0
- package/src/corpus/templates/invoice/cloudgrid.yaml +233 -0
- package/src/corpus/templates/invoice/index.md +68 -0
- package/src/corpus/templates/invoice/services/web/app/api/invoices/route.js +82 -0
- package/src/corpus/templates/invoice/services/web/app/invoice-manager.js +101 -0
- package/src/corpus/templates/invoice/services/web/app/layout.js +35 -0
- package/src/corpus/templates/invoice/services/web/app/page.js +34 -0
- package/src/corpus/templates/invoice/services/web/lib/db.js +32 -0
- package/src/corpus/templates/invoice/services/web/package.json +16 -0
- package/src/corpus/templates/job-board/README.md +71 -0
- package/src/corpus/templates/job-board/cloudgrid.yaml +233 -0
- package/src/corpus/templates/job-board/index.md +68 -0
- package/src/corpus/templates/job-board/services/web/app/api/jobs/route.js +66 -0
- package/src/corpus/templates/job-board/services/web/app/job-board.js +73 -0
- package/src/corpus/templates/job-board/services/web/app/layout.js +35 -0
- package/src/corpus/templates/job-board/services/web/app/page.js +32 -0
- package/src/corpus/templates/job-board/services/web/lib/db.js +32 -0
- package/src/corpus/templates/job-board/services/web/package.json +16 -0
- package/src/corpus/templates/kanban/README.md +72 -0
- package/src/corpus/templates/kanban/cloudgrid.yaml +233 -0
- package/src/corpus/templates/kanban/index.md +71 -0
- package/src/corpus/templates/kanban/services/web/app/api/cards/route.js +70 -0
- package/src/corpus/templates/kanban/services/web/app/board.js +93 -0
- package/src/corpus/templates/kanban/services/web/app/layout.js +37 -0
- package/src/corpus/templates/kanban/services/web/app/page.js +32 -0
- package/src/corpus/templates/kanban/services/web/lib/db.js +32 -0
- package/src/corpus/templates/kanban/services/web/package.json +16 -0
- package/src/corpus/templates/landing-page/cloudgrid.yaml +228 -4
- package/src/corpus/templates/landing-page/index.md +3 -5
- package/src/corpus/templates/lms/AGENTS.md +193 -0
- package/src/corpus/templates/lms/README.md +27 -0
- package/src/corpus/templates/lms/cloudgrid.yaml +237 -0
- package/src/corpus/templates/lms/index.md +79 -0
- package/src/corpus/templates/marketplace/AGENTS.md +208 -0
- package/src/corpus/templates/marketplace/README.md +22 -0
- package/src/corpus/templates/marketplace/cloudgrid.yaml +233 -0
- package/src/corpus/templates/marketplace/index.md +76 -0
- package/src/corpus/templates/membership-site/AGENTS.md +160 -0
- package/src/corpus/templates/membership-site/README.md +18 -0
- package/src/corpus/templates/membership-site/cloudgrid.yaml +236 -0
- package/src/corpus/templates/membership-site/index.md +66 -0
- package/src/corpus/templates/monitoring-dashboard/README.md +84 -0
- package/src/corpus/templates/monitoring-dashboard/cloudgrid.yaml +233 -0
- package/src/corpus/templates/monitoring-dashboard/index.md +328 -0
- package/src/corpus/templates/monitoring-dashboard/services/web/app/api/checks/route.js +76 -0
- package/src/corpus/templates/monitoring-dashboard/services/web/app/check-form.js +124 -0
- package/src/corpus/templates/monitoring-dashboard/services/web/app/layout.js +44 -0
- package/src/corpus/templates/monitoring-dashboard/services/web/app/page.js +49 -0
- package/src/corpus/templates/monitoring-dashboard/services/web/lib/db.js +32 -0
- package/src/corpus/templates/monitoring-dashboard/services/web/package.json +16 -0
- package/src/corpus/templates/online-store/AGENTS.md +153 -0
- package/src/corpus/templates/online-store/README.md +16 -0
- package/src/corpus/templates/online-store/cloudgrid.yaml +234 -0
- package/src/corpus/templates/online-store/index.md +81 -0
- package/src/corpus/templates/portfolio/README.md +29 -0
- package/src/corpus/templates/portfolio/cloudgrid.yaml +228 -0
- package/src/corpus/templates/portfolio/index.html +126 -0
- package/src/corpus/templates/portfolio/index.md +28 -0
- package/src/corpus/templates/product-catalog/README.md +74 -0
- package/src/corpus/templates/product-catalog/cloudgrid.yaml +232 -0
- package/src/corpus/templates/product-catalog/index.md +330 -0
- package/src/corpus/templates/product-catalog/services/web/app/api/products/route.js +69 -0
- package/src/corpus/templates/product-catalog/services/web/app/catalog.js +153 -0
- package/src/corpus/templates/product-catalog/services/web/app/layout.js +49 -0
- package/src/corpus/templates/product-catalog/services/web/app/page.js +36 -0
- package/src/corpus/templates/product-catalog/services/web/lib/db.js +32 -0
- package/src/corpus/templates/product-catalog/services/web/package.json +16 -0
- package/src/corpus/templates/product-launch/README.md +46 -0
- package/src/corpus/templates/product-launch/cloudgrid.yaml +234 -0
- package/src/corpus/templates/product-launch/index.html +320 -0
- package/src/corpus/templates/product-launch/index.md +34 -0
- package/src/corpus/templates/project-management/README.md +83 -0
- package/src/corpus/templates/project-management/cloudgrid.yaml +233 -0
- package/src/corpus/templates/project-management/index.md +346 -0
- package/src/corpus/templates/project-management/services/web/app/api/projects/route.js +48 -0
- package/src/corpus/templates/project-management/services/web/app/api/tasks/route.js +85 -0
- package/src/corpus/templates/project-management/services/web/app/board.js +182 -0
- package/src/corpus/templates/project-management/services/web/app/layout.js +45 -0
- package/src/corpus/templates/project-management/services/web/app/page.js +49 -0
- package/src/corpus/templates/project-management/services/web/lib/db.js +32 -0
- package/src/corpus/templates/project-management/services/web/package.json +16 -0
- package/src/corpus/templates/property-listings/README.md +76 -0
- package/src/corpus/templates/property-listings/cloudgrid.yaml +233 -0
- package/src/corpus/templates/property-listings/index.md +335 -0
- package/src/corpus/templates/property-listings/services/web/app/api/properties/route.js +73 -0
- package/src/corpus/templates/property-listings/services/web/app/layout.js +45 -0
- package/src/corpus/templates/property-listings/services/web/app/listings.js +152 -0
- package/src/corpus/templates/property-listings/services/web/app/page.js +53 -0
- package/src/corpus/templates/property-listings/services/web/lib/db.js +32 -0
- package/src/corpus/templates/property-listings/services/web/package.json +16 -0
- package/src/corpus/templates/quiz-platform/README.md +84 -0
- package/src/corpus/templates/quiz-platform/cloudgrid.yaml +233 -0
- package/src/corpus/templates/quiz-platform/index.md +313 -0
- package/src/corpus/templates/quiz-platform/services/web/app/api/questions/route.js +69 -0
- package/src/corpus/templates/quiz-platform/services/web/app/layout.js +47 -0
- package/src/corpus/templates/quiz-platform/services/web/app/page.js +37 -0
- package/src/corpus/templates/quiz-platform/services/web/app/quiz.js +188 -0
- package/src/corpus/templates/quiz-platform/services/web/lib/db.js +32 -0
- package/src/corpus/templates/quiz-platform/services/web/package.json +16 -0
- package/src/corpus/templates/report/cloudgrid.yaml +228 -4
- package/src/corpus/templates/report/index.md +3 -5
- package/src/corpus/templates/restaurant-reservations/AGENTS.md +258 -0
- package/src/corpus/templates/restaurant-reservations/README.md +17 -0
- package/src/corpus/templates/restaurant-reservations/cloudgrid.yaml +258 -0
- package/src/corpus/templates/restaurant-reservations/index.md +62 -0
- package/src/corpus/templates/revenue-dashboard/README.md +75 -0
- package/src/corpus/templates/revenue-dashboard/cloudgrid.yaml +233 -0
- package/src/corpus/templates/revenue-dashboard/index.md +307 -0
- package/src/corpus/templates/revenue-dashboard/services/web/app/api/sales/route.js +60 -0
- package/src/corpus/templates/revenue-dashboard/services/web/app/layout.js +40 -0
- package/src/corpus/templates/revenue-dashboard/services/web/app/page.js +87 -0
- package/src/corpus/templates/revenue-dashboard/services/web/app/sale-form.js +63 -0
- package/src/corpus/templates/revenue-dashboard/services/web/lib/db.js +32 -0
- package/src/corpus/templates/revenue-dashboard/services/web/package.json +16 -0
- package/src/corpus/templates/saas-marketing/README.md +30 -0
- package/src/corpus/templates/saas-marketing/cloudgrid.yaml +228 -0
- package/src/corpus/templates/saas-marketing/index.html +212 -0
- package/src/corpus/templates/saas-marketing/index.md +28 -0
- package/src/corpus/templates/status-page/README.md +28 -0
- package/src/corpus/templates/status-page/cloudgrid.yaml +228 -0
- package/src/corpus/templates/status-page/index.html +117 -0
- package/src/corpus/templates/status-page/index.md +28 -0
- package/src/corpus/templates/subscription-management/AGENTS.md +191 -0
- package/src/corpus/templates/subscription-management/README.md +21 -0
- package/src/corpus/templates/subscription-management/cloudgrid.yaml +236 -0
- package/src/corpus/templates/subscription-management/index.md +73 -0
- package/src/corpus/templates/task-manager/README.md +72 -0
- package/src/corpus/templates/task-manager/cloudgrid.yaml +233 -0
- package/src/corpus/templates/task-manager/index.md +71 -0
- package/src/corpus/templates/task-manager/services/web/app/api/tasks/route.js +77 -0
- package/src/corpus/templates/task-manager/services/web/app/layout.js +39 -0
- package/src/corpus/templates/task-manager/services/web/app/page.js +33 -0
- package/src/corpus/templates/task-manager/services/web/app/task-list.js +110 -0
- package/src/corpus/templates/task-manager/services/web/lib/db.js +32 -0
- package/src/corpus/templates/task-manager/services/web/package.json +16 -0
- package/src/corpus/templates/ticket-system/README.md +71 -0
- package/src/corpus/templates/ticket-system/cloudgrid.yaml +233 -0
- package/src/corpus/templates/ticket-system/index.md +68 -0
- package/src/corpus/templates/ticket-system/services/web/app/api/tickets/route.js +81 -0
- package/src/corpus/templates/ticket-system/services/web/app/layout.js +36 -0
- package/src/corpus/templates/ticket-system/services/web/app/page.js +35 -0
- package/src/corpus/templates/ticket-system/services/web/app/ticket-queue.js +112 -0
- package/src/corpus/templates/ticket-system/services/web/lib/db.js +32 -0
- package/src/corpus/templates/ticket-system/services/web/package.json +16 -0
- package/src/corpus/templates/time-tracking/README.md +81 -0
- package/src/corpus/templates/time-tracking/cloudgrid.yaml +233 -0
- package/src/corpus/templates/time-tracking/index.md +298 -0
- package/src/corpus/templates/time-tracking/services/web/app/api/entries/route.js +66 -0
- package/src/corpus/templates/time-tracking/services/web/app/entry-form.js +106 -0
- package/src/corpus/templates/time-tracking/services/web/app/layout.js +39 -0
- package/src/corpus/templates/time-tracking/services/web/app/page.js +30 -0
- package/src/corpus/templates/time-tracking/services/web/lib/db.js +32 -0
- package/src/corpus/templates/time-tracking/services/web/package.json +16 -0
- package/src/corpus/templates/travel-booking/AGENTS.md +207 -0
- package/src/corpus/templates/travel-booking/README.md +17 -0
- package/src/corpus/templates/travel-booking/cloudgrid.yaml +249 -0
- package/src/corpus/templates/travel-booking/index.md +88 -0
- package/src/corpus/templates/waitlist/README.md +38 -0
- package/src/corpus/templates/waitlist/cloudgrid.yaml +228 -0
- package/src/corpus/templates/waitlist/index.html +69 -0
- package/src/corpus/templates/waitlist/index.md +39 -0
- package/src/corpus/templates/web-app/cloudgrid.yaml +228 -4
- package/src/corpus/templates/web-app/index.md +3 -5
- package/src/corpus/workflows/admin-dashboard.md +102 -0
- package/src/corpus/workflows/ai-knowledge-base.md +137 -0
- package/src/corpus/workflows/analytics-dashboard.md +104 -0
- package/src/corpus/workflows/api-dashboard.md +102 -0
- package/src/corpus/workflows/api-docs.md +36 -0
- package/src/corpus/workflows/appointment-booking.md +143 -0
- package/src/corpus/workflows/approval-workflow.md +124 -0
- package/src/corpus/workflows/billing-dashboard.md +120 -0
- package/src/corpus/workflows/blog-cms.md +104 -0
- package/src/corpus/workflows/booking-system.md +116 -0
- package/src/corpus/workflows/calendar-scheduler.md +134 -0
- package/src/corpus/workflows/changelog.md +33 -0
- package/src/corpus/workflows/company-website.md +46 -0
- package/src/corpus/workflows/course-platform.md +126 -0
- package/src/corpus/workflows/crm.md +101 -0
- package/src/corpus/workflows/directory.md +101 -0
- package/src/corpus/workflows/docs-site.md +35 -0
- package/src/corpus/workflows/erp.md +125 -0
- package/src/corpus/workflows/event-board.md +102 -0
- package/src/corpus/workflows/expense-tracker.md +102 -0
- package/src/corpus/workflows/feature-request-board.md +105 -0
- package/src/corpus/workflows/financial-dashboard.md +103 -0
- package/src/corpus/workflows/forum.md +128 -0
- package/src/corpus/workflows/hr-portal.md +115 -0
- package/src/corpus/workflows/internal-tools-portal.md +125 -0
- package/src/corpus/workflows/inventory.md +101 -0
- package/src/corpus/workflows/invoice.md +101 -0
- package/src/corpus/workflows/job-board.md +101 -0
- package/src/corpus/workflows/kanban.md +102 -0
- package/src/corpus/workflows/lms.md +113 -0
- package/src/corpus/workflows/marketplace.md +123 -0
- package/src/corpus/workflows/membership-site.md +128 -0
- package/src/corpus/workflows/monitoring-dashboard.md +104 -0
- package/src/corpus/workflows/online-store.md +114 -0
- package/src/corpus/workflows/portfolio.md +35 -0
- package/src/corpus/workflows/product-catalog.md +105 -0
- package/src/corpus/workflows/product-launch.md +43 -0
- package/src/corpus/workflows/project-management.md +106 -0
- package/src/corpus/workflows/property-listings.md +101 -0
- package/src/corpus/workflows/quiz-platform.md +105 -0
- package/src/corpus/workflows/restaurant-reservations.md +123 -0
- package/src/corpus/workflows/revenue-dashboard.md +102 -0
- package/src/corpus/workflows/saas-marketing.md +37 -0
- package/src/corpus/workflows/status-page.md +35 -0
- package/src/corpus/workflows/subscription-management.md +141 -0
- package/src/corpus/workflows/task-manager.md +101 -0
- package/src/corpus/workflows/ticket-system.md +101 -0
- package/src/corpus/workflows/time-tracking.md +104 -0
- package/src/corpus/workflows/travel-booking.md +115 -0
- package/src/corpus/workflows/waitlist.md +42 -0
|
@@ -0,0 +1,326 @@
|
|
|
1
|
+
# Template: financial-dashboard (persistent Next.js + Mongo P&L board)
|
|
2
|
+
|
|
3
|
+
A minimal but real, deployable financial dashboard: income/expense entries by
|
|
4
|
+
account, with live income / expense / net totals and a table (add + delete).
|
|
5
|
+
Data lives in the grid-shared MongoDB, so it survives refresh and is shared
|
|
6
|
+
across sessions — unlike a static page.
|
|
7
|
+
|
|
8
|
+
**Domain:** an entry is `{ account: string, amount: number, type: "income" |
|
|
9
|
+
"expense", at: Date }`. Totals = income, expense, net (income − expense),
|
|
10
|
+
derived from the entries.
|
|
11
|
+
|
|
12
|
+
**Key rules (all proven by a real end-to-end deploy):**
|
|
13
|
+
|
|
14
|
+
1. **Service code MUST live under `services/<name>/`, not the repo/template
|
|
15
|
+
root.** `path:` in `cloudgrid.yaml` is the URL mount, NOT the filesystem path.
|
|
16
|
+
The service named `web` → the CLI looks for `services/web/`. App files at the
|
|
17
|
+
root fail with `Error: Service directory not found: …/services/web`.
|
|
18
|
+
2. **Read the DB connection string LAZILY (inside the getter), never at module
|
|
19
|
+
top level.** The grid injects it as the `DATABASE_MONGODB_URL` environment
|
|
20
|
+
variable (plus the legacy `MONGODB_URL` alias) at dev-time and runtime; the
|
|
21
|
+
app reads `process.env.DATABASE_MONGODB_URL || process.env.MONGODB_URL` inside
|
|
22
|
+
`getDb`. A top-level read that throws fails `next build` (the module is
|
|
23
|
+
imported for route analysis before the grid injects the var). Never hardcode a
|
|
24
|
+
connection string; never commit a secret.
|
|
25
|
+
3. **Declare the datastore with `needs: { database: true }`.** This is the
|
|
26
|
+
canonical shape — the deployer provisions Mongo and injects
|
|
27
|
+
`DATABASE_MONGODB_URL` (plus the legacy `MONGODB_URL` alias). `requires:` is
|
|
28
|
+
the deprecated v1 alias; don't author new yaml with it, and never set `needs:`
|
|
29
|
+
and `requires:` together (the validator rejects the combination).
|
|
30
|
+
|
|
31
|
+
Write these files into the scaffolded app folder — the app code goes under
|
|
32
|
+
`services/web/` — adapt the collection/fields to the user's app, then `grid dev`
|
|
33
|
+
(local) / `grid plug` (deploy, async — poll to a live URL).
|
|
34
|
+
|
|
35
|
+
## File tree
|
|
36
|
+
|
|
37
|
+
```
|
|
38
|
+
cloudgrid.yaml # name + services.web (nextjs) + needs: { database: true }
|
|
39
|
+
services/web/package.json # next, react, react-dom, mongodb driver only
|
|
40
|
+
services/web/lib/db.js # lazy Mongo client from DATABASE_MONGODB_URL (legacy MONGODB_URL fallback)
|
|
41
|
+
services/web/app/layout.js # root layout + inline CSS
|
|
42
|
+
services/web/app/page.js # server component: reads entries, computes totals
|
|
43
|
+
services/web/app/entry-board.js # client board: totals + table, POST/DELETE via the API
|
|
44
|
+
services/web/app/api/entries/route.js # GET (list) / POST (add) / DELETE (remove)
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## cloudgrid.yaml
|
|
48
|
+
|
|
49
|
+
```yaml
|
|
50
|
+
# On disk this file is the full-annotated reference (templates/_cloudgrid.yaml.reference) with EVERY
|
|
51
|
+
# field present as a comment; only the fields below are uncommented, so it
|
|
52
|
+
# deploys to exactly these active fields.
|
|
53
|
+
name: financial-dashboard
|
|
54
|
+
services:
|
|
55
|
+
web:
|
|
56
|
+
type: nextjs
|
|
57
|
+
path: /
|
|
58
|
+
needs:
|
|
59
|
+
database: true
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
> **Capability:** this template's need is `database: true`. The deployer
|
|
63
|
+
> provisions Mongo and injects `DATABASE_MONGODB_URL` (plus the legacy
|
|
64
|
+
> `MONGODB_URL` alias), so an app reading either var works. `requires:` is the
|
|
65
|
+
> deprecated v1 alias — don't mix it with `needs:` (the validator rejects the
|
|
66
|
+
> combination). See the capability-map for the full injection table.
|
|
67
|
+
|
|
68
|
+
## services/web/package.json
|
|
69
|
+
|
|
70
|
+
```json
|
|
71
|
+
{
|
|
72
|
+
"name": "financial-dashboard",
|
|
73
|
+
"version": "0.1.0",
|
|
74
|
+
"private": true,
|
|
75
|
+
"scripts": {
|
|
76
|
+
"dev": "next dev",
|
|
77
|
+
"build": "next build",
|
|
78
|
+
"start": "next start"
|
|
79
|
+
},
|
|
80
|
+
"dependencies": {
|
|
81
|
+
"next": "^15.1.0",
|
|
82
|
+
"react": "^19.0.0",
|
|
83
|
+
"react-dom": "^19.0.0",
|
|
84
|
+
"mongodb": "^6.12.0"
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## services/web/lib/db.js
|
|
90
|
+
|
|
91
|
+
```js
|
|
92
|
+
// Cached MongoDB client for the App Router.
|
|
93
|
+
//
|
|
94
|
+
// The grid injects the connection string as the DATABASE_MONGODB_URL environment
|
|
95
|
+
// variable (plus the legacy MONGODB_URL alias) at runtime (after `grid plug`) and
|
|
96
|
+
// under `grid dev` locally. Read the canonical var first, fall back to the legacy
|
|
97
|
+
// alias. Never hardcode a connection string here and never commit a secret.
|
|
98
|
+
//
|
|
99
|
+
// The env var and client are resolved LAZILY (inside getDb), never at module top
|
|
100
|
+
// level — otherwise `next build` throws when it imports this module for route
|
|
101
|
+
// analysis, before the grid injects the var.
|
|
102
|
+
import { MongoClient } from "mongodb";
|
|
103
|
+
|
|
104
|
+
function clientPromise() {
|
|
105
|
+
const uri = process.env.DATABASE_MONGODB_URL || process.env.MONGODB_URL;
|
|
106
|
+
if (!uri) {
|
|
107
|
+
throw new Error(
|
|
108
|
+
"DATABASE_MONGODB_URL is not set. The grid injects it automatically — run " +
|
|
109
|
+
"this app with `grid dev` locally, or deploy it with `grid plug` (the grid " +
|
|
110
|
+
"injects the DB connection string at runtime). Do not set it by hand.",
|
|
111
|
+
);
|
|
112
|
+
}
|
|
113
|
+
if (!globalThis.__mongoClientPromise) {
|
|
114
|
+
globalThis.__mongoClientPromise = new MongoClient(uri).connect();
|
|
115
|
+
}
|
|
116
|
+
return globalThis.__mongoClientPromise;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
export async function getDb() {
|
|
120
|
+
const client = await clientPromise();
|
|
121
|
+
return client.db();
|
|
122
|
+
}
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
## services/web/app/layout.js
|
|
126
|
+
|
|
127
|
+
```js
|
|
128
|
+
export const metadata = {
|
|
129
|
+
title: "Financial Dashboard",
|
|
130
|
+
description: "A persistent P&L / cashflow board on CloudGrid, backed by grid-shared Mongo.",
|
|
131
|
+
};
|
|
132
|
+
|
|
133
|
+
const css = `
|
|
134
|
+
:root { color-scheme: light dark; }
|
|
135
|
+
body { margin: 0; font-family: system-ui, sans-serif; }
|
|
136
|
+
main { max-width: 52rem; margin: 3rem auto; padding: 0 1.25rem; }
|
|
137
|
+
.totals { display: grid; grid-template-columns: repeat(3, 1fr); gap: .75rem; margin-bottom: 1.5rem; }
|
|
138
|
+
.card { border: 1px solid #8886; border-radius: .75rem; padding: 1rem; }
|
|
139
|
+
.value { font-size: 1.5rem; font-weight: 600; font-variant-numeric: tabular-nums; }
|
|
140
|
+
.row { display: flex; flex-wrap: wrap; gap: .5rem; margin-bottom: 1.5rem; }
|
|
141
|
+
input, select { padding: .5rem .75rem; border: 1px solid #8886; border-radius: .5rem; }
|
|
142
|
+
button { padding: .5rem .9rem; border: 1px solid #8886; border-radius: .5rem; cursor: pointer; }
|
|
143
|
+
table { width: 100%; border-collapse: collapse; }
|
|
144
|
+
th, td { text-align: left; padding: .55rem .5rem; border-bottom: 1px solid #8883; }
|
|
145
|
+
td.num { text-align: right; font-variant-numeric: tabular-nums; }
|
|
146
|
+
`;
|
|
147
|
+
|
|
148
|
+
export default function RootLayout({ children }) {
|
|
149
|
+
return (
|
|
150
|
+
<html lang="en">
|
|
151
|
+
<head><style dangerouslySetInnerHTML={{ __html: css }} /></head>
|
|
152
|
+
<body>{children}</body>
|
|
153
|
+
</html>
|
|
154
|
+
);
|
|
155
|
+
}
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
## services/web/app/page.js
|
|
159
|
+
|
|
160
|
+
```js
|
|
161
|
+
import { getDb } from "../lib/db.js";
|
|
162
|
+
import EntryBoard from "./entry-board.js";
|
|
163
|
+
|
|
164
|
+
export const dynamic = "force-dynamic";
|
|
165
|
+
|
|
166
|
+
async function listEntries() {
|
|
167
|
+
const db = await getDb();
|
|
168
|
+
const items = await db.collection("entries").find({}).sort({ at: -1 }).toArray();
|
|
169
|
+
return items.map((e) => ({
|
|
170
|
+
id: e._id.toString(),
|
|
171
|
+
account: e.account,
|
|
172
|
+
amount: e.amount,
|
|
173
|
+
type: e.type,
|
|
174
|
+
at: e.at instanceof Date ? e.at.toISOString() : e.at,
|
|
175
|
+
}));
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
export default async function Page() {
|
|
179
|
+
const entries = await listEntries();
|
|
180
|
+
return (
|
|
181
|
+
<main>
|
|
182
|
+
<h1>Financial Dashboard</h1>
|
|
183
|
+
<p className="hint">P&L / cashflow board — persisted in grid-shared Mongo.</p>
|
|
184
|
+
<EntryBoard initialEntries={entries} />
|
|
185
|
+
</main>
|
|
186
|
+
);
|
|
187
|
+
}
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
## services/web/app/entry-board.js
|
|
191
|
+
|
|
192
|
+
```js
|
|
193
|
+
"use client";
|
|
194
|
+
import { useState } from "react";
|
|
195
|
+
|
|
196
|
+
const fmt = (n) =>
|
|
197
|
+
n.toLocaleString(undefined, { style: "currency", currency: "USD", maximumFractionDigits: 2 });
|
|
198
|
+
|
|
199
|
+
function totals(entries) {
|
|
200
|
+
let income = 0, expense = 0;
|
|
201
|
+
for (const e of entries) {
|
|
202
|
+
if (e.type === "income") income += e.amount;
|
|
203
|
+
else expense += e.amount;
|
|
204
|
+
}
|
|
205
|
+
return { income, expense, net: income - expense };
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
export default function EntryBoard({ initialEntries }) {
|
|
209
|
+
const [entries, setEntries] = useState(initialEntries);
|
|
210
|
+
const [account, setAccount] = useState("");
|
|
211
|
+
const [amount, setAmount] = useState("");
|
|
212
|
+
const [type, setType] = useState("income");
|
|
213
|
+
const t = totals(entries);
|
|
214
|
+
|
|
215
|
+
async function add(e) {
|
|
216
|
+
e.preventDefault();
|
|
217
|
+
const acct = account.trim();
|
|
218
|
+
const amt = Number(amount);
|
|
219
|
+
if (!acct || !Number.isFinite(amt) || amt <= 0) return;
|
|
220
|
+
const res = await fetch("/api/entries", {
|
|
221
|
+
method: "POST",
|
|
222
|
+
headers: { "content-type": "application/json" },
|
|
223
|
+
body: JSON.stringify({ account: acct, amount: amt, type }),
|
|
224
|
+
});
|
|
225
|
+
if (res.ok) { setEntries((p) => [await res.json(), ...p]); setAccount(""); setAmount(""); }
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
async function remove(id) {
|
|
229
|
+
const res = await fetch(`/api/entries?id=${encodeURIComponent(id)}`, { method: "DELETE" });
|
|
230
|
+
if (res.ok) setEntries((p) => p.filter((e) => e.id !== id));
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
return (
|
|
234
|
+
<div>
|
|
235
|
+
<div className="totals">
|
|
236
|
+
<div className="card"><div className="label">Income</div><div className="value income">{fmt(t.income)}</div></div>
|
|
237
|
+
<div className="card"><div className="label">Expense</div><div className="value expense">{fmt(t.expense)}</div></div>
|
|
238
|
+
<div className="card"><div className="label">Net</div><div className="value net">{fmt(t.net)}</div></div>
|
|
239
|
+
</div>
|
|
240
|
+
<form onSubmit={add} className="row">
|
|
241
|
+
<input value={account} onChange={(e) => setAccount(e.target.value)} placeholder="Account" />
|
|
242
|
+
<input type="number" min="0" step="0.01" value={amount} onChange={(e) => setAmount(e.target.value)} placeholder="Amount" />
|
|
243
|
+
<select value={type} onChange={(e) => setType(e.target.value)}>
|
|
244
|
+
<option value="income">Income</option>
|
|
245
|
+
<option value="expense">Expense</option>
|
|
246
|
+
</select>
|
|
247
|
+
<button type="submit">Add</button>
|
|
248
|
+
</form>
|
|
249
|
+
<table>
|
|
250
|
+
<thead><tr><th>Account</th><th>Type</th><th>Amount</th><th>Date</th><th></th></tr></thead>
|
|
251
|
+
<tbody>
|
|
252
|
+
{entries.map((e) => (
|
|
253
|
+
<tr key={e.id}>
|
|
254
|
+
<td>{e.account}</td>
|
|
255
|
+
<td>{e.type}</td>
|
|
256
|
+
<td className="num">{fmt(e.amount)}</td>
|
|
257
|
+
<td>{new Date(e.at).toLocaleDateString()}</td>
|
|
258
|
+
<td className="num"><button type="button" onClick={() => remove(e.id)}>Delete</button></td>
|
|
259
|
+
</tr>
|
|
260
|
+
))}
|
|
261
|
+
</tbody>
|
|
262
|
+
</table>
|
|
263
|
+
</div>
|
|
264
|
+
);
|
|
265
|
+
}
|
|
266
|
+
```
|
|
267
|
+
|
|
268
|
+
## services/web/app/api/entries/route.js
|
|
269
|
+
|
|
270
|
+
```js
|
|
271
|
+
import { NextResponse } from "next/server";
|
|
272
|
+
import { ObjectId } from "mongodb";
|
|
273
|
+
import { getDb } from "../../../lib/db.js";
|
|
274
|
+
|
|
275
|
+
export const dynamic = "force-dynamic";
|
|
276
|
+
|
|
277
|
+
async function entries() {
|
|
278
|
+
const db = await getDb();
|
|
279
|
+
return db.collection("entries");
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
function serialize(e) {
|
|
283
|
+
return {
|
|
284
|
+
id: e._id.toString(),
|
|
285
|
+
account: e.account,
|
|
286
|
+
amount: e.amount,
|
|
287
|
+
type: e.type,
|
|
288
|
+
at: e.at instanceof Date ? e.at.toISOString() : e.at,
|
|
289
|
+
};
|
|
290
|
+
}
|
|
291
|
+
|
|
292
|
+
export async function GET() {
|
|
293
|
+
const col = await entries();
|
|
294
|
+
const items = await col.find({}).sort({ at: -1 }).toArray();
|
|
295
|
+
return NextResponse.json(items.map(serialize));
|
|
296
|
+
}
|
|
297
|
+
|
|
298
|
+
export async function POST(request) {
|
|
299
|
+
const body = await request.json().catch(() => ({}));
|
|
300
|
+
const account = typeof body.account === "string" ? body.account.trim() : "";
|
|
301
|
+
const amount = Number(body.amount);
|
|
302
|
+
const type = body.type === "expense" ? "expense" : "income";
|
|
303
|
+
if (!account) return NextResponse.json({ error: "account is required" }, { status: 400 });
|
|
304
|
+
if (!Number.isFinite(amount) || amount <= 0) return NextResponse.json({ error: "amount must be a positive number" }, { status: 400 });
|
|
305
|
+
const col = await entries();
|
|
306
|
+
const doc = { account, amount, type, at: new Date() };
|
|
307
|
+
const res = await col.insertOne(doc);
|
|
308
|
+
return NextResponse.json(serialize({ _id: res.insertedId, ...doc }), { status: 201 });
|
|
309
|
+
}
|
|
310
|
+
|
|
311
|
+
export async function DELETE(request) {
|
|
312
|
+
const id = new URL(request.url).searchParams.get("id");
|
|
313
|
+
if (!id || !ObjectId.isValid(id)) return NextResponse.json({ error: "valid id is required" }, { status: 400 });
|
|
314
|
+
const col = await entries();
|
|
315
|
+
await col.deleteOne({ _id: new ObjectId(id) });
|
|
316
|
+
return NextResponse.json({ ok: true });
|
|
317
|
+
}
|
|
318
|
+
```
|
|
319
|
+
|
|
320
|
+
## Adapt it
|
|
321
|
+
|
|
322
|
+
- Rename the `entries` collection to your data.
|
|
323
|
+
- Change the document fields; add a category, currency, memo, or owner.
|
|
324
|
+
- Add more totals (per-account rollups, monthly buckets) or a chart.
|
|
325
|
+
- Add `cache: true` to `needs:` only if you actually need Redis.
|
|
326
|
+
- Run `grid dev` to test locally, `grid plug` to deploy (async — poll to live).
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
// App Router route handler for the `entries` collection.
|
|
2
|
+
// GET -> list entries, POST -> add an entry, DELETE -> remove an entry by id.
|
|
3
|
+
//
|
|
4
|
+
// Domain: an entry is { account: string, amount: number, type: "income"|"expense", at: Date }.
|
|
5
|
+
// To adapt this app, rename the collection and change the fields to match your
|
|
6
|
+
// own data.
|
|
7
|
+
import { NextResponse } from "next/server";
|
|
8
|
+
import { ObjectId } from "mongodb";
|
|
9
|
+
import { getDb } from "../../../lib/db.js";
|
|
10
|
+
|
|
11
|
+
// Never cache — always read/write live data.
|
|
12
|
+
export const dynamic = "force-dynamic";
|
|
13
|
+
|
|
14
|
+
async function entries() {
|
|
15
|
+
const db = await getDb();
|
|
16
|
+
return db.collection("entries");
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
function serialize(e) {
|
|
20
|
+
return {
|
|
21
|
+
id: e._id.toString(),
|
|
22
|
+
account: e.account,
|
|
23
|
+
amount: e.amount,
|
|
24
|
+
type: e.type,
|
|
25
|
+
at: e.at instanceof Date ? e.at.toISOString() : e.at,
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
// GET /api/entries — list all entries, newest first.
|
|
30
|
+
export async function GET() {
|
|
31
|
+
const col = await entries();
|
|
32
|
+
const items = await col.find({}).sort({ at: -1 }).toArray();
|
|
33
|
+
return NextResponse.json(items.map(serialize));
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
// POST /api/entries — add an entry. Body: { account, amount, type }.
|
|
37
|
+
export async function POST(request) {
|
|
38
|
+
const body = await request.json().catch(() => ({}));
|
|
39
|
+
const account = typeof body.account === "string" ? body.account.trim() : "";
|
|
40
|
+
const amount = Number(body.amount);
|
|
41
|
+
const type = body.type === "expense" ? "expense" : "income";
|
|
42
|
+
if (!account) {
|
|
43
|
+
return NextResponse.json({ error: "account is required" }, { status: 400 });
|
|
44
|
+
}
|
|
45
|
+
if (!Number.isFinite(amount) || amount <= 0) {
|
|
46
|
+
return NextResponse.json({ error: "amount must be a positive number" }, { status: 400 });
|
|
47
|
+
}
|
|
48
|
+
const col = await entries();
|
|
49
|
+
const doc = { account, amount, type, at: new Date() };
|
|
50
|
+
const res = await col.insertOne(doc);
|
|
51
|
+
return NextResponse.json(serialize({ _id: res.insertedId, ...doc }), { status: 201 });
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
// DELETE /api/entries?id=<id> — remove an entry.
|
|
55
|
+
export async function DELETE(request) {
|
|
56
|
+
const id = new URL(request.url).searchParams.get("id");
|
|
57
|
+
if (!id || !ObjectId.isValid(id)) {
|
|
58
|
+
return NextResponse.json({ error: "valid id is required" }, { status: 400 });
|
|
59
|
+
}
|
|
60
|
+
const col = await entries();
|
|
61
|
+
await col.deleteOne({ _id: new ObjectId(id) });
|
|
62
|
+
return NextResponse.json({ ok: true });
|
|
63
|
+
}
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
// Client board: renders the totals + entries table and posts to /api/entries.
|
|
4
|
+
// Totals (income / expense / net) are derived from the current entries so they
|
|
5
|
+
// update instantly on add/delete, matching the server-computed view on refresh.
|
|
6
|
+
import { useState } from "react";
|
|
7
|
+
|
|
8
|
+
const fmt = (n) =>
|
|
9
|
+
n.toLocaleString(undefined, { style: "currency", currency: "USD", maximumFractionDigits: 2 });
|
|
10
|
+
|
|
11
|
+
function totals(entries) {
|
|
12
|
+
let income = 0;
|
|
13
|
+
let expense = 0;
|
|
14
|
+
for (const e of entries) {
|
|
15
|
+
if (e.type === "income") income += e.amount;
|
|
16
|
+
else expense += e.amount;
|
|
17
|
+
}
|
|
18
|
+
return { income, expense, net: income - expense };
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
export default function EntryBoard({ initialEntries }) {
|
|
22
|
+
const [entries, setEntries] = useState(initialEntries);
|
|
23
|
+
const [account, setAccount] = useState("");
|
|
24
|
+
const [amount, setAmount] = useState("");
|
|
25
|
+
const [type, setType] = useState("income");
|
|
26
|
+
const [busy, setBusy] = useState(false);
|
|
27
|
+
|
|
28
|
+
const t = totals(entries);
|
|
29
|
+
|
|
30
|
+
async function add(e) {
|
|
31
|
+
e.preventDefault();
|
|
32
|
+
const acct = account.trim();
|
|
33
|
+
const amt = Number(amount);
|
|
34
|
+
if (!acct || !Number.isFinite(amt) || amt <= 0) return;
|
|
35
|
+
setBusy(true);
|
|
36
|
+
const res = await fetch("/api/entries", {
|
|
37
|
+
method: "POST",
|
|
38
|
+
headers: { "content-type": "application/json" },
|
|
39
|
+
body: JSON.stringify({ account: acct, amount: amt, type }),
|
|
40
|
+
});
|
|
41
|
+
if (res.ok) {
|
|
42
|
+
const entry = await res.json();
|
|
43
|
+
setEntries((prev) => [entry, ...prev]);
|
|
44
|
+
setAccount("");
|
|
45
|
+
setAmount("");
|
|
46
|
+
}
|
|
47
|
+
setBusy(false);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
async function remove(id) {
|
|
51
|
+
setBusy(true);
|
|
52
|
+
const res = await fetch(`/api/entries?id=${encodeURIComponent(id)}`, { method: "DELETE" });
|
|
53
|
+
if (res.ok) setEntries((prev) => prev.filter((e) => e.id !== id));
|
|
54
|
+
setBusy(false);
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
return (
|
|
58
|
+
<div>
|
|
59
|
+
<div className="totals">
|
|
60
|
+
<div className="card">
|
|
61
|
+
<div className="label">Income</div>
|
|
62
|
+
<div className="value income">{fmt(t.income)}</div>
|
|
63
|
+
</div>
|
|
64
|
+
<div className="card">
|
|
65
|
+
<div className="label">Expense</div>
|
|
66
|
+
<div className="value expense">{fmt(t.expense)}</div>
|
|
67
|
+
</div>
|
|
68
|
+
<div className="card">
|
|
69
|
+
<div className="label">Net</div>
|
|
70
|
+
<div className={`value net ${t.net >= 0 ? "pos" : "neg"}`}>{fmt(t.net)}</div>
|
|
71
|
+
</div>
|
|
72
|
+
</div>
|
|
73
|
+
|
|
74
|
+
<form onSubmit={add} className="row">
|
|
75
|
+
<input
|
|
76
|
+
className="account"
|
|
77
|
+
value={account}
|
|
78
|
+
onChange={(e) => setAccount(e.target.value)}
|
|
79
|
+
placeholder="Account (e.g. Sales, Rent)"
|
|
80
|
+
aria-label="Account"
|
|
81
|
+
/>
|
|
82
|
+
<input
|
|
83
|
+
className="amount"
|
|
84
|
+
type="number"
|
|
85
|
+
min="0"
|
|
86
|
+
step="0.01"
|
|
87
|
+
value={amount}
|
|
88
|
+
onChange={(e) => setAmount(e.target.value)}
|
|
89
|
+
placeholder="Amount"
|
|
90
|
+
aria-label="Amount"
|
|
91
|
+
/>
|
|
92
|
+
<select value={type} onChange={(e) => setType(e.target.value)} aria-label="Type">
|
|
93
|
+
<option value="income">Income</option>
|
|
94
|
+
<option value="expense">Expense</option>
|
|
95
|
+
</select>
|
|
96
|
+
<button type="submit" disabled={busy}>Add</button>
|
|
97
|
+
</form>
|
|
98
|
+
|
|
99
|
+
<table>
|
|
100
|
+
<thead>
|
|
101
|
+
<tr>
|
|
102
|
+
<th>Account</th>
|
|
103
|
+
<th>Type</th>
|
|
104
|
+
<th style={{ textAlign: "right" }}>Amount</th>
|
|
105
|
+
<th>Date</th>
|
|
106
|
+
<th></th>
|
|
107
|
+
</tr>
|
|
108
|
+
</thead>
|
|
109
|
+
<tbody>
|
|
110
|
+
{entries.length === 0 && (
|
|
111
|
+
<tr className="empty">
|
|
112
|
+
<td colSpan={5}>No entries yet.</td>
|
|
113
|
+
</tr>
|
|
114
|
+
)}
|
|
115
|
+
{entries.map((e) => (
|
|
116
|
+
<tr key={e.id}>
|
|
117
|
+
<td>{e.account}</td>
|
|
118
|
+
<td className={e.type}>{e.type}</td>
|
|
119
|
+
<td className={`num ${e.type}`}>{fmt(e.amount)}</td>
|
|
120
|
+
<td>{new Date(e.at).toLocaleDateString()}</td>
|
|
121
|
+
<td className="num">
|
|
122
|
+
<button type="button" onClick={() => remove(e.id)} disabled={busy}>Delete</button>
|
|
123
|
+
</td>
|
|
124
|
+
</tr>
|
|
125
|
+
))}
|
|
126
|
+
</tbody>
|
|
127
|
+
</table>
|
|
128
|
+
</div>
|
|
129
|
+
);
|
|
130
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
// Root layout + plain inline CSS (no external CDNs, fonts, or stylesheets).
|
|
2
|
+
export const metadata = {
|
|
3
|
+
title: "Financial Dashboard",
|
|
4
|
+
description: "A persistent P&L / cashflow board on CloudGrid, backed by grid-shared Mongo.",
|
|
5
|
+
};
|
|
6
|
+
|
|
7
|
+
const css = `
|
|
8
|
+
:root { color-scheme: light dark; }
|
|
9
|
+
* { box-sizing: border-box; }
|
|
10
|
+
body { margin: 0; font-family: system-ui, -apple-system, sans-serif; line-height: 1.5; }
|
|
11
|
+
main { max-width: 52rem; margin: 3rem auto; padding: 0 1.25rem; }
|
|
12
|
+
h1 { margin: 0 0 .25rem; }
|
|
13
|
+
.hint { margin: 0 0 1.5rem; opacity: .7; font-size: .9rem; }
|
|
14
|
+
.totals { display: grid; grid-template-columns: repeat(3, 1fr); gap: .75rem; margin-bottom: 1.5rem; }
|
|
15
|
+
.card { border: 1px solid #8886; border-radius: .75rem; padding: 1rem; }
|
|
16
|
+
.card .label { font-size: .8rem; opacity: .7; text-transform: uppercase; letter-spacing: .04em; }
|
|
17
|
+
.card .value { font-size: 1.5rem; font-weight: 600; font-variant-numeric: tabular-nums; }
|
|
18
|
+
.value.income { color: #16a34a; }
|
|
19
|
+
.value.expense { color: #dc2626; }
|
|
20
|
+
.value.net.pos { color: #16a34a; }
|
|
21
|
+
.value.net.neg { color: #dc2626; }
|
|
22
|
+
.row { display: flex; flex-wrap: wrap; gap: .5rem; margin-bottom: 1.5rem; }
|
|
23
|
+
input, select { padding: .5rem .75rem; border: 1px solid #8886; border-radius: .5rem; font: inherit; background: transparent; }
|
|
24
|
+
input.account { flex: 1; min-width: 8rem; }
|
|
25
|
+
input.amount { width: 8rem; font-variant-numeric: tabular-nums; }
|
|
26
|
+
button { padding: .5rem .9rem; border: 1px solid #8886; border-radius: .5rem; background: #6663; font: inherit; cursor: pointer; }
|
|
27
|
+
button:disabled { opacity: .5; cursor: default; }
|
|
28
|
+
table { width: 100%; border-collapse: collapse; }
|
|
29
|
+
th, td { text-align: left; padding: .55rem .5rem; border-bottom: 1px solid #8883; }
|
|
30
|
+
th { font-size: .75rem; text-transform: uppercase; letter-spacing: .04em; opacity: .65; }
|
|
31
|
+
td.num { text-align: right; font-variant-numeric: tabular-nums; }
|
|
32
|
+
td.income { color: #16a34a; }
|
|
33
|
+
td.expense { color: #dc2626; }
|
|
34
|
+
tr.empty td { opacity: .6; text-align: left; }
|
|
35
|
+
`;
|
|
36
|
+
|
|
37
|
+
export default function RootLayout({ children }) {
|
|
38
|
+
return (
|
|
39
|
+
<html lang="en">
|
|
40
|
+
<head>
|
|
41
|
+
<style dangerouslySetInnerHTML={{ __html: css }} />
|
|
42
|
+
</head>
|
|
43
|
+
<body>{children}</body>
|
|
44
|
+
</html>
|
|
45
|
+
);
|
|
46
|
+
}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
// Home page: a server component reads the entries straight from Mongo, computes
|
|
2
|
+
// the income / expense / net totals, and a small client board adds/removes them
|
|
3
|
+
// via the API route. Data persists across refresh and across users because it
|
|
4
|
+
// lives in the grid-shared Mongo, not in memory.
|
|
5
|
+
import { getDb } from "../lib/db.js";
|
|
6
|
+
import EntryBoard from "./entry-board.js";
|
|
7
|
+
|
|
8
|
+
export const dynamic = "force-dynamic";
|
|
9
|
+
|
|
10
|
+
async function listEntries() {
|
|
11
|
+
const db = await getDb();
|
|
12
|
+
const items = await db.collection("entries").find({}).sort({ at: -1 }).toArray();
|
|
13
|
+
return items.map((e) => ({
|
|
14
|
+
id: e._id.toString(),
|
|
15
|
+
account: e.account,
|
|
16
|
+
amount: e.amount,
|
|
17
|
+
type: e.type,
|
|
18
|
+
at: e.at instanceof Date ? e.at.toISOString() : e.at,
|
|
19
|
+
}));
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export default async function Page() {
|
|
23
|
+
const entries = await listEntries();
|
|
24
|
+
return (
|
|
25
|
+
<main>
|
|
26
|
+
<h1>Financial Dashboard</h1>
|
|
27
|
+
<p className="hint">P&L / cashflow board — persisted in grid-shared Mongo, survives refresh.</p>
|
|
28
|
+
<EntryBoard initialEntries={entries} />
|
|
29
|
+
</main>
|
|
30
|
+
);
|
|
31
|
+
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
// Cached MongoDB client for the App Router.
|
|
2
|
+
//
|
|
3
|
+
// The grid injects the connection string as the DATABASE_MONGODB_URL environment
|
|
4
|
+
// variable (plus the legacy MONGODB_URL alias) at dev-time (`grid dev`) and
|
|
5
|
+
// runtime (after `grid plug`). Read the canonical var first, fall back to the
|
|
6
|
+
// legacy alias. Never hardcode a connection string here and never commit a secret.
|
|
7
|
+
//
|
|
8
|
+
// The env var and client are resolved LAZILY (inside getDb), never at module top
|
|
9
|
+
// level — otherwise `next build` throws when it imports this module for route
|
|
10
|
+
// analysis, before the grid injects the var.
|
|
11
|
+
import { MongoClient } from "mongodb";
|
|
12
|
+
|
|
13
|
+
function clientPromise() {
|
|
14
|
+
const uri = process.env.DATABASE_MONGODB_URL || process.env.MONGODB_URL;
|
|
15
|
+
if (!uri) {
|
|
16
|
+
throw new Error(
|
|
17
|
+
"DATABASE_MONGODB_URL is not set. The grid injects it automatically — run " +
|
|
18
|
+
"this app with `grid dev` locally, or deploy it with `grid plug` (the grid " +
|
|
19
|
+
"injects the DB connection string at runtime). Do not set it by hand.",
|
|
20
|
+
);
|
|
21
|
+
}
|
|
22
|
+
if (!globalThis.__mongoClientPromise) {
|
|
23
|
+
globalThis.__mongoClientPromise = new MongoClient(uri).connect();
|
|
24
|
+
}
|
|
25
|
+
return globalThis.__mongoClientPromise;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export async function getDb() {
|
|
29
|
+
const client = await clientPromise();
|
|
30
|
+
// The default DB comes from the connection-string path segment the grid injects.
|
|
31
|
+
return client.db();
|
|
32
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "financial-dashboard",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"private": true,
|
|
5
|
+
"scripts": {
|
|
6
|
+
"dev": "next dev",
|
|
7
|
+
"build": "next build",
|
|
8
|
+
"start": "next start"
|
|
9
|
+
},
|
|
10
|
+
"dependencies": {
|
|
11
|
+
"next": "^15.1.0",
|
|
12
|
+
"react": "^19.0.0",
|
|
13
|
+
"react-dom": "^19.0.0",
|
|
14
|
+
"mongodb": "^6.12.0"
|
|
15
|
+
}
|
|
16
|
+
}
|