Skip to content

About

CRM Module for PhoniexKit. Manage your company or organization's activity (Contacts, Suppliers, Partners, Invoices, Orders, etc)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

PhoenixKitCRM

CRM module for PhoenixKit — implements the PhoenixKit.Module behaviour for auto-discovery by a parent Phoenix application.

An interaction-tracking CRM: contacts (people) and companies (legal entities), the interactions logged between them, each with its own media, comments, and activity feed. Roles opt in to CRM access, and every admin gets per-user column configuration.

Features

  • Contacts — people with profile fields, an optional linked login account, a circular avatar, and soft-delete (trash/restore). Each contact has Interactions, Files, Images, Comments, and Events (activity) tabs.
  • Companies — legal entities with a Members roster (contacts + their role/department), a logo, soft-delete, and the same Files/Images/Comments/Events tabs. The Interactions tab both logs company-level interactions and merges in the members' own, behind an All | Company | People filter.
  • Interactions — logged interactions (call/email/meeting/note/other) anchored to exactly one record — a contact or a company (the exclusive-arc anchor; subject is just the title) — with resolvable involved parties (CRM contacts or staff people) and a profile snapshot frozen at save time. "Anna at Acme" is a company-anchored interaction with Anna as a party, and shows on both pages.
  • Role opt-in — choose which non-system roles can access CRM; enabled roles get their own subtab under /admin/crm/role/:role_uuid.
  • Per-user column config — each admin picks which columns to show; the choice is kept in core's per-user view preferences.
  • Activity logging — create/update/trash/delete across contacts, companies, and interactions is recorded and surfaced on each record's Events tab.
  • Auto-discovery — no parent-app router edits; PhoenixKit picks the module up via the @phoenix_kit_module beam attribute.

Files/Images tabs require core Storage to be enabled; the Comments tab requires the phoenix_kit_comments module.

Installation

Add to the parent PhoenixKit app's mix.exs:

# Local development
{:phoenix_kit_crm, path: "../phoenix_kit_crm"}

# or, once published
{:phoenix_kit_crm, "~> 0.20"}

Then mix deps.get. The module appears in Admin > Modules and the sidebar automatically; toggle it on to expose /admin/crm.

Routes

Path LiveView
/admin/crm PhoenixKitCRM.Web.CRMLive
/admin/crm/contacts PhoenixKitCRM.Web.ContactsLive
/admin/crm/contacts/new · /:uuid/edit PhoenixKitCRM.Web.ContactFormLive
/admin/crm/contacts/:uuid PhoenixKitCRM.Web.ContactShowLive
/admin/crm/companies PhoenixKitCRM.Web.CompaniesLive
/admin/crm/companies/new · /:uuid/edit PhoenixKitCRM.Web.CompanyFormLive
/admin/crm/companies/:uuid PhoenixKitCRM.Web.CompanyShowLive
/admin/crm/lists (+ /new, /:uuid/edit, /:uuid/members, /:uuid/import) PhoenixKitCRM.Web.ListsLive + form/members/import views
/admin/crm/comparison PhoenixKitCRM.Web.ComparisonLive
/admin/crm/organizations PhoenixKitCRM.Web.OrganizationsView
/admin/crm/role/:role_uuid PhoenixKitCRM.Web.RoleView
/admin/settings/crm PhoenixKitCRM.Web.SettingsLive

The CRM section appears only after the module is toggled on under Admin > Settings > CRM; per-role subtabs appear for each opted-in role.

Database

The module owns its schema through its own versioned migration chain (PhoenixKitCRM.Migrations, via the PhoenixKit.Module.migration_module/0 callback). V01 adopts the tables core historically created; later versions are this repo's — V05 added the company interaction anchor. The applied version is a crm_schema:<N> comment marker on phoenix_kit_crm_contacts.

  • phoenix_kit_crm_contacts, phoenix_kit_crm_companies, phoenix_kit_crm_company_memberships — the people, legal entities, and their associations
  • phoenix_kit_crm_interactions, phoenix_kit_crm_interaction_parties — logged interactions (anchored to a contact XOR a company) + their involved parties
  • phoenix_kit_crm_party_roles — supplier/customer/manufacturer/partner roles on companies and contacts
  • phoenix_kit_crm_lists, phoenix_kit_crm_list_members — mailing lists + their members
  • phoenix_kit_crm_role_settings — which roles have CRM access enabled
  • phoenix_kit_crm_user_role_view — per-user, per-scope view configuration

The parent app applies both chains via mix phoenix_kit.install / mix phoenix_kit.update (mix phoenix_kit.status reports them).

Settings keys

  • crm_enabled — module on/off (also reflected on the Modules page)

Development

mix deps.get
mix compile
mix test            # unit tests; integration tests excluded if no DB
mix precommit       # compile + format + credo --strict + dialyzer

For integration tests, create the test database once:

createdb phoenix_kit_crm_test

The CRM tables come from this module's own migration chain. PHOENIX_KIT_PATH (and the same <APP>_PATH form for the other phoenix_kit* deps) swaps the Hex pin for a local checkout. Unset, the published pin is used.

See AGENTS.md for the development conventions, file layout, and testing setup.

Managed organization mirrors

An administrator in their own account can choose Create managed organization on a saved company's edit page, while core's organization accounts are enabled. Search for and select the first active manager explicitly. The company's email becomes a contact address; it may be shared with another account and never grants management by matching that account. Managers enter the organization from core's account menu and manage invitations in its account settings. The option needs core 3.5.0 or newer, which is this package's floor, so it is always compiled in. It stays hidden for anyone who is not an administrator of their own account, and when organization accounts are switched off.

An account added to a session stack acts on its own authority. Only an organization slot borrows from the account it was entered from.

Programmatic callers use Companies.create_mirror_user(company, managed: true, manager_actor: actor, first_manager_uuid: person_uuid), with actor constructed at browser mount by ManagedMirror.actor_from_session(session) from the trusted signed session, never event parameters. Creation locks and re-reads the company; concurrent requests cannot create a second orphaned account.

For a managed mirror, comparisons, resolution and reverse creation/adoption use contact_email. Claimed mirror account details remain read-only from CRM; edit those details through core's organization settings. Linking a CRM company never adds manager grants.

License

MIT — see LICENSE.

About

CRM Module for PhoniexKit. Manage your company or organization's activity (Contacts, Suppliers, Partners, Invoices, Orders, etc)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages