Projects
Learn how projects work in SPCBot and how to configure them for your team.
Visual Guide
Drop real screenshots into the paths below. This grid is rendered by src/app/docs/components/image-placeholder.tsx.
Dashboard Overview
Main dashboard with stats and recent deployments
public/docs/images/dashboard-overview.pngServer List
Connected servers and their health status
public/docs/images/servers-list.pngDeployment View
Live deployment logs and progress
public/docs/images/deployment-view.pngProjects organize related Odoo instances and define shared configuration like Odoo version, repositories, and addon mounts.
Project Configuration
| Setting | Description |
|---|---|
| Odoo Version | Version to use (16, 17, 18) |
| Repository | Git repo with Odoo customizations |
| Branch | Default branch for new instances |
| Organization | Team/company ownership |
| Addon Mounts | Shared or dedicated addon repositories |
Repository Setup
Connect GitHub repositories for automatic deployments:
- Add repo URL in project settings
- Configure webhook URL in GitHub repository settings
- Set auto-deploy flag per environment
GitHub Webhook Configuration
Payload URL: https://your-spcbot.com/api/webhooks/github Content type: application/json Secret: (configured in project settings) Events: Push, Pull request
Addon Mounts
Configure how addon repositories are mounted in Odoo instances:
- SHARED: All instances share the same addon directory (saves space)
- DEDICATED: Each instance has its own addon copy (isolation)
API Endpoints
GET /organizations/:slug/projects # List projects POST /organizations/:slug/projects # Create project GET /organizations/:slug/projects/:id # Get project PUT /organizations/:slug/projects/:id # Update project DELETE /organizations/:slug/projects/:id # Delete project