[CREDO23]

What

Updates the legacy-split proposal: plugins/ moves to backend/plugins/, and the license portal and the mailer port into backend/license/ and backend/mailer/ beside it. One process, assembled in backend/server/, serves both. It lists what the move must change with it (Coolify's two builds, the BSL license path, workflows, links) and adds a CI job that builds the images.

Why

The license belongs to the desktop app, not to the plugins, so it should not live under plugins/. One backend/ with one folder per module replaces surfsense_backend.

Fixes # (none; related to #2100)

How to test

python scripts/check_docs.py docs/proposals/legacy-split/README.md

High-level PR Summary

This proposal consolidates the backend architecture by moving plugins/ into backend/plugins/ and relocating the license portal and mailer from surfsense_backend into backend/license/ and backend/mailer/. The change creates a single unified backend process served from backend/server/ that handles both plugins and licensing, replacing the previous split between surfsense_backend and the plugin host. The document details the migration strategy, including necessary changes to Coolify builds, CI workflows, file paths, documentation links, and deployment procedures, while also outlining the creation of a frozen legacy branch for deprecated code.

⏱️ Estimated Review Time: 15-30 minutes

💡 Review Order Suggestion

Order	File Path
1	docs/proposals/legacy-split/README.md

Summary by CodeRabbit

• Documentation
  • Updated the proposal to describe placing the active backend, license portal, and plugins under backend/, with the marketing site under homepage/.
  • Clarified that the legacy stack is to be preserved on a branch frozen at version 0.0.40 before removal from dev and main.
  • Revised the proposed rollout sequence, including deploying the backend before moving the API domain and switching off the hosted backend and MCP server.

[vercel]

@CREDO23 is attempting to deploy a commit to the Rohan Verma's projects Team on Vercel.

A member of the Team first needs to authorize it.

[coderabbitai]

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration

• Source mode: Auto
• Repository: MODSetter/SurfSense
• Branch: dev
• File: .coderabbit.yaml
• Commit: 9ed9871
• Layers: Repository YAML
• Review profile: CHILL
• Plan: Advanced
• Run ID: fb2682c1-d26a-4486-a008-9dd1f989f950

📥 Commits

Reviewing files that changed from the base of the PR and between 9ed9871 and 4a8d2f7.

📒 Files selected for processing: 1

• docs/proposals/legacy-split/README.md

+-----------------------------------------+
| OODA Loop: Observe, Orient, Debug, Act. |
+-----------------------------------------+
  \
   \     /)/)
        ( '')
        /  |
      o(___)

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create a new PR

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}