Phonebook
by T-Systems Multimedia Solutions GmbH
:question: What is the Phonebook?
The Phonebook is a community project for us, from us and everybody is welcome to participate.
This Single-Page-Application is able to display People, Rooms and the organization structure. It is perfect to search for people in a company, get information where they sit in your building and how to contact them.
:arrow_forward: View the live demo on https://demo-phonebook.aquiver.de/.
:wave: New to the Phonebook?
We are always searching for new contributors who want to be a part of a growing community. The contribution benefits are huge. You can learn a lot about the technologies displayed below, bring new ideas into the project, connect with new people from different departments and learn how it is to be an OpenSource-Developer.
You're not interested in developing and just want to know more about how to use the software? :beginner: Right this way
:mag: You want to be a part of this community?
You can contribute with any skill or use this project to evolve your techniques.
If you're not interested in developing but want to help you can submit new issues or contact one of the {{site.contributors}}.
If you're interested in developing check out the following links.
View some other examples to contribute
- Review Pull Requests
- Test the Application and suggest new enhancements or report new bugs
- Design a cool Phonebook-Logo
- Develop a new User-Centered Design
- Provide Accessibility
- Write a User-Guide
Note that you also can keep an eye on our
good first issue-Badge. This Label shows that the issue can be perfect to dive into the project.
> If you're a part of T-Systems MMS you can also take a look at the internal get-started page.
## **:electric_plug: Technologie overview**
The project makes use of the following noteworthy frameworks:
Frontend Frameworks
- Angular: The popular JavaScript framework is the base of this application. We also use the Angular routing for navigation to different views.
- Angular CLI: Makes development and the build process of the application much easier. It encapsulates the Webpack build configuration and provides some reasonable conventions to follow instead. The CLI also provides some convenient commands to generate new components, services, etc.
- Angular Material: Provides components to build an application with Google's Material design. We use it as a basis for our graphical layout.
Backend Frameworks
## :earth_americas: **The Community**
| :pencil2: [Contributors ](https://github.com/T-Systems-MMS/phonebook/graphs/contributors) | :gear: [Maintainer ](https://github.com/T-Systems-MMS/phonebook/blob/master/.github/CODEOWNERS) |
| :---------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------: |
| Anyone who participates in any way to the community | Voluntarily takes over the coordination of a work package, a milestone or a topic |
| This can be: develop new features, fix bugs, write documentation or review pull requests. | Controls the contributors and supports the onboarding |
| | Is responsible for the quality of the respective work package |
| | Becomes visible as an expert |
And a big thanks to all other contributors of [T-Systems MMS](https://github.com/T-Systems-MMS).
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
## **:sparkles: Need Help?**
If you still have questions feel free to contact us under [phonebook-t-systems-mms@mg.telekom.de](mailto:phonebook-t-systems-mms@mg.telekom.de).
## **:computer: Supported Browsers**
| Browser | Support | [Offline Capability](https://caniuse.com/#feat=serviceworkers) | Comment |
| ------- | :-------: | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Chrome | β Working | β Working | |
| FireFox | β Working | β Not Working (activate in ESR via Feature Flag or available from Firefox 61 upwards) | There might be a Bug. |
| Safari | β Working | β Not Supported yet | Service Worker are not available yet: https://bugs.webkit.org/show_bug.cgi?id=174541 |
| Edge | β Working | β Not Supported (available from Edge Version 17 upwards) | |
> We do not support Internet Explorer.
## **:page_with_curl: License**
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details