G Saunders' Home Page

INFO465 - Senior Projects in IS - Fall 2017

Notes:

(9/12) IBM's Master the Mainframe is underway for 2017. If you're interested in network management or app development this can help launch a career on a high trajectory. IBM anticipates 80,000+ contestants this year up from 30,000 a couple years back...

(9/10) From email: The only use for /home/SeSDoC/SiteSettings.php for the time being is to supply the name of your fictitious organization so it shows up in your card at info465.us. If you're not using the sample code at SeSDoC, copy SiteSettings.php to your home directory and edit the copy to name your fictitious organization.

Soon, SiteSettings.php will be used to keep database connections and other functions used by other scripts in a more secure spot, not in the web document root. The script that makes the page at info465.us expects to see.

Reports on the 'Logged:' links have been enabled to list violations of specs. Zero spec violations is a requirement for Project #1, Dlv #2 -- it is not due for Dlv #1. Please re-read Dlv #1 specs for what is due...

(9/6) Project #1, Dlv #1 is due for full credit by the end of class the 11th or beginning of class on the 18th, prior to any tech support. 2 points per class meeting will be docked for invalid or otherwise incomplete deliverables. Points are not posted until the project gets all the specs for Dlv #1 as posted the 29th: valid, mobile friendly, responsive, shows off three items for sale, uses product images with transparent backgrounds.

Make sure your site is valid at the W3C HTML & CSS Validators and that it passes Google's Mobile Friendly Test!

Please keep your technical interview in mind when you make the site and make it something you'd be proud to show anybody interested in hiring you that you can make an attractive, standards-compliant web page and explain how the responsive features work. If you're using the sample code, there's a stated requirement to customize the page and remove all vestiges of Fra Luca's Tribute including the color scheme.

The file copied from /home/SeSDoC/SiteSettings.php to your home directory is a php script where stuff is kept outside the 'web document root' so it's not accessible by a browser. It's intended use is for keeping values specific to your site, like the name of your ficitious organization, and functions used in the php scripts for database connections, log in status, &c. The name is shown in long and short nominative and possessive cases so it can be picked up and included in prompts or other strings on the site's pages.

If your card at info465.us/FA17.html says SeSDoC is TradeMarked!!! please edit SiteSettings.php and make it refer to your fictitious hussle...

Check your 'Logged' link, please, and let me know any errors or omissions you may find. It's still being debugged, may be proven accurate soon...

(8/29) Points & Feedback plus final grades are posted from the summer session. It's a pleasure seeing good projects and so many As and Bs...

Class Meetings:

Syllabus & Intro

(8/29) Syllabus and A 'Design & Build' Experience. Please note the course objectives in the syllabus and plan to demonstrate that you've met them, repeatedly!

My objective as an instructor trying to maintain the value of our IS Degree is to _see_ that each student can do what the objectives say our grads can do. There's some 'remediation' required for many students who somehow didn't get those 'database programming' skills earlier but has mastered most of the UML and MSProject stuff. My method is to limit the scope of the class' project to something that can be done in a semester, provide a tried and true framework for it, and provide as much tech support as 1 instructor in a class can do. The ordinary student masters the technologies involved, meets the specs, and leaves the course with an A or B.

Good-looking project documents make valuable entries in a graduate's professional portfolio, can go a long way to convincing some interviewer you know a debit from a credit, a while from an if, and have a good grip on your model view controller. If a student doesn't have a portfolio of technical skills or can't pull one together it can break the relationship with the recruiter or hiring manager at the threshold to some career...

Most specs and advice are given in class, verbally, some are here...

(8/29) Working Server Side

Click Logging in and working at info465.us for references about working at the command line at info465.us. User ids and passwords were handed out in class.

Mobile First, Responsive HTML5 and CSS3 Forms

Demo'd SeSDoC forms: Mobile first, responsive, valid html5 and css.

These links were visited and examined in class. They are all dead-simple HTML and CSS, just enough to clearly demonstrate semantic markup of content and forms.

(8/29) Project #1: Learn Linux, vi, and make sample code work in your web directory

This 20-point project is to put up a demo site that gets all the specs below and will launch from your link at info465.us.

Dlv #1 is 5 points: demo a valid, mobile friendly, responsive site that shows off three items for sale. Please use product images with transparent backgrounds...

