projects:anetbbs:architecture
Table of Contents
ANet BBS — Architecture
ANet follows a modular, event-driven architecture built on Python’s asyncio framework.
High-Level Design
- One asyncio event loop
- One coroutine per connected user (node)
- No threads
- Non-blocking I/O everywhere
Core Components
| Component | Description |
|---|---|
| server/telnet.py | TCP listener + Telnet IAC handling |
| server/session.py | Per-user state machine |
| server/terminal.py | MCI → ANSI rendering engine |
| server/database.py | SQLite access layer |
| sysop/main.py | PyQt6 SysOp Control Panel |
Session Model
Each user connection creates a BBSSession coroutine:
- CONNECT
- LOGIN (handle/password)
- MAIN MENU
- COMMAND LOOP
- LOGOFF
State transitions are explicit and readable.
Text Rendering
ANet supports CNet-style MCI escape codes using `\x19` as a control prefix.
Examples:
- `\x19n1` → New line
- `\x19c6` → ANSI cyan
- `\x19hc` → Clear screen
This allows reuse of original `bbstext.txt` files.
projects/anetbbs/architecture.txt · Last modified: by freedomotter