1. Introduction

GR8 CRM is a set of Grails Web Application Framework plugins that makes it easy to develop web applications with CRM functionality.

You can find more information about GR8 CRM on the main documentation site http://gr8crm.github.io.

1.1. Customer Relationship Management

Customer relationship management (CRM) is a system for managing a company’s interactions with current and future customers. It involves using technology to organize, automate and synchronize sales, marketing, customer service, and technical support. Wikipedia

The GR8 CRM "Ecosystem" currently contains over 40 Grails plugins. For a complete list of plugins see http://gr8crm.github.io.

Each GR8 CRM plugin defines a Bounded Context that focus on one specific domain, for example contact, project or document.

2. Project Management User Interface Plugin

The crm-project-ui plugin provides a Twitter Bootstrap user interface for managing all kind of projects. It depends on the crm-project plugin for low level services and persistence.

The crm-project-ui plugin does not contain support for monetary information like project value or currency. For monetary project like sales leads and opportunities you should use the crm-sales and crm-sales-ui plugins.
Example project

3. CRUD user interface

The plugin provide user interface for creating and updating projects. It follows the same CRUD workflow as other GR8 CRM -ui plugins.

3.1. Create new project

You can create a project from all pages where you can search, list or view projects. Just press the [New Project] button and enter information in the create project form.

Create new project

3.2. Edit existing project

When you view an existing project you can alter information by pressing the [Edit] button.

Edit existing project

3.3. Find projects

The search form have several input fields where you can enter search criteria. When you hit [Search] you will either be presented with a list of matching projects or if there is only one match it will be displayed immediately.

Search projects

3.4. List projects

When you search for projects and more than one match you search criteria, a list will displayed where you can select a project to view details.

List projects

4. Project Roles

A project can have multiple people assigned to different roles. You can specify the project manager that will lead the project, or the sales support staff that are assigned to the project. As an administrator you can add as many role types as you want. These roles can then be used to assign people to the project.

Multiple project roles

To add a role other than customer and contact you press the [Add role] button on the Roles tab. You can add contacts already in your address book or create a new contact by entering new name. The new contact will be added to your address book when you save the project.

Add new role

5. Project resources

When creating or updating a project you can select the responsible project manager from a dropdown list. This dropdown list is populated using an application event crmTenant.getUsers. You must add an event listener in one of your application services that listens to this event and returns a list of users (project people).

For a list of all registered users you can add something like this to a service in your application:

@Listener(namespace="crmTenant", topic="getUsers")
def listAllUsersInTenant(data) {
    CrmUserRole.createCriteria().list(sort: 'user.name', order: 'asc') {
        resultTransformer CriteriaSpecification.ALIAS_TO_ENTITY_MAP
        projections {
            user {
                property('id', 'id')
                property('guid', 'guid')
                property('username', 'username')
                property('name', 'name')
                property('email', 'email')
        role {
            eq('tenantId', data.tenant)

6. Configuration

The crm-project-ui plugin can be configured with the following parameters.

Key Description Default value


Timeout (in seconds) waiting for export process to finish


7. Changes


First public release

8. License

This plugin is licensed with Apache License version 2.0

9. Source Code

The source code for this plugin is available at https://github.com/technipelago/grails-crm-project-ui

10. Contributing

Please report issues or suggestions.

Want to improve the plugin: Fork the repository and send a pull request.