bigdoods / theBIMportal

Web Portal for BIM project collaboration
15 stars 8 forks source link
bim bim-applications model-viewer portal

The BIMportal.

BIM level 2 operations and collaborations portal

Description

The BIMportal is a collaborative working tool for multiple stakeholder engagement on a BIM project.

It is designed as a modular collection of BIM Applications built on a Linux/Apache/mySQL/PHP technology stack using the codeigniter 2.2 MVC framework.

Preview

<img src="http://img.youtube.com/vi/dNUFRohKjM8/0.jpg" alt="theBIMportal feature video" width="640" height="480" border="10" />

Live demo available here - www.thebimportal.com

Login details for Admin dashboard Username: admin@yourcompany.com Password: 01234567

(Click "PORTAL" in top right screen to enter User view.)

Getting started (Development)

Install and setup requirements to run codeigniter or recommended - use the development environment here.

Replace the default files in local.dev with the contents of this repo.

$ rm PATH/TO/public/local.dev/* && git clone <this repo git address> /path/to/public/local.dev/

Ssh into the box

$ vagrant ssh

Connect to mysql. Password=vagrant

$ mysql -u root -p

Create a database instance and switch to it

$ CREATE DATABASE empty_portal;
$ USE empty_portal;

Reload sql dump file. Empty found in db_dumps folder.

$ SOURCE <path to .sql dump file>

Exit and make sure that your hosts file allows access for vagrant as described here

$ exit

Fire up the app! Open a browser at http://local.dev and check it out!

Getting started (Production)

The list of commands (with comments) that are used to deploy theBIMportal to an instance on google cloud platform can be found in (this file)[https://github.com/jenca-cloud/theBIMportal/blob/master/GCP-deployment.md]

Docker

theBIMportal can be deployed using docker-compose

$ docker-compose up -d

This will setup the application to run on port 80

List of applications in the application directory currently include the following:

Applications can be split into the following categories according to their function on a project using BIM.

Third party dependencies:

The BIMportal userguide

There is a more comprehensive user guide inside the live platform. Below is admin guide @todo

Once you have setup the BIMportal you will have admin status on all projects. It is your responsibility to manage users admission on projects. Advise new users to visit the sign-in page and complete registration details. Once complete, you will see their name appear under the users tab in the admin portal. Use the dropdown menu under assign projects to choose which onces they have access to.

To initialise a new project, in the admin tab, select create and complete project details. There is also the option to edit details for existing projects here also. Error: PHP error in offline mode. - check is this the same online? Think that this is tryign to reference google maps. You can also assign a bimsync model project from the edit also.

Perform administrative tasks on applications that are made available to users of the BIMportal through the 'Apps' tab. Set Application name, description, position of the app in the menu bar, categorize application relevance, extend platform capability by adding new PHP module/class and upload Icon to represent app in application selection bar.

More information and some system design considerations from authors

This belongs in a blog-post but can live here for now

The BIMportal is an open source application framework consisting of multiple applications to increase team productivity for teams involved with BIM procurement that want minimum overhead to maintain BIM projects. The initial insentive to developing the tool was to provide a central service to support the platform where a core team would maintain and upgrade all of the BIM data with the help of a the peripheral user base. This means that there would always be a direct line of communication between all users and the operatives where data would be served on demand to the user. This significantly reduces the need for end users to embark on the learning curve required to operate software and give them a more gradual and self learning approach as they observe the functioning system from an external perspective.

Key parameters incorporated into the design of the system included the following:

Todo

License

MIT License

Project contributors

Contributing

We welcome any contributions and are here to help for any developers looking to get started.