v1.6

Merge pull request #226 from rotarykirby/update-dg-1.6

Final bug fixes in DG

v1.5

Release version 1.5

OnlySales alpha

Release Notes - Version 1.4

OnlySales is the CLI-based address book for salespersons to unlock their full potential in managing their customers' contact information

With the release of OnlySales v1.4, we are focusing on fixing some bugs that slipped through the cracks in the previous version, while delivering some new features and enhancements to the existing commands to enhance versatility for your address book!

---

New Features

Copy Email Template

Users can now do the command:

template copy s:[STATUS]

For example: “template copy s:uncontacted” will paste the contents of the “Uncontacted” status email template into the user's keyboard, which can be edited or viewed from the command “template s:uncontacted”.

Enhanced Find Command

The find command has been expanded to search across multiple fields. Previously limited to searching by name, tag, and status, the find command now also supports searching by phone number and email address.

You can now search for contacts by their phone number such as by doing:

find p:12345678

Which would return the contact with the corresponding phone number.

Edit Status

The edit command now supports editing a contact's status directly.

For example: “edit 2 s: Busy” will set the status of the 2nd contact in the list to “Busy”. It has the same effect as doing “status 2 Busy”. This adjustment was made so that the user now has the option to edit the status of a contact, alongside any other changes, with a single command.

---

Bug Fixes

Improved Sidebar Visibility

Fixed issues with sidebar visibility to ensure better user experience.

Fixed Bug in Exporting Data

Previously, when using the application for the first time, exporting a contact result in an error. Now, user are able to export the data as shown by the list command.

---

Download

OnlySales v1.4 JAR File: Download here

---

Acknowledgments

OnlySales is based on the AddressBook Level 3 (AB3) project created by the SE-EDU initiative.

---

Support

Found a bug? Have a feature request?

• File a bug report: GitHub Issues

---

Happy Selling! 🎉

OnlySales Team

MVP

OnlySales v1.3 Release Notes

OnlySales is the CLI-based address book for salespersons to unlock their full potential in managing their customers' contact information

With the release of OnlySales v1.3, we are bringing powerful new features designed to streamline your contact management workflow. This release transforms the original AddressBook Level 3 (AB3) into a specialised tool tailored for sales professionals.

Quick comparison with AB3

Feature	AB3	OnlySales v1.3
Contact status	❌	✅ (6 values)
Find by status	❌	✅
Find by tag	❌	✅
Multi-delete	❌ (single only)	✅ (multiple indices)
Bulk import (JSON)	❌	✅
Bulk export (JSON)	❌	✅
Email templates	❌	✅ (status-based)

What's New in v1.3

• Contact status tracking (6 status values)
• Find by status and by tag
• Delete multiple contacts in one command
• Bulk import/export (JSON)
• Status-based email templates

---

1. Contact Status Tracking

Track the status of your customer interactions with the new Status field and command.

Status Field:

• Each contact now has a status to help you organise your sales pipeline
• Available status values:
  • Uncontacted - New leads you haven't reached out to yet
  • Contacted - Customers you've already contacted
  • Rejected - Leads that declined your offer
  • Accepted - Customers who accepted your proposal
  • Unreachable - Contacts that couldn't be reached
  • Busy - Customers who are currently unavailable

Command:

status INDEX STATUS

Examples:

• status 1 Contacted - Mark the 1st contact as contacted
• status 5 Accepted - Mark the 5th contact as accepted
• status 3 Busy - Mark the 3rd contact as busy

Screenshot:

---

2. Find Contacts by Status

Quickly filter your contact list based on their current status to focus on the right customers at the right time.

Command:

find s:STATUS

Examples:

• find s:Uncontacted - Display all leads you haven't contacted yet
• find s:Accepted - Show all customers who accepted your proposal
• find s:Busy - View all customers marked as busy

Use Cases:

• Prioritise follow-ups with uncontacted leads
• Review all accepted deals for next steps
• Identify rejected contacts for re-engagement campaigns or removal from contact list

Screenshot:

---

3. Find Contacts by Tag

Enhanced the find command to support tag-based filtering, allowing you to segment customers by categories.

Command:

find t:TAG

Examples:

• find t:VIP - Show all VIP customers
• find t:corporate - Display corporate clients
• find t:2024 - View contact leads obtained in 2024

Combined Searches:
You can combine different search criteria:

