Teaching-CSC4521 for Dr J. Paul Gibson, INFormatique (INF), Telecom SudParis, France.

Overview

This site contains material for the module Génie logiciel pour la conception d'un Système d'Information (CSC4521), as part of the programme VAP DSI (Voie d'Approfondissement Intégration et Déploiement de Systèmes d’Information) It is complementary to the module Projet Système d'Information : réalisation et déploiement (CSC4522)

Sessions are scheduled for 3 hours. However, most sessions will be split into 3 parts, and the presentation/teaching part will usually take between 30 minutes and 90 minutes -

• I. Feedback from work completed since previous session
• II. Presentation of new material
• III. Practical work (in teams) with help from Paul

Any remote interactions will be done using bigbluebutton (Salle de cours VAP)

Evaluation

Your evaluation will be based on 4 aspects of your work:

• Requirements Model and Functional Architecture - deliverable1 - Team mark (30%)
• Physical Architecture and its coherency with the requirements - deliverable 2 - Team mark (30%)
• Review of process of architecture design - Team mark (30%)
• Engineering log/journal -Individual mark (10%)
There will also be a bonus mark (0-10%) for additional work done on the initial problems (not part of the Wavestone project work)

The final submission to Paul must be made by Friday 23rd (midnight) by email. Each team must send a team submission (just on the resuirements and architecture). Each individual must send their log/journal and any bonus work (please explicitly state if the bonus work was done in collaboration with others, and who they were).

Session 1: Wednesday 10th May (10h-13h15) B313

1.1 Introduction

• Introduction

Useful external links

• Approche Pédagogique (PBL/APP)
• Système Informatique ou Système d'Information?
• L’ASSISTANCE À MAÎTRISE D’OUVRAGE (AMOA), QU’EST-CE QUE C’EST ?
• It’s a naughty engineer who neglects his/her logbook, Clive (Max) Maxfield.
• A Work Log Template for Software Engineers, Gergely Orosz.
• Software Engineers should keep lab notebooks, Nelson Elhage, Made of Bugs.
• Note-Taking for Software Engineers -The importance of organizing your thoughts and efficiently keep them from haunting you, Eduardo Vedes.

Additional reading material

• An investigation into the use and content of the engineer's logbook, McAlpine, Hamish, et al. Design Studies 27.4 (2006): 481-504.
• pdf

1.2 Models and modelling

• Modelling

Problem 1 -
• Define a TRS that can decide if a natural number is composite
• Define a TRS that can decide if a natural number is prime

Problem 2 -
• Write an ADT specification for a stack of integers
• Write an ADT specification for a queue of integers
• Compare and contrast the 2 models

Useful reading material

• Book - Gödel, Escher, Bach: an Eternal Golden Braid, Douglas Hofstadter, 1979

Useful external links

• Quick Introduction to Term Rewriting, Paul Klint.

Session 2: Wednesday 10th May (14h30-17h45) B313

2. Requirements

Additional reading material

Session 3: Thursday 11th May (10h-13h15) B313

3. Compositional Design

Today's session is about architecture and design (and team work). You will be asked to design a solution to a problem (explained on the whiteboard). In summary, the probem will be to implement Queues using Stacks (and Stacks using Queues) You will then be asked to evaluate and adapt your designs when the components are faulty. This will become clear during the session. I will share code with you (as you request it), but you can also code everything yourselves if you wish.

Wavestone Visit I: Wednesday 17th May (10h-13h15) B313

The following groups have been formed:
• groupe 1 : Mohamed Guermazi, Dorra Jmal, Omar Mhiri
• groupe 2 : Charles Meyer, Lou-Anne Ouattara
• groupe 3 : Charles Morrissey, Manon Rives, Hadrien Gruet
• groupe 4 : Claire Le Roux, Angel Turounet
• groupe 5 : Chloé Bénichou, Clara Stavun, Farah Chaouachi

Session 4: Wednesday 17th May (14h30-17h45) B313

Analysis of the slides from Wavestone (from this morning's session) - do we understand what they are asking? Where do you think you will need most help (pedagogic)?

Drafting a proposal - how to make a choice? Domain analysis. Technology analysis.

Session 5: Wednesday 24th May (10h-13h15) B313 - From Requirements to Design

In this session, we will revisit the lift system.

Sample Solution Lift Requirements
Lift Functional Design

Additional reading material

Useful external links

• What does a Functional Design have to offer?, ITpedia.
• WHAT IS A FUNCTIONAL DESIGN SPECIFICATION (FDS)?, RealPars.
• What is a Functional Specification Document?, Essential Designs.

Session 6: Wednesday 24th May (14h30-17h45) B313

In this session, we will continue to work on the lift system functional architecture.

Session 7: Thursday 25th May (10h-13h15) B313

In this session, we will briefly review some of the UML diagrams that may be useful when modelling system architectures.

Personal Work Time: Tuesday 30th May (10h-13h15) B313

I will organise to be with you online for part of this time (to provide help with your Wavestone project, if needed)

Wavestone Visit II Session 8: Friday 2nd June (14h30-17h45) B313

I will be online for this meeting.

Session 8: Wednesday 14th June (14h30-17h45) B313

In this session we will finalise the functional architecture of your systems. First we will analyse the functional architecture of the elevator/lift system.

We will 'reverse engineer' the functional architecture from the Java implementation (provided):
• What is the state of the system?
• How much of the system environment is modelled in the state?
• What are the state transitions (that require modelling as functions)?
• How do interactions between the system and its environment lead to changes in the state?
• What do you know about the frequency of these interactions?
• What information/data is communicated during these interactions?
• Can the state change independent of its environment? If so, how?
• How is the state distributed amongst parts (components/subsystems) of the system?
• Where/How are the state transitions implemented - how is this functionality distributed amongst parts (components/subsystems) of the system?
Note that the Java is an OO design and so the functional architecture will group state and functions inside objects/classes (as attributes and methods)

Draw a UML class diagram for the elevator system/lift. A useful online tutorial can be found at: JavaTpoint

After you have completed the class diagram for the provided lift system, and checked it with Paul, draw the functional architecture of your system as a UML class digram. To guide you, answer the same questions as you did for the lift system.

You may choose to also (alternatively) draw:
• a Functional Decomposition Diagram
• a Data Flow Diagram

Session 9: Thursday 15th June (10h-13h15) B313

In this session we will estimate resources (time and money) for the development of the first version of the system that can be demonstrated to the client (MVP or prototype). We will also estimate the resources required to manufacture a final version that can be sold/deployed. This will involve using task graphs and Gantt charts for planning the development.

Risk Analysis and Cost/Resource Estimation

We shall analysis the technical risks of the system: liklihood of occurrence and potential severity of impact. We shall also make mitigtion plans for managing these risks.

You are to perform a cost/resource analysis for your proposed systems/applications.

Useful reading material

Session 10: Tuesday 20th June (10h-13h15) B313

In this session we will identify the physical components that will be used to implement the functional architecture. We will list the options avaliable, the criteria for making the choice, and the final choice that was made.

Useful external links

• 6 IoT architecture layers and components explained

Session 11: Tuesday 20th June (14h30-17h45) B313 - Tools and technologies

This session will look at some of the tools and technologies that may help you in preparing the second deliverable for Wavestone, with emphasis on the detailed (physical) design.

• Access and Data Security Modelling
• Moving from Functional to Physical Architecture
• Router Technologies and APIs
• Sensor Technologies and specifications
• Connecting IOT with the cloud (and cloud gateways)
• Choosing Cloud Service Contracts
• Tools and technologies

Useful reading material

Access and Data Security Modelling

• Article - A Formal Model For Role-Based Access Control with Constraints, Giuri, L., and Iglio, P. (1996, June). In Proceedings 9th IEEE Computer Security Foundations Workshop (pp. 136-145). IEEE.
• Article - Using UML to visualize role-based access control constraints., Ray, Indrakshi, et al., Proceedings of the ninth ACM symposium on Access control models and technologies. 2004.
• Article - Model driven security: From UML models to access control infrastructures., Basin, David, Jürgen Doser, and Torsten Lodderstedt. ACM Transactions on Software Engineering and Methodology (TOSEM) 15.1 (2006): 39-91.
• Article - UMLsec: Extending UML for secure systems development, Jürjens, Jan. International Conference on The Unified Modeling Language. Springer, Berlin, Heidelberg, 2002.

Moving from Functional to Physical Architecture

• Presentation - Architecture-Based Systems Engineering and Integration, Dr. A.R. Habayeb Virginia Polytechnic Institute & State University, 2005.
• Article - Wireless Sensor Networking architecture of Polytropon: An open source scalable platform for the smart grid. Papageorgas, P., et al. , Energy Procedia 50 (2014): 270-276.

Connecting IOT with the cloud (and cloud gateways)

• Article - A New Computing Environment Using Hybrid Cloud, Rao, T Venkat Narayana and Naveena, Kamsali and David, Reena, 2015.

Choosing Cloud Service Contracts

• Report - Practical Guide to Cloud Service Agreements

Useful external links

Access & Data Security Modelling

• Web site - Access Control: Models and Methods
• Web site - Role Based Access Control
• Web site - Details about Data Encryption
• Web site - Securing the IoT - Building trust in IoT devices and data

Moving from Functional to Physical Architecture

• Web site - Conceptual, Logical, or Physical: How to Use Architecture Levels Effectively
• Web site - An introduction to fundamental architecture concepts

Router/Gateway Technologies and APIs

• Web site - IoT Standards and Protocols

Sensor Technologies and specifications

• Web site - IoT Sensors and Actuators

Connecting IOT with the cloud (and cloud gateways)

• Web site - Connect your Raspberry Pi with AWS IoT
• Web site - Build an Azure App Service to record Raspberry Pi Sensor Data
• Web site - Getting Started With IBM Watson IoT And Connecting Raspberry Pi As A Gateway
• Web site - Tutorial: Prototyping a Sensor Node and IoT Gateway with Arduino and Raspberry Pi

Choosing Cloud Service Contracts

• Web site - 8 criteria to ensure you select the right cloud service provider
• Web site - Le Big Data: Cloud AWS - Tout savoir sur le cloud Amazon Web Services
• Web site - Cloud Vs Dedicated Server: Which Is Best For Your Business?
• Web site - The Pros and Cons of Cloud vs in House Servers
• Web site - https://www.pcmag.com/review/340199/ibm-cloud

Session 12: Wednesday 21st June (10h-13h15) B313

In this session we will develop a small graphical demo of the architecture (functional and/or physical) of your system (or part of the system). You can use any tool like you wish. You may wish to program/code your solution (see links below)

Note: you may also choose to work on your final deliverable if it requires more work.

Useful external links

Session 13: Wednesday 21st June (14h30-17h45) B313

In this session you will work on the assessed work for Paul:
• Requirements Model and Functional Architecture - deliverable1 - Team mark (30%)
• Physical Architecture and its coherency with the requirements - deliverable 2 - Team mark (30%)
• Review of process of architecture design - Team mark (30%)
• Engineering log/journal -Individual mark (10%)
There will also be a bonus mark (0-10%) for additional work done on the initial problems (not compulsory part of the Wavestone project work) - TRSs, ADTs, Lift requirements, Lift Design, Faulty StacksQs. Architecture Simulation

Note: you may also choose to work on your final deliverable if it requires more work.

Wavestone Visit III: Thursday 22nd June (10h-13h15) B313