EN /HU | Login

TTG Mail BBS

The post office of the BBS network: letters between the accounts. Log in with your account of the network, open your mailbox, write to anyone with an account, read and answer your letters, and block a writer you do not want to hear from. The post office has a wall too, and a desk for a word to the sysops.

Live at teletypegames.org:2335, in the browser on bbsweb, and through TTG Gate BBS

Overview

A Ruby app on the rubbs gem and ttg-common, like every board of the network. The board keeps no data of its own: the accounts, the letters, the wall and the feedback live on TTG Gate BBS, the network's Central, and the board asks it.

It has two faces on one port:

  • Modern: ANSI colours, menus and the mouse (SyncTERM, NetRunner, PuTTY, bbsweb). The MAIL logo on the desktop, a menubar, and each screen (the mailbox, a letter, the editor) on the whole line. The status line says how many letters are new.
  • Commodore 64: PETSCII on a 40×25 screen, for a C64 terminal program (CCGMS, Novaterm, UltimateTerm) behind a WiFi modem. A cursor menu, the letters as numbered lists, a letter in pages, the new ones counted on the menu.

A call starts with rubbs' Rubbs::Common::Call::Terminal question (RETURN takes the guess, 1 picks the modern face, 2 the C64), then the TTG logo and Login | Register | Guest. Through TTG Gate BBS neither comes twice, and a caller logged in on the gate arrives logged in.

Using it

On a modern terminal:

Key Action
F2 Mail › Mailbox
F3 Mail › The wall
F7 Mail › Write to the sysops
You › Profile Log in, register, your account
F10 The menu
Alt-X Log off

On a Commodore 64 the main menu is M mailbox (with the number of new letters), W the wall, F write to the sysops, P profile, and log off.

The mailbox

The mailbox is ttg-common's TTG::PrivateMessage, the same on both faces:

  • The letters to you, newest first, a new one marked (new); Sent letters switches to the letters you wrote, a list of their own.
  • A letter taken is shown whole, with its writer, its addressee, the time and the board it was written on, and so marked read. Then Reply (the subject gets Re:), Delete, or Block the sender (K): the writer's next letters are refused as if there were no such account.
  • Write a letter: the account to write to, the subject on a line, then the letter in the full-screen editor, up to 4000 characters.
  • Accounts only: a guest is told to log in or make an account in the profile.

The Central keeps the limits: one letter in 30 seconds and 50 a day an account, and no letter to a banned account. The board's words for the screen are in lib/content/mail.yml, over ttg-common's defaults (the C64 texts under petscii:).

The wall is the post office's own (ttg-common TTG::Wall, words in lib/content/wall.yml): callers write notes and answer each other, an account under its name, a guest marked (guest). Write to the sysops is ttg-common's TTG::Feedback, read on the sysops' feedback desk.

Configuration and data

Variable Default
BBS_PORT 2323 the telnet port (boards.yml sets 2335, inside the container too)
BBS_MAX_SESSIONS 100 callers at once (boards.yml sets 50)
TTG_CENTRAL_URL http://ttg-gate-bbs:8090 the network's Central (TTG Gate BBS) on the interstack network
RUBBS_AUTH_SECRET — the secret every board of the network shares, in .env on the server

The board keeps nothing of its own: the letters are in data/messages.sqlite3 on TTG Gate BBS, the wall and the feedback there too. Without the Central the board still answers, and says the mail cannot be reached now.

Under the hood

It runs as boards/ttg-mail of bbs/ttg-bbs, in the shared ttg-bbs container; its data is in /srv/stacks/ttg-bbs/boards/ttg-mail/data and stays between deploys. A push to master of bbs/ttg-bbs deploys it from Woodpecker (ci-deploy ttg-bbs); a change only in boards/ttg-mail restarts only this board. Its log lines are in docker logs ttg-bbs, with "board":"ttg-mail-bbs". Its memory limit in boards.yml is 160 MB.

The code follows the house layering: lib/domain (MailboxSummaryModel, MailService for a caller's mailbox at a glance, the composition root TTGMailBBS) knows nothing of telnet, and lib/ui holds UI::Modern (a rubbs Rubbs::Modern::Application) and UI::Petscii (a Rubbs::Petscii::Face). The mailbox, the wall and the feedback screens are ttg-common's; bbs.rb puts them together with Rubbs.board.