SPCBotSPCBot Docs

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.png

Server List

Connected servers and their health status

public/docs/images/servers-list.png

Deployment View

Live deployment logs and progress

public/docs/images/deployment-view.png

Projects organize related Odoo instances and define shared configuration like Odoo version, repositories, and addon mounts.

Project Configuration

SettingDescription
Odoo VersionVersion to use (16, 17, 18)
RepositoryGit repo with Odoo customizations
BranchDefault branch for new instances
OrganizationTeam/company ownership
Addon MountsShared or dedicated addon repositories

Repository Setup

Connect GitHub repositories for automatic deployments:

  1. Add repo URL in project settings
  2. Configure webhook URL in GitHub repository settings
  3. 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