[GENESIS] updated architecture

.github/workflows/pr-title-check.yml

@@ -19,7 +19,7 @@ jobs:
         run: |
           echo "Checking PR title: $PR_TITLE"
 
-          if [[ "$PR_TITLE" =~ ^\[(CHORE|REFACTOR|DOCUMENT|FEATURE|GENESIS|BUG|DUPLICATE)\]\  ]]; then
+          if [[ "$PR_TITLE" =~ ^\[(CHORE|REFACTOR|DOCUMENT|FEATURE|GENESIS|BUG|DUPLICATE|BOT)\]\  ]]; then
             echo "PR title format is valid."
             exit 0
           fi
@@ -33,4 +33,5 @@ jobs:
           echo "  [GENESIS] ..."
           echo "  [BUG] ..."
           echo "  [DUPLICATE] ..."
+          echo "  [BOT] ..."
           exit 1

.gitignore

@@ -5,15 +5,21 @@ linuxusctl
 debug/
 
 # Data file directory likely authentication info, user data, etc.
-data/
+/data
 
 # User volumes for services, e.g., home directories, shared directories, etc.
-volumes/
+/volumes
 
 # Logs and temporary files.
 logs/
 tmp/
 temp/
 *.log
 *.tmp
-*.temp
+*.temp
+
+# Deployment settings may contain local secrets; defaults live in the source tree.
+/.env
+
+# Python migration helper/test bytecode.
+__pycache__/

README.md

@@ -1,6 +1,6 @@
 # LINUXUS
 
-<p align=center><img width="250" src="./doc/fig/logo.png"/></p>
+<p align=center><img width="250" src="./docs/figs/logo.png"/></p>
 <p align=center><i>Linuxus, a Docker-based service that provides Ubuntu shell environments via a web browser for Linux education</i></p>
 
 ---
@@ -13,13 +13,14 @@ Linuxus enables instructors to provide per-user Linux environments without requi
 🌐 Web-based shell access (no SSH required)  
 📁 Per-user persistent storage  
 🔒 Resource and permission control  
-⚙️ Fully configurable via YAML  
+📦 Single binary deployment with embedded defaults and system-wide storage<br>
+⚙️ Configure via `.env`, generated by `linuxusctl init`<br>
 
 ---
 
 ## 🚀 Usage
 
-Refer to the [Usage documentation](./doc/USAGE.md) for instructions on how to use this program.
+Refer to the [Usage documentation](./docs/USAGE.md) for installation and the [Operations guide](./docs/OPERATIONS.md) for diagnostics, recovery, accounts, backups, classroom templates, and the admin interface.
 
 ---
 
@@ -50,6 +51,6 @@ Please refer to [SECURITY.md](./SECURITY.md) for responsible disclosure instruct
 
 ---
 
-## 🚧 Upcoming Features
+## Operations
 
-Nothing TODO.
+Operational diagnostics, systemd recovery, account management, backups and restores, resource limits, classroom templates, and an administrator interface are available. See [Operations](./docs/OPERATIONS.md).