Dlv #2 is 15 points: add an application form to demo JavaScript and PHP.

The project is to explore a linux web server, develop proficiency with the command line environment and the vi editor, and demo mobile-friendly, responsive features of HTML5 and CSS3. Sample code is provided in PHP and JavaScript to present a standards-compliant, mobile-friendly html form and validate it browser-side with JavaScript and also server-side with PHP. If you're using the sample code, please plan to customize it as you go along so the end result doesn't look much like the samples. 5 bonus points will be posted for students who abandon the instructor's samples and get all the specs with other stuff.

If you've already done responsive HTML/CSS 'from scratch' this might be a good time to learn a CSS or CSS/JavaScript framework! The PHP examples deliver content by replacing strings in an html template so they are easily adaptable to a template done up with Bootstrap, Foundation, or an even heavier CSS/JavaScript framework.

Gain familiarity with the Linux command line at info465.us and use it to copy text files, scripts, css, and html from /home/SeSDoC and /home/SeSDoC/web or your framework to your home directory and web directory and tweak them into webpage that shows up from your link at info465.us.

Next, study the features of HTML5, CSS3, PHP and JavaScript in the sample code for semantic markup, responsive web design, and form handling. The SeSPoP and SeSDoC pages have links to Tutes for all these topics.

Decide whether you'll adapt the sample code at SeSDoC or Resp for your project, or start from scratch, or use a lightweight CSS framework like W3Schools RWD, W3CSS, Bootstrap, or something heavier with more pizzazz. Exploring AJAX and jQuery are also worthwhile while you've got a server at your fingertips if web designer is something you'd like to be.

The sample code at SeSDoC uses 'html templates' and is very easy to fit SeSDoCForm.php and other reports into an html template made from a css3 framework like W3CSS, Skeleton, BootStrap...

Make the html and css suit the fictitious organization, business, or hustle you confabulate for your case study. The index page will become a store-front that earns commissions on sales of at least three products or services. Choose a thumbnail image to represent your site at info465.us and make the site comply with the SiteThumb spec (at the bottom of the Thumbnail page at info465.us) so your site appears in the gallery at info465.us. Transparent backgrounds are attractive, animated gifs of a few dozen frames are fun to see.

Specs for Project #1 Dlv #2:

If you're working from the samples provided, consider the acronymns SeSDoC and SeSPoP as the property of these ficititious organizations and they should not appear in the file or variable names involved in your website. The page age info465.us enforces these and other specs.

All form elements, variables, and objects should have meaningful names consistently applied so that columns in the database, names of html form elements, file names and variable names in JavaScript and php code, are all the same.

No embedded or in-line Styles! This is what 'separate style from content' means! All CSS must be 'external', in a local file linked in the head of the document! If there is an exception, add a style for it in the external style sheet. If there is some reason you must embed or use in-line styles to achieve some effect, please discuss it with the instructor.

All pages must be consistently styled with the same or similar external css3.

If a semantic element exists, use it. Do not use plain divs with ids or classes named like header, footer, menu, aside, or any other CSS3 semantic selector. Don't use frames or iframes, named or otherwise. Make your page a very clear demo of the best markup for semantics and style!

Use CSS3's semantic elements for page layout to best advantage: As a minimum, structure your page layout using: header, main, aside, and footer.

Use CSS3's semantic elements to mark up content: p, h1-6, ul, ol, li, strong, and em, table, td, tr...

Use CSS3's form elements to mark up forms: fieldset, legend, and label.

The elements in the sample form at SeSDoC define an html form in a standards-compliant way so that is usable in a mobile device without any stretching or tapping and is also accessible for handicapped persons and search engines.

Use a grid scheme for responsive design. The samples use the '12 grid' scheme from W3School's RWD tute with Row and Col defined in CSS, amenable to folding for tablets and phones. This also appears in W3CSS and the equivalent is in BootStrap and Skeleton.

Optionally, article and section may be used to organize featured products or items, newsletters, blogs, and other complex web documents. Styling an article is a good way to implement material web design features like cards.

Wildcard classes of CSS3 make it easy to adapt a multi-Column grid system to any kind of device by being clever with object names like 'Col-' or 'Card' to adapt seamlessly with any sized viewport. W3Schools RWD and W3CSS show how to use these wildcard features. These features are well used in most CSS3 Frameworks!

