Documentation (minmatarfleet#745)

README.md

@@ -1,6 +1,12 @@
 # minmatar.org
 Platform for Minmatar Fleet
 
+# Technical Architecture
+The [my.minmatar.org](https://my.minmatar.org/) site is built with a [JavaScript/Astro](https://astro.build/) front-end and a [Python/Django](https://www.djangoproject.com/) back-end. It is deployed as a set of [Docker](https://www.docker.com/) containers to a bare-metal cloud host using Docker Compose. The backend uses a MariaDB database, and there is also a Redis cache instance.
+
+Authentication is handled via single-sign-on with [Discord](https://discord.com/), and the site also integrates with the [Eve Swagger Interface](https://esi.evetech.net/ui/#/).
+
+The source code is hosted on GitHub, and the CI/CD pipeline is built using GitHub Actions. Operational monitoring is implemented using [Sentry](https://minmatar-fleet.sentry.io/).
 # Prerequisites
 - Install Python
 - Install Docker and Docker Desktop (Mac, WSL)

docs/auth-sequence.txt

@@ -0,0 +1,27 @@
+title Minmatar.org Authentication Sequence
+
+actor Browser
+participant "Front-end\n(Astro)" as FrontEnd
+participant "Back-end\n(Django)" as BackEnd
+database Database
+boundary Discord
+
+Browser->FrontEnd: Get home page
+FrontEnd->Browser: Home page with login icon
+Browser->BackEnd: /users/login
+BackEnd->Browser: Redirect to Discord
+Browser->Discord: oauth2/authorize
+Discord->Browser: Redirect to callback API {with code}
+Browser->BackEnd: /users/callback {code}
+BackEnd->Discord: Get access token {with code}
+Discord->BackEnd: Access token
+BackEnd->>Database: Save discord+django users
+BackEnd->Browser: Redirect to frontend login {with token}
+Browser->FrontEnd: /users/login {token}
+FrontEnd->Browser: Logged-in page
+Browser->Browser: Store token in cookie
+Browser->FrontEnd: Get page with data {token}
+FrontEnd->BackEnd: Get backend data {token}
+BackEnd->BackEnd: Validate token
+BackEnd->FrontEnd: JSON content
+FrontEnd->Browser: HTML content