Skip to content

Latest commit

 

History

History
47 lines (27 loc) · 6.41 KB

REDEPLOYMENT.md

File metadata and controls

47 lines (27 loc) · 6.41 KB

Redeploying BizPort in Your City

Overview

This is an overview of how city management can deploy BizPort in their own city.

BizPort is a business portal composed from common and readily-available open source code and tools. It contains a content management system (CMS) for easy editing of site content, as well as a rich set of features for customers starting a business.

A redeployment of BizPort as a city business portal requires two key positions:

  • Technical setup: BizPort is designed to be easily redeployed and customized by a single, full-stack engineer familiar with a modern open-source language like Ruby or Python. See the section below on “Hiring for Engineering Work” for more information.
  • Content development: What makes a business portal valuable for customers is the relevance and accuracy of content. We like to say that a website - similar to a city - is never done. The business portal needs one person to help coordinate across multiple departments to build high-quality content regularly. This position could be filled by a UX researcher, service designer, communications manager, or program manager.

Product management is also a key function necessary to shepherd BizPort to success, setting priorities for the site’s future development and ensuring that the setup and maintenance process is done in a way that meets end-user needs. The content developer/manager might also serve this function, or it could be provided by a separate person.

Ongoing maintenance is needed to ensure BizPort continues to meet the needs of your business community. Both content and code will require updates and continued development over time. While this will require less bandwidth than the initial site setup, it should be considered in long-term staffing plans to ensure that the site does not fall out of date, become irrelevant to customer needs, or develop security vulnerabilities.

Technical maintenance (not including continued feature development) should take only a few hours per month. Content management, coupled with necessary continued cross-departmental staff engagement, is likely to require up to twenty hours per week.

BizPort's Components and Features

BizPort itself is open-source software, licensed under the MIT license. This license is extremely short, simple, and worth reading: MIT License

It's important that BizPort is open source because it means that you or an engineer that you employ can edit the software however you like to meet your own needs.

BizPort is made up of several smaller open-source pieces, and can be easily customized to meet the needs of different cities. Any of these features can be included or excluded from the site with a few hours of engineering work. The key features are:

  • Content Management System (CMS): The content throughout the site is managed in a CMS that allows non-technical staff to edit information. A staff member can be trained in the basics of editing in less than an hour.
  • Live Chat: This is provided by a third-party service called Intercom, but could be replaced by any number of live chat options or CRM systems like Zendesk, Olark, or Desk.com. The core purpose is to give customers a way to interact with city staff instantaneously, which leads to better customer service, as well as more rapid feedback and improvement of the site.
  • Checklist: The checklist serves as both a map for entrepreneurs embarking on the process of starting a business, as well as a tracking tool as they set up their business.
  • Notebook: Starting a business involves lots of little bits of information. The notebook is a single place to keep that information handy, especially when entrepreneurs are visiting city hall or filling out paperwork.
  • Resource Matching: BizPort provides a search tool to help entrepreneurs find government resources that are relevant to their business. This includes financial resources like loans and grants, as well as other supportive resources like workshops and mentorship opportunities. There is a user interface for non-technical users to update the database with opportunities specific to any region or jurisdiction.

Other business portals may have examples of other features that would be useful to add to BizPort. An experienced engineer should be able to add most any feature to BizPort, but be aware that this is, in nearly every case, considerably more work than just “copying and pasting” code, even if it’s coming from another open-source project.

Hiring for Engineering Work

Deploying BizPort with general visual customizations (i.e. color, icons, etc.) will likely take a FTE software engineer two to four weeks. Ongoing maintenance of the site will also require a few hours per month. Additional feature development or design changes fall outside of this maintenance work, and should be accounted for separately. Additional features could take between weeks and months to implement, depending on the complexity of the feature.

BizPort is written using a programming language called Ruby, along with a common programming tool called Ruby on Rails. A software engineer with a couple of years experience working with Ruby on Rails should be able to confidently set up, maintain, and grow BizPort. Experienced software engineers proficient with Python are also likely to be viable candidates for working on BizPort, as some of the skills used when working on Python are transferable to Ruby on Rails.

While the time commitment to set up and run BizPort is not extensive, it takes time for any engineer to become accustomed to working on a new project, and so having the same engineer(s) work on BizPort over time is ideal.

Hiring for Content Editing Work

Writing and maintaining content on the site is what will make your business portal succeed, and it’s important to set aside a few hours per week to keep the site up to date, respond to new user content needs, and verify content accuracy with subject-matter experts. This work, far more than technical contributions, is what will make your business portal successful.

Content on the site will need to be updated regularly. BizPort includes an easy-to-use content management system (CMS) that can be learned by a non-technical detail-oriented employee in a couple of hours. To ensure the quality of the content, the person editing the CMS should be someone who cares about the content as part of their existing role, like an economic development or business-facing staff member.