Skip to content

Latest commit

 

History

History
183 lines (138 loc) · 6.62 KB

README.md

File metadata and controls

183 lines (138 loc) · 6.62 KB

Ionic Notes Application

This application is a project for ITSC 3155 Software Engineering at UNC Charlotte, made by me, Ryan Hull.

Built from scratch using the Ionic Framework with Angular, and Capacitor/ Cordova Plugins.

Table of Contents

Purpose/ Goals

  • Showcase an application of the engineering process
  • Showcasing an application of the development cycle
  • Following the Agile model
  • Practicing Test Driven Development
  • Knowledge of Common Design Patterns
  • Showcase the use of current and active frameworks

Overview

  • Built using Angular.
  • Built to be a cross-platform, cloud-based notes application for use on web, android, iOS, and desktop.
  • Uses a Google Firebase, Firestore Database for the authentication and storage of users, and notes.
  • See package.json for full list of dependencies and plugins.

How to Deploy

Requirements

Steps

  1. Clone repository git clone https://github.com/HullRyan/IonicNotesApp
  2. Create Google Firebase Project and Firestore Database
  3. Create collections for users, notes. See DATABASE.md
  4. Create and place your Firebase SDK Config snippet into /src/environments/environment.ts
  5. Run npm install from root to install dependencies
  6. Run ionic serve or build to desired platform with ionic build and deploy
  7. Enjoy 📓✏️

Application Preview

Material Design iOS
Material Design iOS
iOS Register
Material Design iOS
iOS Create Note
Material Design iOS
iOS Notes List
Material Design iOS
iOS Edit Note
Material Design iOS
iOS Set Reminder
Windows
Windows Desktop Notes List

Engineering Process

Agile Methodology

Sprint 1: (4/8/2021 - 4/19/2021) ✔️

  • Plan: Local Notes and Reminders App

    • Features extracted from user stories:
      • Save/ Delete Notes
      • Set Single/ Recurring notifications
      • Clear set notifications
  • Design: Ionic Framework base application

    • Notes List page
    • Note Details/ Edit page
    • Note service
  • Development: Implement local storage for notes and reminders

    • Capacitor - Cordova plugins
    • Notes service
    • Notification service
  • Testing: Tested all functions made with built in data

    • Made notes, deleted notes, set notification, deleted notification
  • Review: Missing cross-platform functionality

    • Added user stories based on feedback
      • Needed: Responsive UI vs current Static UI
      • Needed: Cloud database for notes

Sprint 2: (4/19/2021 - 4/27/2021) ✔️

  • Plan: Cloud Notes App with Reminders
    • Features extracted from user stories:
      • Account creation/ authentication
      • Note storage in Cloud database
      • Responsive UI for cross-platform use
  • Design: Sprint 1 UI Base
    • Login/Home page
    • Register page
    • Notes List page
    • Note Details/ Edit page
  • Development: Implement Cloud functionality
    • Firestore database
    • Responsive UI with HTML and CSS styling
    • Angular authentication service
    • Update note service for use with database
    • Attached notification service to note service through notification interface
  • Testing: Testing authentication, note functions, reminders, UI
    • Tested all tests from Sprint 1
    • Tested account creation, deletion, sign in, sign out
    • Tested UI on platforms with varying sizes (Web, Android, iOS, Windows)
  • Review: Missing functionality for complex data in note, notification control and settings
    • Added user stories based on feedback
      • Needed: Color tag functionality and control
      • Needed: Advanced Text Editor in place for Note body
      • Needed: Notifications view page
      • Needed: Updated database collection and fields for search and sorting

Sprint 3: (4/27/2021 - 5/8/2021) ✔️

  • Plan: Markdown Notes App with advanced Notification Integration
    • Features extracted from user stories:
      • Markdown Editor for Note body
      • Note colors customization
  • Design: Sprint 2 UI Base
    • Login/ Home page
    • Register page
    • Notes List page
    • Note Details/ Edit Page
  • Development: Implement Quill Rich Text Editor
    • Custom toolbar for wanted features
    • Add color tag functions
    • Update notes list
  • Testing: Repeat Unit Tests
  • Review: Missing notification control and settings, note organization
    • Needed: Notifications view page
    • Needed: Updated database collection and fields for search and sorting

Testing Process

See Spec files for testing processes and functions.

Unit Testing using Karma and Jasmine
Testing