Addons DevPre-alpha

Addons overview

Repository: sumeru_addons/ — Tier 2 standard business apps. Depends only on sumeru (Go module replace sumeru => ../sumeru).

Three-repo architecture

sumeru/                 # Engine + kernel addons (pull-only)
sumeru_addons/          # Standard business apps (pull-only)
sumeru_custom_addons/   # Run server here + custom addons

Run the HTTP server from sumeru_custom_addons so addons_path loads core, standard, and custom roots.

Included modules

Module	Role
`utm`	Marketing campaign/medium/source tracking
`product`	Product catalog
`crm`	Leads, pipeline, opportunities
`sale`	Quotations and sales orders
`sale_crm`	Won opportunity → draft quotation
`account`	Invoices, bills, COA, payments
`purchase`	RFQ and purchase orders
`hr`	Employees, departments, jobs

contacts is a kernel addon in sumeru/addons/contacts/, listed in install order but not in this repo.

Dependency graph

base (core)
├── utm
├── product
├── contacts, mail (core)
│   ├── hr
│   ├── account (+ product)
│   │   └── purchase (+ product)
│   └── crm (+ utm, mail)
│       └── sale (+ product)
│           └── sale_crm

Typical install order

go run . -- -c sumeru.conf -i contacts,product,crm,sale,sale_crm,account,purchase,hr --stop-after-init

Communication mechanisms

Mechanism	How
`addons_path`	Later roots override duplicate manifest names
Manifest `depends`	Install order and XML load order
Go `sdk.MustRegister` (generated)	Tables and ORM metadata
XML data	Views, menus, security, seed data
`event.Subscribe`	Cross-module reactions
Many2One fields	Relations to `core.*` and other modules

Do not modify for customer work

Pull updates from upstream. Put overrides and client modules in sumeru_custom_addons/addons/.