[doc] Change label from kibicara to ticketfrei

CONTRIBUTING.md

@@ -1,4 +1,4 @@
-# Kibicara Contribution HowTo
+# Ticketfrei Contribution HowTo
 
 
 ## Setup Development Environment
@@ -18,8 +18,8 @@
 
 #### Cheatsheet
 
-- Install Kibicara with `pip install .`
+- Install Ticketfrei with `pip install .`
-- Execute Kibicara with `kibicara -f kibicara.conf`
+- Execute Ticketfrei with `kibicara -f kibicara.conf`
     (verbose: `kibicara -vvv -f kibicara.conf`)
 - Interact with Swagger REST-API Documentation: `http://localhost:8000/api/docs`
 - Test and stylecheck with `tox`
@@ -83,8 +83,8 @@ following pattern:
 
 You can use these tags:
 
-- [core] Feature for Kibicara core
+- [core] Feature for Ticketfrei core
-- [frontend] Feature for Kibicara frontend
+- [frontend] Feature for Ticketfrei frontend
 - [$platform] Feature for platforms, e.g.
     - [twitter]
     - [telegram]
@@ -128,29 +128,17 @@ development team.
 
 ## How to implement a new Platform/Social Network
 
-For transferring messages, Kibicara supports a range of platforms/social
+### tl;dr
-networks, e.g. Mastodon, E-Mail, and Telegram - but more can be added easily.
-This guide explains what you need to do to add another platform, e.g. Matrix or
-XMPP.
 
-### Overview:
+1. Implement the following modules in `platforms/<your-platform>/`:
-
-1. Implement the backend modules in `platforms/<your-platform>/`:
   - `bot.py`
   - `model.py`
   - `webapi.py`
 2. Import your bot in `kibicara/webapi/__init__.py`.
-3. Generate the FastAPI boilerplate code
+3. Generate the FastAPI stuff
-4. Generate the angular boilerplate code
+4. Generate the angular components for the kibicara-frontend from the FastAPI stuff
-5. Copy-paste frontend components from other bots into the angular boilerplate
-   and adjust them to your needs
 
-At the bottom you can find a checklist what your pull request needs to be
+### Explanation
-merged into kibicara.
-
-### Step by step
-
-#### Implement the backend modules
 
 In `kibicara/platforms/<your-platform>/bot.py`, you write the functions through
 which the platform asks the social network for new messages, and publishes
@@ -166,96 +154,20 @@ You will probably need to store the following things:
 * platform-specific settings
 * anything else your platform needs
 
-In `kibicara/platforms/<your-platform>/webapi.py`, you can define REST API
+In `kibicara/platforms/<your-platform>/webapi.py`, you can define HTTP routes.
-routes. You will need them to:
+You will need them to:
 
 * let admins authenticate to the social network in the kibicara web interface
 * update platform-specific settings
 
-#### Import your bot into the kibicara REST API
-
 To run the platform, you need to import the bot in
-`kibicara/webapi/__init__.py`. You can see how the other platforms did it.
+`kibicara/webapi/__init__.py`.
-
-#### Generate the FastAPI boilerplate code
-
-Whenever you changed the REST API in the backend, you need to re-generate the
-FastAPI boilerplate code:
-
-   1. Start backend with `kibicara > /dev/null 2>&1 &`
-   2. Go to the frontend directory: `cd frontend`
-   3. Use this command to download the openapi.json from the backend and
-      generate the boilerplate: `npm run openapi-generator`
-   4. (Now you can stop the backend again, e.g. with `pkill kibicara`)
-   5. Append `/api` to all relevant URLs:
-      `find src/app/core/api/ -type f -exec sed -i "s#{this.configuration.basePath}#{this.configuration.basePath}/api#g" {} +`
-   6. Check if everything is okay (e.g. all api calls need the `/api` prefix)
-
-#### Generate the Angular boilerplate code
-
-##### Generate the platform-specific "public facing" page
-
-Generate boilerplate "card" for myplatform:
-
-```
-ng generate component platforms/myplatform/myplatform-bot-card
-```
-
-Generate boilerplate for the popup that shows the users the guide on how to use
-the bot:
-
-```
-ng generate component platforms/myplatform/myplatform-bot-card/myplatform-bot-info-dialog
-```
-
-##### Generate the platform-specific "settings" page
-
-Generate bot card for settings page:
-
-```
-ng generate component platforms/myplatform/myplatform-settings
-```
-
-Generate popup that will show when you click on "Add" to add the myplatform
-credentials (e.g. login data, api tokens etc):
-
-```
-ng generate component platforms/myplatform/myplatform-settings/mastodon-dialog
-```
-
-If something does not work, try to check `platforms.module.ts` and check if the
-module was imported there. Every module needs to be imported there
-
-#### Adjust the Angular code for your specific platform
-
-Every frontend part for a bot has a similar structure. Basically copy the
-content of the other files e.g. the telegram bot into the generated boilerplate
-above and search and replace all occurrences with `myplatform`. You can see
-the UI with `ng s -o`, it will auto-update on code change.
-
-A component in angular has 3-4 files, only these ones ending with
-`*.component.ts` (typescript) and `*.component.html`(html) are important for
-us. Basically the typescript controls what is shown in the html. Please correct
-every error that stops the angular page build or shows up on the page while you
-go, otherwise this can become a mess.
-
-With that in mind, first write the logic to call the /create endpoint:
-- `src/app/platforms/myplatform/myplatform-settings/myplatform-dialog/myplatform-dialog.component.ts`:
-  implement the form to take the user inputs and the onSubmit() function
-- `src/app/platforms/myplatform/myplatform-settings/myplatform-dialog/myplatform-dialog.component.html`:
-  implement the html skeleton that takes the form from the user
-
-Then, fix up the public user facing page:
-- `src/app/platforms/myplatform/myplatform-bot-card/myplatform-bot-info-dialog/myplatform-bot-info-dialog.component.html`
-
-Finally, check the other typescript and html pages and adjust e.g. the tutorial
-text for the users.
 
 ### Acceptance criteria for bots (Checklist)
 
 A bot should have at least this functionality:
 
