diff --git a/apps/cic-ussd/cic_ussd/account.py b/apps/cic-ussd/cic_ussd/account.py index 42e058b..91fac0c 100644 --- a/apps/cic-ussd/cic_ussd/account.py +++ b/apps/cic-ussd/cic_ussd/account.py @@ -8,12 +8,12 @@ from cic_types.processor import generate_metadata_pointer # local imports from cic_ussd.chain import Chain -from cic_ussd.db.models.user import User +from cic_ussd.db.models.account import Account from cic_ussd.metadata import blockchain_address_to_metadata_pointer from cic_ussd.redis import get_cached_data -def define_account_tx_metadata(user: User): +def define_account_tx_metadata(user: Account): # get sender metadata identifier = blockchain_address_to_metadata_pointer( blockchain_address=user.blockchain_address diff --git a/apps/cic-ussd/cic_ussd/db/migrations/default/versions/f289e8510444_.py b/apps/cic-ussd/cic_ussd/db/migrations/default/versions/f289e8510444_.py index 19fb28c..29d1e47 100644 --- a/apps/cic-ussd/cic_ussd/db/migrations/default/versions/f289e8510444_.py +++ b/apps/cic-ussd/cic_ussd/db/migrations/default/versions/f289e8510444_.py @@ -1,4 +1,4 @@ -"""Create user table +"""Create account table Revision ID: f289e8510444 Revises: @@ -17,7 +17,7 @@ depends_on = None def upgrade(): - op.create_table('user', + op.create_table('account', sa.Column('id', sa.Integer(), nullable=False), sa.Column('blockchain_address', sa.String(), nullable=False), sa.Column('phone_number', sa.String(), nullable=False), @@ -29,11 +29,11 @@ def upgrade(): sa.Column('updated', sa.DateTime(), nullable=False), sa.PrimaryKeyConstraint('id') ) - op.create_index(op.f('ix_user_phone_number'), 'user', ['phone_number'], unique=True) - op.create_index(op.f('ix_user_blockchain_address'), 'user', ['blockchain_address'], unique=True) + op.create_index(op.f('ix_account_phone_number'), 'account', ['phone_number'], unique=True) + op.create_index(op.f('ix_account_blockchain_address'), 'account', ['blockchain_address'], unique=True) def downgrade(): - op.drop_index(op.f('ix_user_blockchain_address'), table_name='user') - op.drop_index(op.f('ix_user_phone_number'), table_name='user') - op.drop_table('user') + op.drop_index(op.f('ix_account_blockchain_address'), table_name='account') + op.drop_index(op.f('ix_account_phone_number'), table_name='account') + op.drop_table('account') diff --git a/apps/cic-ussd/cic_ussd/db/models/user.py b/apps/cic-ussd/cic_ussd/db/models/account.py similarity index 96% rename from apps/cic-ussd/cic_ussd/db/models/user.py rename to apps/cic-ussd/cic_ussd/db/models/account.py index 56826cf..18f5e37 100644 --- a/apps/cic-ussd/cic_ussd/db/models/user.py +++ b/apps/cic-ussd/cic_ussd/db/models/account.py @@ -16,12 +16,12 @@ class AccountStatus(IntEnum): RESET = 4 -class User(SessionBase): +class Account(SessionBase): """ This class defines a user record along with functions responsible for hashing the user's corresponding password and subsequently verifying a password's validity given an input to compare against the persisted hash. """ - __tablename__ = 'user' + __tablename__ = 'account' blockchain_address = Column(String) phone_number = Column(String) @@ -38,7 +38,7 @@ class User(SessionBase): self.account_status = AccountStatus.PENDING.value def __repr__(self): - return f'' + return f'' def create_password(self, password): """This method takes a password value and hashes the value before assigning it to the corresponding diff --git a/apps/cic-ussd/cic_ussd/operations.py b/apps/cic-ussd/cic_ussd/operations.py index b7b7e0e..5e7eeca 100644 --- a/apps/cic-ussd/cic_ussd/operations.py +++ b/apps/cic-ussd/cic_ussd/operations.py @@ -10,7 +10,7 @@ from tinydb.table import Document from typing import Optional # local imports -from cic_ussd.db.models.user import User +from cic_ussd.db.models.account import Account from cic_ussd.db.models.ussd_session import UssdSession from cic_ussd.db.models.task_tracker import TaskTracker from cic_ussd.menu.ussd_menu import UssdMenu @@ -143,10 +143,10 @@ def get_account_status(phone_number) -> str: :return: The user account status. :rtype: str """ - user = User.session.query(User).filter_by(phone_number=phone_number).first() + user = Account.session.query(Account).filter_by(phone_number=phone_number).first() status = user.get_account_status() - User.session.add(user) - User.session.commit() + Account.session.add(user) + Account.session.commit() return status @@ -269,12 +269,12 @@ def cache_account_creation_task_id(phone_number: str, task_id: str): redis_cache.persist(name=task_id) -def process_current_menu(ussd_session: Optional[dict], user: User, user_input: str) -> Document: +def process_current_menu(ussd_session: Optional[dict], user: Account, user_input: str) -> Document: """This function checks user input and returns a corresponding ussd menu :param ussd_session: An in db ussd session object. :type ussd_session: UssdSession :param user: A user object. - :type user: User + :type user: Account :param user_input: The user's input. :type user_input: str :return: An in memory ussd menu object. @@ -324,7 +324,7 @@ def process_menu_interaction_requests(chain_str: str, else: # get user - user = User.session.query(User).filter_by(phone_number=phone_number).first() + user = Account.session.query(Account).filter_by(phone_number=phone_number).first() # find any existing ussd session existing_ussd_session = UssdSession.session.query(UssdSession).filter_by( @@ -390,10 +390,10 @@ def reset_pin(phone_number: str) -> str: :return: The status of the pin reset. :rtype: str """ - user = User.session.query(User).filter_by(phone_number=phone_number).first() + user = Account.session.query(Account).filter_by(phone_number=phone_number).first() user.reset_account_pin() - User.session.add(user) - User.session.commit() + Account.session.add(user) + Account.session.commit() response = f'Pin reset for user {phone_number} is successful!' return response diff --git a/apps/cic-ussd/cic_ussd/phone_number.py b/apps/cic-ussd/cic_ussd/phone_number.py index 0764ba8..0a48b0d 100644 --- a/apps/cic-ussd/cic_ussd/phone_number.py +++ b/apps/cic-ussd/cic_ussd/phone_number.py @@ -5,7 +5,7 @@ from typing import Optional import phonenumbers # local imports -from cic_ussd.db.models.user import User +from cic_ussd.db.models.account import Account def process_phone_number(phone_number: str, region: str): @@ -30,14 +30,14 @@ def process_phone_number(phone_number: str, region: str): return parsed_phone_number -def get_user_by_phone_number(phone_number: str) -> Optional[User]: +def get_user_by_phone_number(phone_number: str) -> Optional[Account]: """This function queries the database for a user based on the provided phone number. :param phone_number: A valid phone number. :type phone_number: str :return: A user object matching a given phone number - :rtype: User|None + :rtype: Account|None """ # consider adding region to user's metadata phone_number = process_phone_number(phone_number=phone_number, region='KE') - user = User.session.query(User).filter_by(phone_number=phone_number).first() + user = Account.session.query(Account).filter_by(phone_number=phone_number).first() return user diff --git a/apps/cic-ussd/cic_ussd/processor.py b/apps/cic-ussd/cic_ussd/processor.py index 061e9fb..c977f77 100644 --- a/apps/cic-ussd/cic_ussd/processor.py +++ b/apps/cic-ussd/cic_ussd/processor.py @@ -13,7 +13,7 @@ from tinydb.table import Document from cic_ussd.account import define_account_tx_metadata, retrieve_account_statement from cic_ussd.balance import BalanceManager, compute_operational_balance, get_cached_operational_balance from cic_ussd.chain import Chain -from cic_ussd.db.models.user import AccountStatus, User +from cic_ussd.db.models.account import AccountStatus, Account from cic_ussd.db.models.ussd_session import UssdSession from cic_ussd.error import MetadataNotFoundError from cic_ussd.menu.ussd_menu import UssdMenu @@ -28,13 +28,13 @@ from cic_types.models.person import generate_metadata_pointer, get_contact_data_ logg = logging.getLogger(__name__) -def process_pin_authorization(display_key: str, user: User, **kwargs) -> str: +def process_pin_authorization(display_key: str, user: Account, **kwargs) -> str: """ This method provides translation for all ussd menu entries that follow the pin authorization pattern. :param display_key: The path in the translation files defining an appropriate ussd response :type display_key: str :param user: The user in a running USSD session. - :type user: User + :type user: Account :param kwargs: Any additional information required by the text values in the internationalization files. :type kwargs :return: A string value corresponding the ussd menu's text value. @@ -55,13 +55,13 @@ def process_pin_authorization(display_key: str, user: User, **kwargs) -> str: ) -def process_exit_insufficient_balance(display_key: str, user: User, ussd_session: dict): +def process_exit_insufficient_balance(display_key: str, user: Account, ussd_session: dict): """This function processes the exit menu letting users their account balance is insufficient to perform a specific transaction. :param display_key: The path in the translation files defining an appropriate ussd response :type display_key: str :param user: The user requesting access to the ussd menu. - :type user: User + :type user: Account :param ussd_session: A JSON serialized in-memory ussd session object :type ussd_session: dict :return: Corresponding translation text response @@ -90,12 +90,12 @@ def process_exit_insufficient_balance(display_key: str, user: User, ussd_session ) -def process_exit_successful_transaction(display_key: str, user: User, ussd_session: dict): +def process_exit_successful_transaction(display_key: str, user: Account, ussd_session: dict): """This function processes the exit menu after a successful initiation for a transfer of tokens. :param display_key: The path in the translation files defining an appropriate ussd response :type display_key: str :param user: The user requesting access to the ussd menu. - :type user: User + :type user: Account :param ussd_session: A JSON serialized in-memory ussd session object :type ussd_session: dict :return: Corresponding translation text response @@ -118,11 +118,11 @@ def process_exit_successful_transaction(display_key: str, user: User, ussd_sessi ) -def process_transaction_pin_authorization(user: User, display_key: str, ussd_session: dict): +def process_transaction_pin_authorization(user: Account, display_key: str, ussd_session: dict): """This function processes pin authorization where making a transaction is concerned. It constructs a pre-transaction response menu that shows the details of the transaction. :param user: The user requesting access to the ussd menu. - :type user: User + :type user: Account :param display_key: The path in the translation files defining an appropriate ussd response :type display_key: str :param ussd_session: The USSD session determining what user data needs to be extracted and added to the menu's @@ -151,7 +151,7 @@ def process_transaction_pin_authorization(user: User, display_key: str, ussd_ses ) -def process_account_balances(user: User, display_key: str, ussd_session: dict): +def process_account_balances(user: Account, display_key: str, ussd_session: dict): """ :param user: :type user: @@ -205,7 +205,7 @@ def format_transactions(transactions: list, preferred_language: str): return formatted_transactions -def process_display_user_metadata(user: User, display_key: str): +def process_display_user_metadata(user: Account, display_key: str): """ :param user: :type user: @@ -238,7 +238,7 @@ def process_display_user_metadata(user: User, display_key: str): raise MetadataNotFoundError(f'Expected person metadata but found none in cache for key: {key}') -def process_account_statement(user: User, display_key: str, ussd_session: dict): +def process_account_statement(user: Account, display_key: str, ussd_session: dict): """ :param user: :type user: @@ -301,12 +301,12 @@ def process_account_statement(user: User, display_key: str, ussd_session: dict): ) -def process_start_menu(display_key: str, user: User): +def process_start_menu(display_key: str, user: Account): """This function gets data on an account's balance and token in order to append it to the start of the start menu's title. It passes said arguments to the translation function and returns the appropriate corresponding text from the translation files. :param user: The user requesting access to the ussd menu. - :type user: User + :type user: Account :param display_key: The path in the translation files defining an appropriate ussd response :type display_key: str :return: Corresponding translation text response @@ -361,13 +361,13 @@ def retrieve_most_recent_ussd_session(phone_number: str) -> UssdSession: return last_ussd_session -def process_request(user_input: str, user: User, ussd_session: Optional[dict] = None) -> Document: +def process_request(user_input: str, user: Account, ussd_session: Optional[dict] = None) -> Document: """This function assesses a request based on the user from the request comes, the session_id and the user's input. It determines whether the request translates to a return to an existing session by checking whether the provided session id exists in the database or whether the creation of a new ussd session object is warranted. It then returns the appropriate ussd menu text values. :param user: The user requesting access to the ussd menu. - :type user: User + :type user: Account :param user_input: The value a user enters in the ussd menu. :type user_input: str :param ussd_session: A JSON serialized in-memory ussd session object @@ -415,14 +415,14 @@ def process_request(user_input: str, user: User, ussd_session: Optional[dict] = return UssdMenu.find_by_name(name='initial_pin_entry') -def next_state(ussd_session: dict, user: User, user_input: str) -> str: +def next_state(ussd_session: dict, user: Account, user_input: str) -> str: """This function navigates the state machine based on the ussd session object and user inputs it receives. It checks the user input and provides the successive state in the state machine. It then updates the session's state attribute with the new state. :param ussd_session: A JSON serialized in-memory ussd session object :type ussd_session: dict :param user: The user requesting access to the ussd menu. - :type user: User + :type user: Account :param user_input: The value a user enters in the ussd menu. :type user_input: str :return: A string value corresponding the successive give a specific state in the state machine. @@ -438,7 +438,7 @@ def custom_display_text( display_key: str, menu_name: str, ussd_session: dict, - user: User) -> str: + user: Account) -> str: """This function extracts the appropriate session data based on the current menu name. It then inserts them as keywords in the i18n function. :param display_key: The path in the translation files defining an appropriate ussd response @@ -446,7 +446,7 @@ def custom_display_text( :param menu_name: The name by which a specific menu can be identified. :type menu_name: str :param user: The user in a running USSD session. - :type user: User + :type user: Account :param ussd_session: A JSON serialized in-memory ussd session object :type ussd_session: dict :return: A string value corresponding the ussd menu's text value. diff --git a/apps/cic-ussd/cic_ussd/requests.py b/apps/cic-ussd/cic_ussd/requests.py index 887dff3..8d436f4 100644 --- a/apps/cic-ussd/cic_ussd/requests.py +++ b/apps/cic-ussd/cic_ussd/requests.py @@ -10,7 +10,7 @@ from urllib.parse import urlparse, parse_qs from sqlalchemy import desc # local imports -from cic_ussd.db.models.user import AccountStatus, User +from cic_ussd.db.models.account import AccountStatus, Account from cic_ussd.operations import get_account_status, reset_pin from cic_ussd.validator import check_known_user @@ -123,9 +123,9 @@ def process_locked_accounts_requests(env: dict) -> tuple: else: limit = r[1] - locked_accounts = User.session.query(User.blockchain_address).filter( - User.account_status == AccountStatus.LOCKED.value, - User.failed_pin_attempts >= 3).order_by(desc(User.updated)).offset(offset).limit(limit).all() + locked_accounts = Account.session.query(Account.blockchain_address).filter( + Account.account_status == AccountStatus.LOCKED.value, + Account.failed_pin_attempts >= 3).order_by(desc(Account.updated)).offset(offset).limit(limit).all() # convert lists to scalar blockchain addresses locked_accounts = [blockchain_address for (blockchain_address, ) in locked_accounts] diff --git a/apps/cic-ussd/cic_ussd/state_machine/logic/balance.py b/apps/cic-ussd/cic_ussd/state_machine/logic/balance.py index 749841c..899ff34 100644 --- a/apps/cic-ussd/cic_ussd/state_machine/logic/balance.py +++ b/apps/cic-ussd/cic_ussd/state_machine/logic/balance.py @@ -5,12 +5,12 @@ from typing import Tuple # third-party imports # local imports -from cic_ussd.db.models.user import User +from cic_ussd.db.models.account import Account logg = logging.getLogger(__file__) -def process_mini_statement_request(state_machine_data: Tuple[str, dict, User]): +def process_mini_statement_request(state_machine_data: Tuple[str, dict, Account]): """This function compiles a brief statement of a user's last three inbound and outbound transactions and send the same as a message on their selected avenue for notification. :param state_machine_data: A tuple containing user input, a ussd session and user object. diff --git a/apps/cic-ussd/cic_ussd/state_machine/logic/menu.py b/apps/cic-ussd/cic_ussd/state_machine/logic/menu.py index d8d4492..c7239ab 100644 --- a/apps/cic-ussd/cic_ussd/state_machine/logic/menu.py +++ b/apps/cic-ussd/cic_ussd/state_machine/logic/menu.py @@ -6,10 +6,10 @@ ussd menu facilitating the return of appropriate menu responses based on said us from typing import Tuple # local imports -from cic_ussd.db.models.user import User +from cic_ussd.db.models.account import Account -def menu_one_selected(state_machine_data: Tuple[str, dict, User]) -> bool: +def menu_one_selected(state_machine_data: Tuple[str, dict, Account]) -> bool: """This function checks that user input matches a string with value '1' :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: str @@ -20,7 +20,7 @@ def menu_one_selected(state_machine_data: Tuple[str, dict, User]) -> bool: return user_input == '1' -def menu_two_selected(state_machine_data: Tuple[str, dict, User]) -> bool: +def menu_two_selected(state_machine_data: Tuple[str, dict, Account]) -> bool: """This function checks that user input matches a string with value '2' :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: tuple @@ -31,7 +31,7 @@ def menu_two_selected(state_machine_data: Tuple[str, dict, User]) -> bool: return user_input == '2' -def menu_three_selected(state_machine_data: Tuple[str, dict, User]) -> bool: +def menu_three_selected(state_machine_data: Tuple[str, dict, Account]) -> bool: """This function checks that user input matches a string with value '3' :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: tuple @@ -42,7 +42,7 @@ def menu_three_selected(state_machine_data: Tuple[str, dict, User]) -> bool: return user_input == '3' -def menu_four_selected(state_machine_data: Tuple[str, dict, User]) -> bool: +def menu_four_selected(state_machine_data: Tuple[str, dict, Account]) -> bool: """ This function checks that user input matches a string with value '4' :param state_machine_data: A tuple containing user input, a ussd session and user object. @@ -54,7 +54,7 @@ def menu_four_selected(state_machine_data: Tuple[str, dict, User]) -> bool: return user_input == '4' -def menu_five_selected(state_machine_data: Tuple[str, dict, User]) -> bool: +def menu_five_selected(state_machine_data: Tuple[str, dict, Account]) -> bool: """ This function checks that user input matches a string with value '5' :param state_machine_data: A tuple containing user input, a ussd session and user object. @@ -66,7 +66,7 @@ def menu_five_selected(state_machine_data: Tuple[str, dict, User]) -> bool: return user_input == '5' -def menu_zero_zero_selected(state_machine_data: Tuple[str, dict, User]) -> bool: +def menu_zero_zero_selected(state_machine_data: Tuple[str, dict, Account]) -> bool: """ This function checks that user input matches a string with value '00' :param state_machine_data: A tuple containing user input, a ussd session and user object. @@ -78,7 +78,7 @@ def menu_zero_zero_selected(state_machine_data: Tuple[str, dict, User]) -> bool: return user_input == '00' -def menu_ninety_nine_selected(state_machine_data: Tuple[str, dict, User]) -> bool: +def menu_ninety_nine_selected(state_machine_data: Tuple[str, dict, Account]) -> bool: """ This function checks that user input matches a string with value '99' :param state_machine_data: A tuple containing user input, a ussd session and user object. diff --git a/apps/cic-ussd/cic_ussd/state_machine/logic/pin.py b/apps/cic-ussd/cic_ussd/state_machine/logic/pin.py index 98174b9..3577699 100644 --- a/apps/cic-ussd/cic_ussd/state_machine/logic/pin.py +++ b/apps/cic-ussd/cic_ussd/state_machine/logic/pin.py @@ -12,7 +12,7 @@ from typing import Tuple import bcrypt # local imports -from cic_ussd.db.models.user import AccountStatus, User +from cic_ussd.db.models.account import AccountStatus, Account from cic_ussd.encoder import PasswordEncoder, create_password_hash from cic_ussd.operations import persist_session_to_db_task, create_or_update_session from cic_ussd.redis import InMemoryStore @@ -21,7 +21,7 @@ from cic_ussd.redis import InMemoryStore logg = logging.getLogger(__file__) -def is_valid_pin(state_machine_data: Tuple[str, dict, User]) -> bool: +def is_valid_pin(state_machine_data: Tuple[str, dict, Account]) -> bool: """This function checks a pin's validity by ensuring it has a length of for characters and the characters are numeric. :param state_machine_data: A tuple containing user input, a ussd session and user object. @@ -37,7 +37,7 @@ def is_valid_pin(state_machine_data: Tuple[str, dict, User]) -> bool: return pin_is_valid -def is_authorized_pin(state_machine_data: Tuple[str, dict, User]) -> bool: +def is_authorized_pin(state_machine_data: Tuple[str, dict, Account]) -> bool: """This function checks whether the user input confirming a specific pin matches the initial pin entered. :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: tuple @@ -48,7 +48,7 @@ def is_authorized_pin(state_machine_data: Tuple[str, dict, User]) -> bool: return user.verify_password(password=user_input) -def is_locked_account(state_machine_data: Tuple[str, dict, User]) -> bool: +def is_locked_account(state_machine_data: Tuple[str, dict, Account]) -> bool: """This function checks whether a user's account is locked due to too many failed attempts. :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: tuple @@ -59,7 +59,7 @@ def is_locked_account(state_machine_data: Tuple[str, dict, User]) -> bool: return user.get_account_status() == AccountStatus.LOCKED.name -def save_initial_pin_to_session_data(state_machine_data: Tuple[str, dict, User]): +def save_initial_pin_to_session_data(state_machine_data: Tuple[str, dict, Account]): """This function hashes a pin and stores it in session data. :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: tuple @@ -94,7 +94,7 @@ def save_initial_pin_to_session_data(state_machine_data: Tuple[str, dict, User]) persist_session_to_db_task(external_session_id=external_session_id, queue='cic-ussd') -def pins_match(state_machine_data: Tuple[str, dict, User]) -> bool: +def pins_match(state_machine_data: Tuple[str, dict, Account]) -> bool: """This function checks whether the user input confirming a specific pin matches the initial pin entered. :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: tuple @@ -108,7 +108,7 @@ def pins_match(state_machine_data: Tuple[str, dict, User]) -> bool: return bcrypt.checkpw(user_input.encode(), initial_pin) -def complete_pin_change(state_machine_data: Tuple[str, dict, User]): +def complete_pin_change(state_machine_data: Tuple[str, dict, Account]): """This function persists the user's pin to the database :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: tuple @@ -116,11 +116,11 @@ def complete_pin_change(state_machine_data: Tuple[str, dict, User]): user_input, ussd_session, user = state_machine_data password_hash = ussd_session.get('session_data').get('initial_pin') user.password_hash = password_hash - User.session.add(user) - User.session.commit() + Account.session.add(user) + Account.session.commit() -def is_blocked_pin(state_machine_data: Tuple[str, dict, User]) -> bool: +def is_blocked_pin(state_machine_data: Tuple[str, dict, Account]) -> bool: """This function checks whether the user input confirming a specific pin matches the initial pin entered. :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: tuple @@ -131,7 +131,7 @@ def is_blocked_pin(state_machine_data: Tuple[str, dict, User]) -> bool: return user.get_account_status() == AccountStatus.LOCKED.name -def is_valid_new_pin(state_machine_data: Tuple[str, dict, User]) -> bool: +def is_valid_new_pin(state_machine_data: Tuple[str, dict, Account]) -> bool: """This function checks whether the user's new pin is a valid pin and that it isn't the same as the old one. :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: tuple diff --git a/apps/cic-ussd/cic_ussd/state_machine/logic/sms.py b/apps/cic-ussd/cic_ussd/state_machine/logic/sms.py index 8447958..517c09e 100644 --- a/apps/cic-ussd/cic_ussd/state_machine/logic/sms.py +++ b/apps/cic-ussd/cic_ussd/state_machine/logic/sms.py @@ -3,21 +3,21 @@ import logging from typing import Tuple # local imports -from cic_ussd.db.models.user import User +from cic_ussd.db.models.account import Account logg = logging.getLogger() -def send_terms_to_user_if_required(state_machine_data: Tuple[str, dict, User]): +def send_terms_to_user_if_required(state_machine_data: Tuple[str, dict, Account]): user_input, ussd_session, user = state_machine_data logg.debug('Requires integration to cic-notify.') -def process_mini_statement_request(state_machine_data: Tuple[str, dict, User]): +def process_mini_statement_request(state_machine_data: Tuple[str, dict, Account]): user_input, ussd_session, user = state_machine_data logg.debug('Requires integration to cic-notify.') -def upsell_unregistered_recipient(state_machine_data: Tuple[str, dict, User]): +def upsell_unregistered_recipient(state_machine_data: Tuple[str, dict, Account]): user_input, ussd_session, user = state_machine_data logg.debug('Requires integration to cic-notify.') \ No newline at end of file diff --git a/apps/cic-ussd/cic_ussd/state_machine/logic/transaction.py b/apps/cic-ussd/cic_ussd/state_machine/logic/transaction.py index 7a006a7..ff56327 100644 --- a/apps/cic-ussd/cic_ussd/state_machine/logic/transaction.py +++ b/apps/cic-ussd/cic_ussd/state_machine/logic/transaction.py @@ -9,7 +9,7 @@ import celery # local imports from cic_ussd.balance import BalanceManager, compute_operational_balance from cic_ussd.chain import Chain -from cic_ussd.db.models.user import AccountStatus, User +from cic_ussd.db.models.account import AccountStatus, Account from cic_ussd.operations import save_to_in_memory_ussd_session_data from cic_ussd.phone_number import get_user_by_phone_number from cic_ussd.redis import create_cached_data_key, get_cached_data @@ -19,7 +19,7 @@ from cic_ussd.transactions import OutgoingTransactionProcessor logg = logging.getLogger(__file__) -def is_valid_recipient(state_machine_data: Tuple[str, dict, User]) -> bool: +def is_valid_recipient(state_machine_data: Tuple[str, dict, Account]) -> bool: """This function checks that a user exists, is not the initiator of the transaction, has an active account status and is authorized to perform standard transactions. :param state_machine_data: A tuple containing user input, a ussd session and user object. @@ -34,7 +34,7 @@ def is_valid_recipient(state_machine_data: Tuple[str, dict, User]) -> bool: return is_not_initiator and has_active_account_status and recipient is not None -def is_valid_transaction_amount(state_machine_data: Tuple[str, dict, User]) -> bool: +def is_valid_transaction_amount(state_machine_data: Tuple[str, dict, Account]) -> bool: """This function checks that the transaction amount provided is valid as per the criteria for the transaction being attempted. :param state_machine_data: A tuple containing user input, a ussd session and user object. @@ -49,7 +49,7 @@ def is_valid_transaction_amount(state_machine_data: Tuple[str, dict, User]) -> b return False -def has_sufficient_balance(state_machine_data: Tuple[str, dict, User]) -> bool: +def has_sufficient_balance(state_machine_data: Tuple[str, dict, Account]) -> bool: """This function checks that the transaction amount provided is valid as per the criteria for the transaction being attempted. :param state_machine_data: A tuple containing user input, a ussd session and user object. @@ -72,7 +72,7 @@ def has_sufficient_balance(state_machine_data: Tuple[str, dict, User]) -> bool: return int(user_input) <= operational_balance -def save_recipient_phone_to_session_data(state_machine_data: Tuple[str, dict, User]): +def save_recipient_phone_to_session_data(state_machine_data: Tuple[str, dict, Account]): """This function saves the phone number corresponding the intended recipients blockchain account. :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: str @@ -85,7 +85,7 @@ def save_recipient_phone_to_session_data(state_machine_data: Tuple[str, dict, Us save_to_in_memory_ussd_session_data(queue='cic-ussd', session_data=session_data, ussd_session=ussd_session) -def retrieve_recipient_metadata(state_machine_data: Tuple[str, dict, User]): +def retrieve_recipient_metadata(state_machine_data: Tuple[str, dict, Account]): """ :param state_machine_data: :type state_machine_data: @@ -104,7 +104,7 @@ def retrieve_recipient_metadata(state_machine_data: Tuple[str, dict, User]): s_query_person_metadata.apply_async(queue='cic-ussd') -def save_transaction_amount_to_session_data(state_machine_data: Tuple[str, dict, User]): +def save_transaction_amount_to_session_data(state_machine_data: Tuple[str, dict, Account]): """This function saves the phone number corresponding the intended recipients blockchain account. :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: str @@ -117,7 +117,7 @@ def save_transaction_amount_to_session_data(state_machine_data: Tuple[str, dict, save_to_in_memory_ussd_session_data(queue='cic-ussd', session_data=session_data, ussd_session=ussd_session) -def process_transaction_request(state_machine_data: Tuple[str, dict, User]): +def process_transaction_request(state_machine_data: Tuple[str, dict, Account]): """This function saves the phone number corresponding the intended recipients blockchain account. :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: str diff --git a/apps/cic-ussd/cic_ussd/state_machine/logic/user.py b/apps/cic-ussd/cic_ussd/state_machine/logic/user.py index fd53904..e8b8e44 100644 --- a/apps/cic-ussd/cic_ussd/state_machine/logic/user.py +++ b/apps/cic-ussd/cic_ussd/state_machine/logic/user.py @@ -10,7 +10,7 @@ from cic_types.models.person import generate_vcard_from_contact_data, manage_ide # local imports from cic_ussd.chain import Chain -from cic_ussd.db.models.user import User +from cic_ussd.db.models.account import Account from cic_ussd.error import MetadataNotFoundError from cic_ussd.metadata import blockchain_address_to_metadata_pointer from cic_ussd.operations import save_to_in_memory_ussd_session_data @@ -19,40 +19,40 @@ from cic_ussd.redis import get_cached_data logg = logging.getLogger(__file__) -def change_preferred_language_to_en(state_machine_data: Tuple[str, dict, User]): +def change_preferred_language_to_en(state_machine_data: Tuple[str, dict, Account]): """This function changes the user's preferred language to english. :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: tuple """ user_input, ussd_session, user = state_machine_data user.preferred_language = 'en' - User.session.add(user) - User.session.commit() + Account.session.add(user) + Account.session.commit() -def change_preferred_language_to_sw(state_machine_data: Tuple[str, dict, User]): +def change_preferred_language_to_sw(state_machine_data: Tuple[str, dict, Account]): """This function changes the user's preferred language to swahili. :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: tuple """ user_input, ussd_session, user = state_machine_data user.preferred_language = 'sw' - User.session.add(user) - User.session.commit() + Account.session.add(user) + Account.session.commit() -def update_account_status_to_active(state_machine_data: Tuple[str, dict, User]): +def update_account_status_to_active(state_machine_data: Tuple[str, dict, Account]): """This function sets user's account to active. :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: tuple """ user_input, ussd_session, user = state_machine_data user.activate_account() - User.session.add(user) - User.session.commit() + Account.session.add(user) + Account.session.commit() -def process_gender_user_input(user: User, user_input: str): +def process_gender_user_input(user: Account, user_input: str): """ :param user: :type user: @@ -74,7 +74,7 @@ def process_gender_user_input(user: User, user_input: str): return gender -def save_metadata_attribute_to_session_data(state_machine_data: Tuple[str, dict, User]): +def save_metadata_attribute_to_session_data(state_machine_data: Tuple[str, dict, Account]): """This function saves first name data to the ussd session in the redis cache. :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: tuple @@ -109,7 +109,7 @@ def save_metadata_attribute_to_session_data(state_machine_data: Tuple[str, dict, save_to_in_memory_ussd_session_data(queue='cic-ussd', session_data=session_data, ussd_session=ussd_session) -def format_user_metadata(metadata: dict, user: User): +def format_user_metadata(metadata: dict, user: Account): """ :param metadata: :type metadata: @@ -150,7 +150,7 @@ def format_user_metadata(metadata: dict, user: User): } -def save_complete_user_metadata(state_machine_data: Tuple[str, dict, User]): +def save_complete_user_metadata(state_machine_data: Tuple[str, dict, Account]): """This function persists elements of the user metadata stored in session data :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: tuple @@ -171,7 +171,7 @@ def save_complete_user_metadata(state_machine_data: Tuple[str, dict, User]): s_create_person_metadata.apply_async(queue='cic-ussd') -def edit_user_metadata_attribute(state_machine_data: Tuple[str, dict, User]): +def edit_user_metadata_attribute(state_machine_data: Tuple[str, dict, Account]): user_input, ussd_session, user = state_machine_data blockchain_address = user.blockchain_address key = generate_metadata_pointer( @@ -218,7 +218,7 @@ def edit_user_metadata_attribute(state_machine_data: Tuple[str, dict, User]): s_edit_person_metadata.apply_async(queue='cic-ussd') -def get_user_metadata(state_machine_data: Tuple[str, dict, User]): +def get_user_metadata(state_machine_data: Tuple[str, dict, Account]): user_input, ussd_session, user = state_machine_data blockchain_address = user.blockchain_address s_get_user_metadata = celery.signature( diff --git a/apps/cic-ussd/cic_ussd/state_machine/logic/validator.py b/apps/cic-ussd/cic_ussd/state_machine/logic/validator.py index ffae027..36cce59 100644 --- a/apps/cic-ussd/cic_ussd/state_machine/logic/validator.py +++ b/apps/cic-ussd/cic_ussd/state_machine/logic/validator.py @@ -7,14 +7,14 @@ from typing import Tuple from cic_types.models.person import generate_metadata_pointer # local imports -from cic_ussd.db.models.user import User +from cic_ussd.db.models.account import Account from cic_ussd.metadata import blockchain_address_to_metadata_pointer from cic_ussd.redis import get_cached_data logg = logging.getLogger() -def has_cached_user_metadata(state_machine_data: Tuple[str, dict, User]): +def has_cached_user_metadata(state_machine_data: Tuple[str, dict, Account]): """This function checks whether the attributes of the user's metadata constituting a profile are filled out. :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: str @@ -29,7 +29,7 @@ def has_cached_user_metadata(state_machine_data: Tuple[str, dict, User]): return user_metadata is not None -def is_valid_name(state_machine_data: Tuple[str, dict, User]): +def is_valid_name(state_machine_data: Tuple[str, dict, Account]): """This function checks that a user provided name is valid :param state_machine_data: A tuple containing user input, a ussd session and user object. :type state_machine_data: str @@ -43,7 +43,7 @@ def is_valid_name(state_machine_data: Tuple[str, dict, User]): return False -def is_valid_gender_selection(state_machine_data: Tuple[str, dict, User]): +def is_valid_gender_selection(state_machine_data: Tuple[str, dict, Account]): """ :param state_machine_data: :type state_machine_data: diff --git a/apps/cic-ussd/cic_ussd/state_machine/state_machine.py b/apps/cic-ussd/cic_ussd/state_machine/state_machine.py index f5ba52e..d817804 100644 --- a/apps/cic-ussd/cic_ussd/state_machine/state_machine.py +++ b/apps/cic-ussd/cic_ussd/state_machine/state_machine.py @@ -13,7 +13,7 @@ class UssdStateMachine(Machine): """This class describes a finite state machine responsible for maintaining all the states that describe the ussd menu as well as providing a means for navigating through these states based on different user inputs. It defines different helper functions that co-ordinate with the stakeholder components of the ussd menu: i.e the - User, UssdSession, UssdMenu to facilitate user interaction with ussd menu. + Account, UssdSession, UssdMenu to facilitate user interaction with ussd menu. :cvar states: A list of pre-defined states. :type states: list :cvar transitions: A list of pre-defined transitions. diff --git a/apps/cic-ussd/cic_ussd/tasks/callback_handler.py b/apps/cic-ussd/cic_ussd/tasks/callback_handler.py index 2f1b31f..1766565 100644 --- a/apps/cic-ussd/cic_ussd/tasks/callback_handler.py +++ b/apps/cic-ussd/cic_ussd/tasks/callback_handler.py @@ -9,7 +9,7 @@ import celery # local imports from cic_ussd.conversions import from_wei from cic_ussd.db.models.base import SessionBase -from cic_ussd.db.models.user import User +from cic_ussd.db.models.account import Account from cic_ussd.account import define_account_tx_metadata from cic_ussd.error import ActionDataNotFoundError from cic_ussd.redis import InMemoryStore, cache_data, create_cached_data_key @@ -49,7 +49,7 @@ def process_account_creation_callback(self, result: str, url: str, status_code: phone_number = account_creation_data.get('phone_number') # create user - user = User(blockchain_address=result, phone_number=phone_number) + user = Account(blockchain_address=result, phone_number=phone_number) session.add(user) session.commit() session.close() @@ -87,8 +87,8 @@ def process_incoming_transfer_callback(result: dict, param: str, status_code: in value = result.get('destination_token_value') # try to find users in system - recipient_user = session.query(User).filter_by(blockchain_address=recipient_blockchain_address).first() - sender_user = session.query(User).filter_by(blockchain_address=sender_blockchain_address).first() + recipient_user = session.query(Account).filter_by(blockchain_address=recipient_blockchain_address).first() + sender_user = session.query(Account).filter_by(blockchain_address=sender_blockchain_address).first() # check whether recipient is in the system if not recipient_user: @@ -188,8 +188,8 @@ def process_statement_callback(result, param: str, status_code: int): processed_transaction = {} # check if sender is in the system - sender: User = session.query(User).filter_by(blockchain_address=sender_blockchain_address).first() - owner: User = session.query(User).filter_by(blockchain_address=param).first() + sender: Account = session.query(Account).filter_by(blockchain_address=sender_blockchain_address).first() + owner: Account = session.query(Account).filter_by(blockchain_address=param).first() if sender: processed_transaction['sender_phone_number'] = sender.phone_number @@ -205,7 +205,7 @@ def process_statement_callback(result, param: str, status_code: int): processed_transaction['sender_phone_number'] = 'GRASSROOTS ECONOMICS' # check if recipient is in the system - recipient: User = session.query(User).filter_by(blockchain_address=recipient_address).first() + recipient: Account = session.query(Account).filter_by(blockchain_address=recipient_address).first() if recipient: processed_transaction['recipient_phone_number'] = recipient.phone_number diff --git a/apps/cic-ussd/cic_ussd/translation.py b/apps/cic-ussd/cic_ussd/translation.py index b174650..35fd1cd 100644 --- a/apps/cic-ussd/cic_ussd/translation.py +++ b/apps/cic-ussd/cic_ussd/translation.py @@ -8,7 +8,7 @@ from typing import Optional def translation_for(key: str, preferred_language: Optional[str] = None, **kwargs) -> str: """ Translates text mapped to a specific YAML key into the user's set preferred language. - :param preferred_language: User's preferred language in which to view the ussd menu. + :param preferred_language: Account's preferred language in which to view the ussd menu. :type preferred_language str :param key: Key to a specific YAML test entry :type key: str diff --git a/apps/cic-ussd/cic_ussd/validator.py b/apps/cic-ussd/cic_ussd/validator.py index 1fc1006..8989695 100644 --- a/apps/cic-ussd/cic_ussd/validator.py +++ b/apps/cic-ussd/cic_ussd/validator.py @@ -8,7 +8,7 @@ import ipaddress from confini import Config # local imports -from cic_ussd.db.models.user import User +from cic_ussd.db.models.account import Account logg = logging.getLogger(__file__) @@ -68,7 +68,7 @@ def check_known_user(phone: str): :return: Is known phone number :rtype: boolean """ - user = User.session.query(User).filter_by(phone_number=phone).first() + user = Account.session.query(Account).filter_by(phone_number=phone).first() return user is not None diff --git a/apps/cic-ussd/cic_ussd/version.py b/apps/cic-ussd/cic_ussd/version.py index 5033279..1dfeb77 100644 --- a/apps/cic-ussd/cic_ussd/version.py +++ b/apps/cic-ussd/cic_ussd/version.py @@ -1,7 +1,7 @@ # standard imports import semver -version = (0, 3, 0, 'alpha.8') +version = (0, 3, 0, 'alpha.9') version_object = semver.VersionInfo( major=version[0], diff --git a/apps/cic-ussd/tests/cic_ussd/db/models/test_user.py b/apps/cic-ussd/tests/cic_ussd/db/models/test_user.py index f217347..24f6fc9 100644 --- a/apps/cic-ussd/tests/cic_ussd/db/models/test_user.py +++ b/apps/cic-ussd/tests/cic_ussd/db/models/test_user.py @@ -4,19 +4,19 @@ import pytest # platform imports -from cic_ussd.db.models.user import User +from cic_ussd.db.models.account import Account def test_user(init_database, set_fernet_key): - user = User(blockchain_address='0x417f5962fc52dc33ff0689659b25848680dec6dcedc6785b03d1df60fc6d5c51', - phone_number='+254700000000') + user = Account(blockchain_address='0x417f5962fc52dc33ff0689659b25848680dec6dcedc6785b03d1df60fc6d5c51', + phone_number='+254700000000') user.create_password('0000') - session = User.session + session = Account.session session.add(user) session.commit() - queried_user = session.query(User).get(1) + queried_user = session.query(Account).get(1) assert queried_user.blockchain_address == '0x417f5962fc52dc33ff0689659b25848680dec6dcedc6785b03d1df60fc6d5c51' assert queried_user.phone_number == '+254700000000' assert queried_user.failed_pin_attempts == 0 @@ -25,7 +25,7 @@ def test_user(init_database, set_fernet_key): def test_user_state_transition(create_pending_user): user = create_pending_user - session = User.session + session = Account.session assert user.get_account_status() == 'PENDING' user.activate_account() diff --git a/apps/cic-ussd/tests/cic_ussd/tasks/test_callback_handler_tasks.py b/apps/cic-ussd/tests/cic_ussd/tasks/test_callback_handler_tasks.py index 184d2ff..43df49c 100644 --- a/apps/cic-ussd/tests/cic_ussd/tasks/test_callback_handler_tasks.py +++ b/apps/cic-ussd/tests/cic_ussd/tasks/test_callback_handler_tasks.py @@ -8,7 +8,7 @@ import celery import pytest # local imports -from cic_ussd.db.models.user import User +from cic_ussd.db.models.account import Account from cic_ussd.error import ActionDataNotFoundError from cic_ussd.conversions import from_wei @@ -29,7 +29,7 @@ def test_successful_process_account_creation_callback_task(account_creation_acti # WARNING: [THE SETTING OF THE ROOT ID IS A HACK AND SHOULD BE REVIEWED OR IMPROVED] mocked_task_request.root_id = task_id - user = init_database.query(User).filter_by(phone_number=phone_number).first() + user = init_database.query(Account).filter_by(phone_number=phone_number).first() assert user is None redis_cache = init_redis_cache @@ -48,7 +48,7 @@ def test_successful_process_account_creation_callback_task(account_creation_acti ) s_process_callback_request.apply_async().get() - user = init_database.query(User).filter_by(phone_number=phone_number).first() + user = init_database.query(Account).filter_by(phone_number=phone_number).first() assert user.blockchain_address == result action_data = redis_cache.get(task_id) diff --git a/apps/cic-ussd/tests/cic_ussd/test_requests.py b/apps/cic-ussd/tests/cic_ussd/test_requests.py index ffbd9ac..93c9e93 100644 --- a/apps/cic-ussd/tests/cic_ussd/test_requests.py +++ b/apps/cic-ussd/tests/cic_ussd/test_requests.py @@ -2,7 +2,7 @@ import json # local imports -from cic_ussd.db.models.user import User +from cic_ussd.db.models.account import Account from cic_ussd.requests import (get_query_parameters, get_request_endpoint, get_request_method, @@ -58,8 +58,8 @@ def test_process_locked_accounts_requests(create_locked_accounts, valid_locked_a assert len(locked_account_addresses) == 10 # check that blockchain addresses are ordered by most recently accessed - user_1 = User.session.query(User).filter_by(blockchain_address=locked_account_addresses[2]).first() - user_2 = User.session.query(User).filter_by(blockchain_address=locked_account_addresses[7]).first() + user_1 = Account.session.query(Account).filter_by(blockchain_address=locked_account_addresses[2]).first() + user_2 = Account.session.query(Account).filter_by(blockchain_address=locked_account_addresses[7]).first() assert user_1.updated > user_2.updated diff --git a/apps/cic-ussd/tests/fixtures/user.py b/apps/cic-ussd/tests/fixtures/user.py index 162078e..20dfbc2 100644 --- a/apps/cic-ussd/tests/fixtures/user.py +++ b/apps/cic-ussd/tests/fixtures/user.py @@ -9,7 +9,7 @@ from cic_types.models.person import generate_metadata_pointer from faker import Faker # local imports -from cic_ussd.db.models.user import AccountStatus, User +from cic_ussd.db.models.account import AccountStatus, Account from cic_ussd.redis import cache_data from cic_ussd.metadata import blockchain_address_to_metadata_pointer @@ -19,7 +19,7 @@ fake = Faker() @pytest.fixture(scope='function') def create_activated_user(init_database, set_fernet_key): - user = User( + user = Account( blockchain_address='0xFD9c5aD15C72C6F60f1a119A608931226674243f', phone_number='+25498765432' ) @@ -33,7 +33,7 @@ def create_activated_user(init_database, set_fernet_key): @pytest.fixture(scope='function') def create_valid_tx_recipient(init_database, set_fernet_key): - user = User( + user = Account( blockchain_address='0xd6204101012270Bf2558EDcFEd595938d1847bf0', phone_number='+25498765432' ) @@ -47,7 +47,7 @@ def create_valid_tx_recipient(init_database, set_fernet_key): @pytest.fixture(scope='function') def create_valid_tx_sender(init_database, set_fernet_key): - user = User( + user = Account( blockchain_address='0xd6204101012270Bf2558EDcFEd595938d1847bf1', phone_number='+25498765433' ) @@ -61,7 +61,7 @@ def create_valid_tx_sender(init_database, set_fernet_key): @pytest.fixture(scope='function') def create_pending_user(init_database, set_fernet_key): - user = User( + user = Account( blockchain_address='0x0ebdea8612c1b05d952c036859266c7f2cfcd6a29842d9c6cce3b9f1ba427588', phone_number='+25498765432' ) @@ -72,7 +72,7 @@ def create_pending_user(init_database, set_fernet_key): @pytest.fixture(scope='function') def create_pin_blocked_user(init_database, set_fernet_key): - user = User( + user = Account( blockchain_address='0x0ebdea8612c1b05d952c036859266c7f2cfcd6a29842d9c6cce3b9f1ba427588', phone_number='+25498765432' ) @@ -90,7 +90,7 @@ def create_locked_accounts(init_database, set_fernet_key): blockchain_address = str(uuid.uuid4()) phone_number = fake.phone_number() pin = f'{randint(1000, 9999)}' - user = User(phone_number=phone_number, blockchain_address=blockchain_address) + user = Account(phone_number=phone_number, blockchain_address=blockchain_address) user.create_password(password=pin) user.failed_pin_attempts = 3 user.account_status = AccountStatus.LOCKED.value