• find n:John t:VIP - Find contacts named John who are VIPs
• find s:Contacted t:corporate - Find contacted corporate clients

Screenshot:

---

4. Delete Multiple Contacts at Once

Save time by deleting multiple contacts in a single command instead of one-by-one.

Command:

delete INDEX [MORE_INDICES]...

Examples:

• delete 1 - Delete the 1st contact (single delete)
• delete 1 2 3 - Delete contacts at positions 1, 2, and 3
• delete 5 8 12 15 - Delete contacts at positions 5, 8, 12, and 15

Features:

• Validates all indices before deletion to prevent partial deletions
• Provides clear feedback showing all deleted contacts
• Automatically handles index shifting when deleting multiple contacts

Screenshot:

---

5. Import Multiple Contacts (JSON)

Bulk import contacts from a JSON file to quickly populate your contact list from external sources. Use the import command to import the content of your clipboard to your address book. Press F7 for a preview window where supported.

Command:

import

Examples:

import

Features:

• Import entire address books in JSON format
• Validates data before import to prevent corruption
• Provides detailed feedback on import success/failures

Screenshot:
CLI:

Preview Window:

---

6. Export Multiple Contacts

Bulk export contacts to JSON to quickly transfer or share your contacts. Use the export command, or press F8 to copy all the contact information to your clipboard where supported.

Command:

export

Examples:

export

Features:

• Copy entire address books in JSON format to your clipboard
• Checks for valid data before exporting
• Provides detailed feedback on export success/failures

Screenshot:

---

7. Email Template Management

Create and manage customised email templates for each contact status, streamlining your outreach workflow.

Open Template:

template s:STATUS

Save Template:

template save

Available Templates:
You can create templates for each status:

• template s:Uncontacted - Template for first-time outreach
• template s:Contacted - Follow-up template for contacted leads
• template s:Rejected - Re-engagement template for rejected leads
• template s:Accepted - Onboarding template for accepted customers
• template s:Unreachable - Alternative contact template
• template s:Busy - Rescheduling template

Workflow:

1. Open a template: template s:Uncontacted
2. Edit the template content in the template editor panel
3. Save your changes: template save
4. The template is automatically associated with the corresponding status

Features:

• Status-specific templates for targeted communication
• Templates persist across application sessions
• Default templates provided for each status
• Easy editing and saving workflow

Screenshot:
Template editing

Template saving

Changes from AB3

1. Updated Command Prefixes

We have standardised all command prefixes in OnlySales to use a colon (:) instead of a slash (/). This avoids confusion when manipulating names that contain dashes. All OnlySales command examples in this document use the new syntax.

Examples:

Command	AB3	OnlySales v1.3
Add contact	add n/Jane p/91234567 e/jane@example.com a/123 Main St	add n:Jane p:91234567 e:jane@example.com a:123 Main St
Find contact	find n/John t/VIP	find n:John t:VIP
Delete contact	delete 1	delete 1

Screenshot:
New Format:

---

2. Changes to Compulsory Field

OnlySales requires only name, phone and email when adding a contact. The address field is optional, as salespeople typically do not require addresses for most workflows.

---

Getting Started

Installation

1. Ensure you have Java 17 or above installed
2. Download the OnlySales-v1.3.jar file from the releases section below
3. Double-click the JAR file or run: java -jar OnlySales-v1.3.jar

Quick Start Guide

Try these commands in the app CLI to explore the new features:

# Add a new contact
add n:Jane Smith p:91234567 e:jane@example.com a:123 Main St

# Set their status
status 1 Uncontacted

# Create an email template for uncontacted leads
template s:Uncontacted

# Edit the template and save it
template save

# Find all uncontacted customers
find s:Uncontacted

# Mark multiple as contacted after your outreach
status 1 Contacted
status 2 Contacted

# Delete outdated contacts
delete 5 8 12

---

Download

OnlySales v1.3 JAR File: Download here

---

Documentation

For detailed documentation, please visit:

• User Guide: [Link to User Guide]
• Developer Guide: [Link to Developer Guide]

---

Acknowledgments

OnlySales is based on the AddressBook Level 3 (AB3) project created by the SE-EDU initiative.

---

Support

Found a bug? Have a feature request?

• File a bug report: GitHub Issues

---

Happy Selling! 🎉

_OnlySales T...