update readmes

WebApp/README.md

@@ -1,17 +1,59 @@
 # WebApp
 
-Here you may find simple example of `WebApp`. For work of this example you will need one of two things:
+A multiplatform bot (JVM server + JS WebApp) that demonstrates Telegram WebApp integration.
 
-* Your own domain with SSL (letsencrypt is okay)
-* Test account in telegram
+## Functionality
 
-What is there in this module:
+The JVM part hosts a Ktor HTTP server that serves a static WebApp frontend and exposes REST
+endpoints for inline query submission, WebApp data validation, custom emoji status setting, and
+prepared keyboard button management. The JS part is the WebApp itself — a single-page app with a
+button that communicates back to the bot and adapts to the user's Telegram theme and viewport.
 
-* JVM part of this example is a server with simple static webapp sharing and bot which just gives the webapp button to open webapp
-* JS part is the WebApp with one button and reacting to chaged user theme and app viewport
+## Arguments
 
-## How to run
+| Position | Value | Description |
+|----------|-------|-------------|
+| 1 | `BOT_TOKEN` | Telegram bot token |
+| 2 | `WEB_APP_URL` | Public HTTPS URL where the WebApp is hosted |
+| 3 *(optional)* | `PORT` | Port for the Ktor server (default: `8080`) |
+
+Optional flags:
+
+| Value | Description |
+|-------|-------------|
+| `debug` | Enable verbose debug logging |
+| `testServer` | Connect to the Telegram test server instead of production |
+
+## Bot Commands
+
+| Command | Description |
+|---------|-------------|
+| `/reply_markup` | Send a reply keyboard containing a WebApp button |
+| `/inline` | Send an inline keyboard containing a WebApp button |
+| `/attachment_menu` | Send an attachment-menu WebApp button |
+| `/prepareKeyboard` | Retrieve and display the saved prepared inline keyboard button |
+
+## Server Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `POST` | `/inline` | Accept an inline query result submitted from the WebApp |
+| `POST` | `/check` | Validate the `initData` signature sent by the WebApp |
+| `POST` | `/setCustomEmoji` | Set a custom emoji status for the user based on WebApp data |
+| `POST` | `/getPreparedKeyboardButtonId` | Return the ID of a previously saved prepared inline keyboard button |
+
+## Capabilities
+
+- Serves the compiled JS WebApp as static files
+- HMAC-SHA256 validation of Telegram WebApp `initData`
+- Custom emoji status setting via `setUserEmojiStatus`
+- Prepared inline keyboard button saved with `savePreparedInlineMessage`
+- Supports all three WebApp button surfaces: reply keyboard, inline keyboard, attachment menu
+- Requires a domain with valid SSL (or a Telegram test account)
+- JVM server + Kotlin/JS frontend in a single Gradle multiplatform project
+
+## Launch
 
 ```bash
-./gradlew run --args="TOKEN WEB_APP_ADDRESS"
+./gradlew :WebApp:run --args="BOT_TOKEN https://your.domain.com 8080"
 ```