OneGov Cloud ============ Technical Documentation ----------------------- OneGov Cloud is a Swiss initiative to provide municipalities with open-source web-applications. .. image:: _static/govikon.png You reached the technical documentation of this initiative intended for administrators, developers and other technical personnel. To learn more about the product, please refer to `https://www.admin.digital `_. Introduction ------------ OneGov Cloud is a RAD framework built with `Morepath, the web micro-framework with superpowers `_. It enables us to write web applications for government agencies in a secure, efficient, and modern manner. OneGov Cloud has strong opinions about the technology it employs. This has the following consequences: * It only runs on POSIX platforms. * It uses PostgreSQL 10+ and won't support other databases. * It requires Python 3.6+. * It aims to provide concurrency through multiple processes and is not necessarily thread-safe. Internationalization ^^^^^^^^^^^^^^^^^^^^ OneGov Cloud supports many languages and locales. That means that number- date- and other formatting can use the appropriate locale. All static text is translatable. Content is translatable too, though OneGov Cloud doesn’t offer any tools for it at this moment. This is generally a UI problem, not a framework problem. URL paths are not translatable and should use English. Development and documentation is in English. It’s what we are most comfortable with when it comes to software development. Try it! ^^^^^^^ Have a look at OneGov Town, our flagship application: - ``_. Start your own OneGov Town instance for free: - ``_. Documentation Highlights ^^^^^^^^^^^^^^^^^^^^^^^^ Design ++++++ An introduction into the history and the design of OneGov Cloud. .. toctree:: :maxdepth: 2 design Org +++ An introduction to the most fully-featured application of OneGov Cloud. .. toctree:: :maxdepth: 2 org Feriennet +++++++++ An introduction to the most popular application of OneGov Cloud. .. toctree:: :maxdepth: 2 feriennet Formcode ++++++++ Describes our very own Formcode™ Syntax, a DSL to write forms with. .. toctree:: :maxdepth: 2 formcode Source ^^^^^^ OneGov Cloud is open source, available on GitHub: ``_. Further Reading ^^^^^^^^^^^^^^^ Find out more about the inner workings of OneGov Cloud by having a look at the OneGov Cloud modules documentation. .. toctree:: :maxdepth: 2 modules API ^^^ API documentation .. toctree:: :maxdepth: 2 api/api.md