CSS styles make it easy to make accordion or drop-down interfaces for the user, or change from a hamburger to a menu when the window gets big enough. Many CSS3 transitions are now supported by current versions of all common browsers and most vendor-specific styles may be retired. There's a lot of value in learning how to do these with native jQuery or one of the frameworks that uses jQuery -- these are the slickest and doing them the way Google does it is a good thing!

Serve all graphics, fonts, libraries, frameworks, and styles directly from your web directory at info465.us and be ready to report on their bulk. Quick loading speed on a slow network is of the essence. Google guidelines favor lightweight pages that load fast even on a 3G network. Limit the size of graphics for products on the home page to something less than half a megabyte. Size all images for their max dimension as used on your site. (If it's 300px wide on the page don't link to an image that is 2000px wide in the img tag, and don't use dimensions in css or html to make large images fit.) Use a photo-editor on your desktop or online to size images. Make sure all re-sizing results in sharp images and doesn't result in unsightly artifacts...

Set the permissions for your web and any of its sub-directories to 705. Set the permissions for all files in your home and web directories to 604. The intent here is that the web server can read these files but others in the info465 group can't.

Specs for The Form in Dlv #2

Project #1's 1st deliverable was a single page, mobile-friendly at google and valid at w3c, website for some fictitious shop or organization allied under 2016Winter's umbrella.

The 2nd deliverable is a two-page site that launches from the link at info465.us, showcases at least three products on the home page, and has a form on the second page that has been customized to suit membership or other relationship with your ficititious organization. All css is external, html5 and css3 validates at W3C validators, and all pages score Awesome on Google's mobile friendly test.

Project #2 will be to add user authentication and update the database using the form built in Project #1 Dlv #2.

The PHP-generated form must work at least as well as the sample code provided at SeSDoC, meeting these finer specs:

Open Lab

Tech support for learning the command line and vi and Project #1, Dlv #2...

Things not looking right in the browser? Maybe getting an empty page back or missing an img? Tailing the log might help: Open a new ssh window and log in to info465.us. Use this to show the tail of the log and follow it, replacing 'yourlogin' with your login id at info465.us.

tail -f /var/log/httpd/error_log | grep yourlogin 

This will show errors produced by html or scripts from your directory when you load or refresh a page so keep it visible while you work. Use ctrl-c to stop tailing the log.

Please use the references! There's a month's time to get up to speed with mobile-first, responsive design with css3, html, form elements, JavaScript, and PHP... Validate early and validate often! W3Schools, Google, and Mozilla are all excellent references, have been revamped to cover mobile-first, responsive design. Consider W3Schools as introductory stuff, followed by Google's authoritative guidelines, and Mozilla's very detailed docs. The CSS Zen Garden is worth a stroll...

Some hints on debugging:

In short:

If you're programming without the developer and debugging tools running, you're just guessing and frustrating yourself and ticking off the intructor in lab, and will likely inject numerous errors in the code while blindly trying stuff.

Keep the debuggers visible at all times even if everything appears OK since they may be showing warnings that detract from a professional result.

Here is a screenshot suggesting a juxtaposition of putty or Mac terminals and a browser while debugging. A quick mouse-click or Alt-Tab moves among browser and code windows. The tail of the log is always visible so it's easy to see it jump if/when there is an error in a script...

Screenshot

Click Debugging PHP and MySQL for videos...

Developer's Tools vary a lot from browser to browser! Some even takes lotsa seconds to load and cause the fans to come on just to show all the charts and graphs! The instructor usually debugs with FireFox Developer Tools, W3C, and Google, then Chrome on an Android, then Safari on a tablet, then with FireFox Developer Tools, then Chrome on a notebook, then Edge. Make sure you know how to refresh components in whatever Developer's Tools you use! Firefox and Chrome's source views flag some HTML and CSS errors, are quicker than the W3C Validators.

Keep the 'tail of the error log' visible at all times. If you're getting an empty page back or unexpected results from a PHP script, or missing an image /var/log/httpd/error_log will likely show the error.

Open a new ssh window and log in to info465.us. Use a command like this to show the tail of the log and follow it, replacing 'yourlogin' with your login id at info465.us.

tail -f /var/log/httpd/error_log | grep yourlogin 

This will show errors produced by html or by PHP or other web scripting languages from your directory when you load or refresh a page so keep it visible while you work.

Use ctrl-c to stop tailing the log.

If you haven't been tailing the log and wonder about recent errors, you can grep them out of the error log like this, replacing yourlogin with your login id:

grep yourlogin /var/log/httpd/error_log

If there are no errors in httpd/error_log but the script isn't producing the correct web page, place echo statements followed by exit at strategic points in the PHP code so you can _see_ what's going on before the HTML is pitched.

Something like this might be helpful:

echo $View; exit;
Or, use print_r to show superglobals or arrays:
print_r($_POST,false); exit;
at the top of a script would show the POST data submitted from an HTML form to remove any doubts what's in the POST data...

Debugging JavaScript: From Chrome's Menu at the right of the title/search bar, choose More Tools → Developer Tools and figure out how to use it from any of several on-line resources.

To get a quick look at errors from JavaScript use the Console tab with Preserve Log set to capture errors from statements in <script, onClick, and other HTML elements. Position the console so you can see the error messages as the page loads and events are triggered. Double-click on an error to be jerked to the errant line of code.

Use the W3C HTML and CSS validators early and often and don't continue debugging until they are valid. Design for mobile first with viewport set, then tweak @media queries for larger displays. Use Google's mobile friendly test, try W3C mobile validator for more of a challenge.

Project #2 Assigned - Authenticate Users, Establish a Secure Session, Menu, Update Database, Report...

Demo in class showed PHP's session_name, session_start, session_destroy and also looked at a session cookie under the i-spot in the browser and session data kept in /var/lib/php/session on the server. LogIn.php authenticates via web-service at 2016Winter by opening a pipe to handle a request with userid and password and response with not-valid or user's name. LogOut.php uses session_destroy to clear all the data from the session on the server. Every 'protected' php script requires SiteSettings.php which blocks access to pages if a browser's not logged in and redirects the browser to LogIn.php or index.html. Find these features in the code and be prepared to explain them.

Modify your site at info465.us to work similar as the example at info465.us/tinstructor, making a link like 'Members' prominent on your existing page. The project is to make your site authenticate users with 2016Winter credentials and provide forms and content to logged-in users only. If somebody tries to access a 'protected' url, they should be directed to the LogIn script for authentication, then to the url they attempted to reach.

The specs for the behavior of the form are the same as Project #1, all input elements should be returned with text, checks, and selections the same as the user entered. And the user should be able to re-submit a form if they notice an error. The specs for Project #1 were intended to make a form that can easily be secured and used to update a database.

The sample scripts are available from the command line in /home/tinstructor/ and /home/tinstructor/web/.

/home/tinstructor/SiteSettingsSample.php is available to copy and modify to suit your Site. Leave the functions intact. Edit at the top and bottom to supply _your_ SessionName and database credentials. Take care not to clobber your existing SiteSettings.php when fitting the new script in your account.

Copy these scripts to your web directory: TemplateSeSDoCForm.html, SeSDoCLogIn.php, SeSDoCController.php, SeSDoCLogOut.php, and SeSDoCApplicants.php. SeSDoCCommissions.php is not available to copy. After you've made them run, edit them to suit your site and database.

SeSDoCForm.php differs from the earlier example. Don't copy it over your existing form's script. Copy the changed parts to your script:

Here's a class diagram of a project similar to your Project #2:

MVC Thumbnail

Notes about SQL scripting at the command line are at MySQL/MariaDB Scripting and were demo'd in class.

The user id for your individual MySQL/MariaDB database is the same as your id at info465.us and passwords are the upper-case 1st letter from your first name and the last 4 lower-case letters from your last name. Rowdy Chihuahua's connect string would be: mysql -urchihuahua -pRahua rchihuahua

Please take care not to destroy your working php script as you add code to support database update! Make local backup copies so it's easy to revert to working code if you hose up the script while adding database update. HTML form handling, securing web pages, and updating a database in a structured environment are inherently complex tasks. Make sure you're keeping copies of your working scripts before each session so you've got something recent to roll back to.

Code Review

Structured Notation Page 1   Structured Notation Page 2  

Structured Notation Page 3   Structured Notation Page 4  

Demo OE, Fulfillment, and ACH at 2016Winter

Assignment: Teams of three or four confabulate a shop to operate under the umbrella of 2016 Winter. Get three products or services ready with graphics to upload and show at the shop...

Setup Shops:

A sample accounting for startup and a day of operations for a ficitious hussle similar to the case studies teams are confabulating. This is to review double-entry accounting concepts.

Each team please provide on paper:

After a demo of the PAYGO Unbrella 2016 Winter accounts will be set up.

Accounting:

2016Winter Database

Projects and a quiz use the database at 2016 Winter. Please gain familiarity with it. Here's a connection string with select authority that will work from the command line at info465.us:

mysql -u2016Fall -pFall2016 2016Winter

Use W3School's SQL Tute for an introduction to SQL. The database server at info465.us is MariaDB which at this point is a direct drop-in replacement for MySQL which most Linux distros avoid because it's Oracle's property...

Here are sample quiz questions: SQL Samples. Here are sample quiz questions with answers: SQL Questions & Answers.

Here is a sketched Database ERD of the 2016Winter database that have to do with accounting. Table names are accurate, some column names are not quite. Use SQL's DESCRIBE command to get the exact column names.

ERD

Here's a sketch of the whole database and file system for 2016Winter. Tables with dashed lines around them might show up in some other season to help with distribution functions.

ERD

Project #3 - Earn and report commissions

This is 10 points for individual effort and 10 points for teams. Teams setup Items in their shop at 2016Winter to be sold under the PAYGO commission agreement by each of the associates. This is demonstrated in the 'Click to Buy' links for Pacioli's books at info465.us/tinstructor.

Each student's shop at 2016 Fall has a link added to report commissions earned on the three items offered.

Teams contrive several purchases at their shops and the shops of other teams using the fake accounts with credit acconts issued by an ELand ACH.

Shops need a good-looking trial balance put together with at least a dozen orders and journals showing startup and a couple day's operations. QOH for items in the store should be reasonable to support on-line sales.

Project #4 - Document 2016 Winter

Teams thoroughly document the 2016 Winter PAYGO Umbrella's system as built. Team members note which portions they authored, and all team members should be involved enough with the project so they can claim it as an exhibit in their professional portfolio. Individuals, or those fired from a team, may negotiate a subset of the UML Diagrams and other documents. All documents must use recognized shapes from the UML suite of diagrams. Project #4 must be submitted in printed form and also in a single pdf submitted through BlackBoard.

Bring work to class for feedback early. None will be offered between the last class and the exam. The exam time is to collect projects not help debug them or tweak them to specs after critique...

Sketch of Similar Application as at 2016Winter

MVC/Class Diagram

This a rough Class Diagram for the MVC-Model View Controller scheme similar to 2016Spring. The UML doesn't have a MVC in its set of diagrams quite yet, but the Class Diagram is easilty adapted to reflect the popular design pattern. The blocks in a UML Class Diagram typically show Name of the class, its methods, and its properties. Here, to make it fit a MVC, the block represents a model (aka script) instead of a class. 'View' is substituted for method, where the models consistently use HTML GET or POST data in $_REQUEST['View'] to control their output.

The biggest block in the diagram is Controller.php, 'the controller', which surveys the environment for a logged in user and provides a menu of the models and views appropriate for their authority and roles. Please, improve on the diagram if you choose to use it as a model for your Class diagram, and make it a tighter fit to 2016Winter.

Its important for somebody wanting work in app dev to have a ready reference to a Model View Controller and be able to talk about it, sketch it, or sit down and develop with it. The MVC is a popular and powerful design pattern implemented in many development environments in many ways. Visual Studio's MVC is highly abstract with a steep learning curve, which it's well worth climbing since it takes best advantage of the .NET Framework. Django is in many ways a MVC, as are other frameworks for application development.

State Transition Diagram aka State Chart

This is a rough UML State Chart, or state transition diagram, for Orders OStatus from check-out through fulfillment in an application similar to 2016Winter. It's reflects changes from 2016Winter that involve a shipping desk after the ACH authorizes the credit card.

2017Summer State Chart


G Saunders,
Dept of Information Systems
VCU School of Business

G Saunders Wings

Content © 1999 - Today
By G Saunders
Images are Available on the Web