Core DevPre-alpha
Kernel addons
Built-in modules under sumeru/addons/. Installed via -i base (and dependencies) before business apps.
| Module | Application | Depends | Purpose |
|---|---|---|---|
| base | No (kernel) | — | Users, companies, partners, groups, system metadata, geo, i18n, API keys |
| contacts | Yes | base | Address book UI on core.partner — reference layout for new addons |
| Technical | base | Messages, chatter, activities (mail.message, mail.activity) | |
| automation | Technical | base, mail | Cron, declarative server actions, workflow transitions |
| sumeru_ai | Yes (opt-in) | base | AI hooks — search interceptor (pass-through), shell/notebook placeholders (auto_import: false) |
Reference layout: contacts
Use addons/contacts/ as the gold standard when scaffolding new kernel or custom addons:
- Split views:
{model}_{type}_views.xml(e.g.core_partner_form_views.xml) - Window actions in
views/actions.xmlwith - Security first in manifest,
views/menus.xmlalways last - Model extend in
models/partner_extend.go, view inherit inviews/core_partner_form_inherit_views.xml - Event hooks in
hooks.go, notinit.go
Full rules: MODULE_STANDARD.txt
base
- Models:
core.user,core.company,core.partner,core.group,sys.menu,sys.model,sys.config.parameter, … - Required for: All other modules
- Install:
go run . -- -c sumeru.conf -i base --stop-after-init - Layout: ~30 split view files, consolidated
views/menus.xml, per-model action files
contacts
- Depends:
base - Purpose: Partner/customer/vendor UI; required by CRM, Sales, Accounting, HR
- Inherit demo:
PartnerContactsextendscore.partnerwithcustomer_rank
- Depends:
base - Purpose: Chatter thread on forms, activity scheduling, activity panel in shell
- Web route:
POST /web/chatter/post - Required for: CRM activities, automation server actions on events
automation
- Depends:
base,mail - Models:
sys.cron,sys.server.action,sys.workflow.transition - Hooks:
hooks.goregisters event subscribers (not ininit.go) - Status: Event subscriber executes declarative server actions (
publish:/write:); cron rows dispatch to registered Go handlers (see Events and cron)
sumeru_ai
- Depends:
base - Status: Partial — opt-in module (
auto_import: false) - Registers
RegisterSearchInterceptor(pass-through), shell hook, and partner notebook hook - Natural language search is not core UX; see Feature matrix
Typical install order
go run . -- -c sumeru.conf -i base,contacts,mail --stop-after-initThen install sumeru_addons modules as needed.