HOW TO: extend Snap4City Platform with new modules and tools

Snap4City is modular and based on API and MicroServices
New Features can be easily added by Creating New:

• Dashboard Features --> Custom Widgets, Widgets 
  • they can be created by using the Custom Widget SVG approach

    • TC1.22a: Create and configure a Snap4City SVG Custom Widget for real-time interaction

    • TC1.22b: Create and configure a Snap4City SVG Custom Widget for real-time interaction

    • Custom Widgets: Table explanation, as SVG

    • TC1.26: Use customised SVG pins in a map

    • TC9.19: Custom Widgets / Synoptics controlled by IOT Applications

  • they can be created by developing new elements programming in PHP, JavaScript, Angular, D3, etc..

    • Custom Synoptics and Widgets for Dashboards

• connectors, adapters, IoT protocols, data transformations, etc. --> by creating new MicroServices, new flows or new IoT Apps ... 

  • https://www.snap4city.org/download/video/course2020/di/

  • HOW TO: Develop an IOT Application for Data Ingestion

  • they have to be in Node.JS, JavaScript according to Node-RED
    • Snap4City Supported Protocols, adding new protocols
    • how to create a flow and nodes in Node-red:  https://nodered.org/docs/creating-nodes/first-node 
  • They can be automatically created from API rest call 
    • TC2.25.    Registering external MicroService calling RestCall services, using it on IOT applications
  • business logic behind a dashboard
    • TC9.19: Custom Widgets / Synoptics controlled by IOT Applications
• Applications, Modules --> for management, for verticals, in the core by using
  • any language you prefer, preferably exposing API for integration with other modules
    • https://www.km4city.org/swagger/external/index.html
    • https://www.km4city.org/swagger/internal/index.html
  • See Tutorial on how to transform any REST API in a Micro Services
    • TC2.25.    Registering external MicroService calling RestCall services, using it on IOT applications
• IoT Devices --> for collecting new data kind or acting on the field

  • HOW TO: add a device to the Platform

  • HOW TO: Manage IOT Network Components on Snap4City

  • you can add to the  platform any kind og IoT Device, with any kind of IoT Protocol
  • You can exploit the open source for Android and raspberry for creating your safely connected IoT device  with Snap4City using NGSI V1, V2 and exploiting our secure communication approach
• Processes --> Data Analytic of any kind, also exploiting machine learning, gpu, etc.
  • see tutorial on Data Analytics
  • https://www.snap4city.org/download/video/course2020/da/
• Web and Mobile Apps --> new end-users services
  • see tutorial on Part 7 on mobile app development
  • https://www.snap4city.org/download/video/course2020/app/
• dashboards
  • https://www.snap4city.org/download/video/course2020/das/
• IoT Applications
  • https://www.snap4city.org/download/video/course2020/iot/
• data ingestion process, integration, etc.
  • https://www.snap4city.org/download/video/course2020/di/
• ​External Services to be exploited on Dashboards
  • External Services, as WebPages
  • ​by simply registering their URLs on the portal
• Workflows via Open Maint
  • TC 1.24 – Integrated Ticketing and Facility Management system
• BIM Model via Bim Editor for IFC production --> Bim Server, Open Maint.
  • HOW To: Manage BMP and BIM: main features of openMAINT, BMP, BIM
• etc. etc.  

New custom made modules for contributing on Snap4City can be created as well

Snap4City modules are typically in Affero GPL and the rebranding of the whole platform is not allowed, while you can freely create any additional module, open or proprietary.

New modules on the Snap4City can be freely developed and may be provided to the community 

• to be integrated in the main version, have to be tested and validated by DISIT Lab. They have to:
  • be in Affero GPL
  • do not affect the functionalities of other modules in negative manner
  • provide the needed quality, in terms of test cases, documentation, etc. 
• no constraints: if the they remain on a forked Affero GPL published version on Internet and linked to main…
• which are not part of the core, can be based on proprietary model, and exploit the Snap4City tools via APIs.