Add CIC management platform spec.

- Add system overview.
- Add user stories.

spec/018_Mgmt Platform Spec.md

@@ -1,11 +1,11 @@
-# CIC Managment Platform Spec
+# CIC Management Platform Spec
 
-This document describes the components and steps involved to deploy a CIC token to the network.
+This document describes the components and steps involved to create a CIC management platform.
 
 ## TAGS
 
 1. Functions
-   1. Pin Reset Eventually Social -> Mgmt. USSD/Wallet Social Pin Reset (set friend(s) as guarentoors)
+   1. Pin Reset Eventually Social -> Mgmt. USSD/Wallet Social Pin Reset (set friend(s) as guarantors)
    1. Delete / Cancel users
    1. Create new users
    1. Change user details, roles (group), locations, default tokens, auto-conversion
@@ -14,7 +14,7 @@ This document describes the components and steps involved to deploy a CIC token
    1. View transaction details (clickable / searchable) lists / dashboard
    1. Assigning admins/viewers ....  permissions roles, phone support / super admin ...  (see spec)
    1. Mpesa integration - Currently USSD + Worker (API)
-   1. Donor integration (Donor interaces)
+   1. Donor integration (Donor interfaces)
    1. Hide PII data from Viewers - In general data protection
    
 
@@ -22,14 +22,40 @@ This document describes the components and steps involved to deploy a CIC token
 
 ## RATIONALE
 
-
+Enable the management and customer support personnel of the CIC platform to track platform usage by end users and provide troubleshooting capabilities.
-
 
 
 ## OVERVIEW
 
+The system gives the personnel various functionalities that allow them to be able to view and control the CIC ecosystem.
+They have to be involved in all parts of the user's interaction with the system in order to be able to give timely assistance.
 
+Some functionality enabled by the system are:
+* Register personnel and assign permissions.
+* View all user in the system and be able to create new users.
+* View and change user details, delete users or reset user pin.
+* Disburse and reclaim tokens from users and convert tokens on behalf of users.
+* View all transactions and individual transaction details.
 
+## USER STORIES
+
+* Register personnel - Give an interface for personnel to register or sign in if already a user.
+* Assign personnel permissions - A super admin will be able to assign permissions to other personnel based on their clearance level (Viewer | Enroller | Admin | Super Admin) pursuant to the [Platform Roles Spec](https://gitlab.com/grassrootseconomics/cic-docs/-/blob/master/spec/004_Platform_Roles.md).
+* View users - Get all users in the system and filter according to user categories.
+* View user details - View a user's details and all their transactions.
+* Create new users - Add users to the system and set user type - see [Platform Smoke Testing Spec](https://gitlab.com/grassrootseconomics/cic-docs/-/blob/master/spec/005_Platform_Smoke_Testing.md), User Types section.
+* Set user token - Create a token for Chama accounts only (requires admin privileges) or set a user's community token - see [Self Service Token Spec](https://gitlab.com/grassrootseconomics/cic-docs/-/blob/master/spec/006_Self_Service_Token.md), token creation and join token sections.
+* Change user details - Set new details for users such as roles (group), locations, default tokens, auto-conversion, e.t.c.
+* Delete users - Delete or cancel users.
+* Reset user pin - Change a user's pin on request. Eventually the user will be able to set a recovery account with which the pin can be reset from (preferably a friend or family member as a guarantor). 
+* Disburse and reclaim tokens - Disburse tokens to users on registering for the platform, referrals or meeting certain parameters and reclaiming tokens for dormant accounts - see [Platform Incentives Spec](https://gitlab.com/grassrootseconomics/cic-docs/-/blob/master/spec/001_platform_incentives.md).
+* Convert tokens - Convert a user's tokens from one community token to another on request.
+* View transactions - Get all transactions  in the system and filter according to the transaction category.
+* View transaction details - View an individual transaction, and the users who participated in the transaction.
+* Donor interface - A dashboard showing platform usage metadata such as transaction volume and user registration against time. The dashboard will contain public data only.
+* Mpesa integration - Initiate transactions from and to Mpesa allowing for minting of new tokens by adding to the reserve or redemption of tokens for local currency.
+
+   
 ### CODE
 
 ### SCHEMA