Skip to main content

Manage the Business Requirements (stories, scenarii, gaps and test cases) for your customers

Project description

License: AGPL-3

Business Requirement


What is a Business Requirement?

A Business requirement (BR) is the expression of a business need by a customer or internal project user.

A BR contains multiple different parts to explain the stakeholder need and how to meet his/her requirements:

  • Customer Story: this is the requirement as expressed by the customer
  • Scenario: How/where the current solution can provide a suitable scenario to answer the customer story
  • Gap: For the uncovered part of the scenario, elaborate the gap/need for specific developments/setup
  • Test case: A set of conditions under which a tester will determine whether the application, software system or one of its features is working as it was originally established for it to do.
  • Deliverables to be provided to the customer/user
  • Resources necessary to achieve the deliverables
  • Additional information (approval, cost control etc.)

This set of modules was originally designed for the service/IT industry but the requirement management design has been kept as generic as possible so that it can apply to many other cases/industries (customer or internal projects):

  • Construction
  • Trading (New product development)
  • Business Consultancy
  • Web or IT development
  • R&D projects
  • etc.

More information about business requirements management:

Business Requirement set of modules

This module is part of a set (Business Requirements repo).

The base Business Requirements module creates the basic objects and can be used as a standalone module.

Business Requirement List view

Multiple modules integrate the BR with other business areas, such as Sales, Procurement, Project or Analytic Accounting. For example:

  • Sales Quotation can have an estimation supported by a BR analysis
  • Project Tasks can be related to the BRs they implement or support
  • Procurement and purchase can be generated out of the BR
Business Requirement modules diagram

The following workflow explains the business workflow between the BR modules and other applications in Odoo:

Business Requirement integration in Odoo

How to use this module?

This module only contains the standard base models for business requirement:

  • BR model definition
  • Standard setup and views
  • Standard Workflow
Business Requirement Form



  • Business Requirement User: can create and confirm a BR
  • Business Requirement Manager: can create, confirm and approve a BR

Alias and emails

You can setup an alias in Settings/Technical/Email/Alias in order to create business requirements directly from email received at a specific address.

Email Alias setup

You can start conversation with the followers in the chatter area of the BR like in tasks, issue or CRM leads.


Default numbering format: BR123456.

You can modify the default numbering sequence in Settings/Technical/Sequences&Identifier/Sequences.

Search for Business Requirement sequence and alter it if necessary.


You can create and assign tags for your business requirements in Business Requirements/Configuration/Bus. Req. Category.

Define Tags

Master project

You can define a master project linked to the business requirement.

Followers from the project will automatically be added to the business requirements.


Simple BR

  1. Define the header information

    • Master Project (Partner is the one related to the master project)
    • Priority (low, Medium, High)
    • Change request: Is it a change request? (currently only informational with n model or action)
    • Tags: any relevant tag for the business.
    • Owner and approver by default
    Input header information
  2. Input the customer story, scenario gap and test case(simple html editor with image and text)

    Input customer story, scenario, gap and test case
  3. Confirm the Business requirement (for BR User and Manager) At that stage the Customer story/Scenario/Gap/Test case is not modifiable anymore

    Confirm your business requirement
  4. Approve the Business requirement (for BR Manager)

    Confirm your business requirement
  5. Once your requirement is finished and delivered you can set it as Done

    Confirm your business requirement
  6. Alternatively, you can cancel the BR (in case it is not relevant or mistake) or drop it (when customer makes the decision to discontinue it)

    Cancel your business requirement
    Drop your business requirement

Sub-business requirements

User can create sub business requirements for a given BR for complex cases.

This is a simple parent/child relation (see roadmap).

Try me on Runbot

Known issues / Roadmap

  • Multi-company management
  • Full change request management
  • Analytic account management
  • Complex relationship management
  • Integration with earned-value module.
  • Improve the followers details (eg: depending on the stages)

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback.




Odoo Community Association

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

To contribute to this module, please visit

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page