-- Kibicara REST API (hood admins):
+- Ticketfrei REST API (hood admins):
     - Endpoint for creating a bot associated with a hood
     - Endpoint for deleting a bot associated with a hood
     - Endpoint for updating a bot associated with a hood by id
@@ -288,10 +200,4 @@ A bot should have at least this functionality:
         - e.g. Telegram via direct message from the bot
         - e.g. E-Mail via e-mail to the user's address
 
-- Web Interface (hood admins and users)
+- Web Interface (hood admins)
-    - A card which allows hood admins to add, configure, start, stop, and
-      delete a platform to their hood
-    - A pop-up which explains to hood admins how to configure the platform
-    - A card which allows users to subscribe on a platform or links to the
-      platform's account
-    - A pop-up which explains to users how to use the platform

COPYING

@@ -3,6 +3,7 @@ Copyright (C) 2020 by Cathy Hu <cathy.hu@fau.de>
 Copyright (C) 2020 by Christian Hagenest <c.hagenest@pm.me>
 Copyright (C) 2020 by Martin Rey <martin.rey@mailbox.org>
 Copyright (C) 2020 by Maike <maike@systemli.org>
+Copyright (C) 2022 by missytake <missytake@systemli.org>
 
 Permission to use, copy, modify, and/or distribute this software for any purpose
 with or without fee is hereby granted.

DEPLOYMENT.md

@@ -48,7 +48,7 @@ export const environment = {
 - Build frontend with `cd kibicara/kibicara-frontend && ng build --prod`
 - Copy the generated frontend to your server to `/home/kibicara/kibicara-frontend`: `scp -r kibicara/kibicara-frontend/dist/kibicara-frontend <your_server>:/home/kibicara`
 
-### Configure Kibicara Core
+### Configure Ticketfrei Core
 - Write config file to `/etc/kibicara.conf` and replace the domain with yours:
 ```
 database_connection = 'sqlite:////home/kibicara/kibicara.sqlite'
@@ -59,7 +59,7 @@ frontend_url = 'https://kibicara.example.com'
 #### SSL
 You can use the SSL stuff provided by hypercorn by generating an SSL Certificate and passing its paths to the config options `certfile` and `keyfile` in `/etc/kibicara.conf`.
 
-### Configure Kibicara platforms
+### Configure Ticketfrei platforms
 
 #### Configure E-Mail (OpenSMTPd + Relay)
 To send and receive e-mails (necessary for registration confirmation and e-mail bot) you will need an MTA. We use OpenSMTPd:
@@ -105,5 +105,5 @@ consumer_secret = '<your_consumer_secret>'
 #### Configure Telegram
 Nothing to do, because telegram has a nice API.
 
-### Start Kibicara
+### Start Ticketfrei
 Run `kibicara` with your kibicara user. To have more verbose output add `-vvv`.

README.md

@@ -1,9 +1,9 @@
-![Angular Frontend](https://github.com/acipm/kibicara/workflows/Angular%20Frontend/badge.svg)
+![Angular Frontend](https://git.0x90.space/ticketfrei/ticketfrei3/workflows/Angular%20Frontend/badge.svg)
-![Python Backend](https://github.com/acipm/kibicara/workflows/Python%20Backend/badge.svg)
+![Python Backend](https://git.0x90.space/ticketfrei/ticketfrei3/workflows/Python%20Backend/badge.svg)
 
-# Kibicara
+# Ticketfrei 3
 
-Kibicara relays messages between different platforms (= social networks).
+Ticketfrei relays messages between different platforms (= social networks).
 
 In its web interface, a hood admin (= registered user) can create a hood to
 build a connection between different platforms.
@@ -11,18 +11,18 @@ build a connection between different platforms.
 Users can message a specific hood account on a specific platform (e.g. @xyz on
 Telegram). This pushes the announcement to all platform accounts of a hood.
 For example: User A writes a message to @xyz on Telegram (which has been
-connected to Kibicara by a hood admin). This publishes the message on e.g.
+connected to Ticketfrei by a hood admin). This publishes the message on e.g.
 Twitter and other platforms which have been connected to the hood.
 
 The admin of a hood has to define trigger words and bad words. Messages need to
 contain a trigger word to be relayed, and must not contain a bad word.
 
-Kibicara needs to be hosted on a server by an instance maintainer. That way,
+Ticketfrei needs to be hosted on a server by an instance maintainer. That way,
 hood admins don't need a server of their own.
 
-## Deploy Kibicara on a production server
+## Deploy Ticketfrei on a production server
 
-Read `DEPLOYMENT.md` to learn how to deploy Kibicara.
+Read `DEPLOYMENT.md` to learn how to deploy Ticketfrei.
 
 ## Contribute!