Oposed

A rooms and resources-schedule web tool
Report Bug · Request Feature

Table of Contents

1. Table of Contents
2. About The Project
   • Screenshot
   • Built With
3. Getting Started
   • Prerequisites
   • Run example/demo
   • Installation
4. Usage
5. Contributing
6. License

About The Project

This is a selfhosting rooms and resources-schedule web tool.

It was created because most free software is no longer supported. The alternatives usually have a very old, non-intuitive and non-responsive design. Which makes it difficult for users to use.

This room planner was designed in collaboration with several elderly people. To be as intuitive and simple as possible. In addition to managing rooms, it is also possible to organize resources. For example, you need a laptop for the meeting. Which is then automatically marked as taken over this meeting-time.

In addition, there is the possibility to plan meetings publicly for other users. Which allows them to log into the meeting. The users are informed about the offers of open meetings by an automatic newsletter. In which you can set which category of meetings you want to be informed about.

The user administration runs exclusively via an LDAP server, in which two user-groups (admins and users) can be differentiated.

(back to top)

Screenshot

(back to top)

Built With

• 
• 
• 
• 

(back to top)

Getting Started

Just a few steps to run Oposed on your server.

Prerequisites

You need docker and docker-compose. More »

Run example/demo

1. Clone the repo

   git clone https://github.com/Kinderschutzbund-Karlsruhe/Oposed.git

2. Jump into the example-directory

   cd example/

3. Make the script runnable

   chmod +x start.sh

4. Run start.sh

   ./start.sh

5. Open your browser on http://localhost:8080 and log in with one of the following access data:

Role	Mail	Username	Password
Admin	[email protected]	Oposed-Admin	Oposed-Admin
User	[email protected]	oposed-user1	oposed-user1
User	[email protected]	oposed-user2	oposed-user2

You can manage the users over der LDAP-User-Manager under http://localhost:8081/log_in/

Installation

1. Clone the repo

   git clone https://github.com/Kinderschutzbund-Karlsruhe/Oposed.git

2. Open docker-compose.yml and setup your LDAP and SMTP-connection

   nano docker-compose.yml

3. Make the script runnable

   chmod +x start.sh

4. Run start.sh

   ./start.sh

5. Open your browser on http://localhost:80

(back to top)

Usage

(back to top)

Contributing

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)