Comment on AI slop and fix ai slop
All checks were successful
Deploy with Docker Compose / deploy (push) Successful in 7s
All checks were successful
Deploy with Docker Compose / deploy (push) Successful in 7s
This commit is contained in:
26
README.md
26
README.md
@@ -4,7 +4,13 @@
|
|||||||
|
|
||||||
Welcome to the source code for my website! Please contact me if you would like to collaborate and thank you for visiting.
|
Welcome to the source code for my website! Please contact me if you would like to collaborate and thank you for visiting.
|
||||||
|
|
||||||
This website is self-hosted on my Raspberry Pi. Any interference and the killswitch will activate and stop the UK national grid power system so please don't tamper with my domain :).
|
This website is self-hosted on my Raspberry Pi. Any interference or hax and the killswitch will activate and stop the UK national grid power system so please don't tamper with my domain :).
|
||||||
|
|
||||||
|
## The use of AI
|
||||||
|
|
||||||
|
This has been created with a heavy amount of AI. Initially, I began with articles from [medium](https://medium.com/) informing me of how to use Nginx to host static sites and reverse proxy to other services. They were incredible helpful and I wish I were able to give credit them, but sadly they were read too long ago.
|
||||||
|
|
||||||
|
After hearing all the hype on LinkedIn and feeling the pressure to keep up a high output without AI, I eventually caved in. There is an immense advantage not having to scan though documentation to find relevant functions, asking how other developers implement their infrastructure and finding what command will achieve your outcome quickly. Sure, it would be good to have that already cached in your own human memory. But my reasoning is that you _will_ have cached it after being reminded by AI enough times, similar to how flashcards work. I may not be an expert in the specific tool, though I've been able to get good enough at it for my own purposes.
|
||||||
|
|
||||||
## Architecture
|
## Architecture
|
||||||
|
|
||||||
@@ -42,9 +48,9 @@ certbot ── SSL Certificate Management (disabled in dev)
|
|||||||
- Real-time chat over WebSockets with image/video uploads
|
- Real-time chat over WebSockets with image/video uploads
|
||||||
- Blog with admin panel (CRUD)
|
- Blog with admin panel (CRUD)
|
||||||
- Activity and rowing session tracking
|
- Activity and rowing session tracking
|
||||||
|
- AI image processing integration to extract rowing data from images (will be superseeded by openCV scanning)
|
||||||
- Fan shrines (GTO, Evangelion, Demoman, Skip Skip Benben)
|
- Fan shrines (GTO, Evangelion, Demoman, Skip Skip Benben)
|
||||||
- Self-hosted Git (Gitea) with CI/CD and commit feed on homepage
|
- Self-hosted Git (Gitea) with CI/CD and commit feed on homepage
|
||||||
- Claude AI integration
|
|
||||||
- Printable CV with role-specific sections
|
- Printable CV with role-specific sections
|
||||||
- SearXNG meta search engine
|
- SearXNG meta search engine
|
||||||
- Hasura GraphQL console
|
- Hasura GraphQL console
|
||||||
@@ -71,7 +77,7 @@ certbot ── SSL Certificate Management (disabled in dev)
|
|||||||
**Playground:** `GET /api/graphql` (when `GQL_PLAYGROUND=true`)
|
**Playground:** `GET /api/graphql` (when `GQL_PLAYGROUND=true`)
|
||||||
|
|
||||||
| Operation | Type | Description |
|
| Operation | Type | Description |
|
||||||
| --- | --- | --- |
|
| ------------------------------------------ | -------- | ----------------------- |
|
||||||
| `users` | Query | Get all users |
|
| `users` | Query | Get all users |
|
||||||
| `user(id)` | Query | Get user by ID |
|
| `user(id)` | Query | Get user by ID |
|
||||||
| `me` | Query | Get authenticated user |
|
| `me` | Query | Get authenticated user |
|
||||||
@@ -80,6 +86,10 @@ certbot ── SSL Certificate Management (disabled in dev)
|
|||||||
| `activities` | Query | Get all activities |
|
| `activities` | Query | Get all activities |
|
||||||
| `favorites` | Query | Get all favorites |
|
| `favorites` | Query | Get all favorites |
|
||||||
| `rowingSessions` | Query | Get all rowing sessions |
|
| `rowingSessions` | Query | Get all rowing sessions |
|
||||||
|
| `post(id)` | Query | Get post by ID |
|
||||||
|
| `activities` | Query | Get all activities |
|
||||||
|
| `favorites` | Query | Get all favorites |
|
||||||
|
| `rowingSessions` | Query | Get all rowing sessions |
|
||||||
| `messages` | Query | Get all messages |
|
| `messages` | Query | Get all messages |
|
||||||
| `spotifyListening` | Query | Currently playing track |
|
| `spotifyListening` | Query | Currently playing track |
|
||||||
| `spotifyRecent` | Query | Recently played tracks |
|
| `spotifyRecent` | Query | Recently played tracks |
|
||||||
@@ -154,7 +164,7 @@ certbot ── SSL Certificate Management (disabled in dev)
|
|||||||
### Nginx Proxy Routes
|
### Nginx Proxy Routes
|
||||||
|
|
||||||
| Route | Target | Notes |
|
| Route | Target | Notes |
|
||||||
| --- | --- | --- |
|
| ---------- | ------------ | --------------------------- |
|
||||||
| `/api` | backend:8080 | API (rate limited: 30r/s) |
|
| `/api` | backend:8080 | API (rate limited: 30r/s) |
|
||||||
| `/radio` | icecast:8000 | Audio streaming |
|
| `/radio` | icecast:8000 | Audio streaming |
|
||||||
| `/gitea` | gitea:3000 | Git service |
|
| `/gitea` | gitea:3000 | Git service |
|
||||||
@@ -174,7 +184,7 @@ certbot ── SSL Certificate Management (disabled in dev)
|
|||||||
Create a `.env` file in the project root. All services read from this file.
|
Create a `.env` file in the project root. All services read from this file.
|
||||||
|
|
||||||
| Variable | Description |
|
| Variable | Description |
|
||||||
| --- | --- |
|
| --------------------------------- | ------------------------------------------------------------------------------- |
|
||||||
| `POSTGRES_USER` | PostgreSQL username |
|
| `POSTGRES_USER` | PostgreSQL username |
|
||||||
| `POSTGRES_PASSWORD` | PostgreSQL password |
|
| `POSTGRES_PASSWORD` | PostgreSQL password |
|
||||||
| `POSTGRES_DB` | Main app database name |
|
| `POSTGRES_DB` | Main app database name |
|
||||||
@@ -248,9 +258,6 @@ The Docker entrypoint handles environment variable substitution (`${BASE_URL}`,
|
|||||||
|
|
||||||
### Spotify Token Setup
|
### Spotify Token Setup
|
||||||
|
|
||||||
1. Create a Spotify app at [developer.spotify.com](https://developer.spotify.com/dashboard) and set the redirect URI to `https://www.<DOMAIN>/api/spotify/callback`
|
|
||||||
2. Set `SPOTIFY_CLIENT_ID`, `SPOTIFY_CLIENT_SECRET`, `SPOTIFY_REDIRECT_URI`, and `SPOTIFY_AUTH_STATE` in `.env`
|
|
||||||
3. Start the stack, then visit the Spotify auth URL logged by the backend on startup to authorize the app
|
|
||||||
4. After authorization, Spotify redirects to the callback endpoint which stores tokens at `/backend/token/spotify_token.json`
|
4. After authorization, Spotify redirects to the callback endpoint which stores tokens at `/backend/token/spotify_token.json`
|
||||||
5. Tokens are refreshed automatically; the file persists across container restarts via volume mount
|
5. Tokens are refreshed automatically; the file persists across container restarts via volume mount
|
||||||
|
|
||||||
@@ -292,6 +299,7 @@ docker compose -f docker-compose.yml -f docker-compose.dev.yml up --build
|
|||||||
```
|
```
|
||||||
|
|
||||||
This:
|
This:
|
||||||
|
|
||||||
- Uses an HTTP-only Nginx config with all routing (SPA, backend proxy, radio, gitea, etc.)
|
- Uses an HTTP-only Nginx config with all routing (SPA, backend proxy, radio, gitea, etc.)
|
||||||
- Generates a self-signed certificate for localhost
|
- Generates a self-signed certificate for localhost
|
||||||
- Disables certbot
|
- Disables certbot
|
||||||
@@ -314,7 +322,7 @@ Vite dev server proxies `/api` to `localhost:8080`, `/gitea` to `localhost:3000`
|
|||||||
These files are git-ignored and must be created manually:
|
These files are git-ignored and must be created manually:
|
||||||
|
|
||||||
| File | Notes |
|
| File | Notes |
|
||||||
| --- | --- |
|
| ------------------------------- | --------------------------------------------------------------- |
|
||||||
| `.env` | See setup section above |
|
| `.env` | See setup section above |
|
||||||
| `gitea/config/app.ini` | Copy from `app.ini.template` or let entrypoint generate it |
|
| `gitea/config/app.ini` | Copy from `app.ini.template` or let entrypoint generate it |
|
||||||
| `searxng/settings.yml` | Copy from `settings.yml.template` or let entrypoint generate it |
|
| `searxng/settings.yml` | Copy from `settings.yml.template` or let entrypoint generate it |
|
||||||
|
|||||||
Reference in New Issue
Block a user