From 5eb3a9add9e2afb0ed80e7f342b661bf1d712c09 Mon Sep 17 00:00:00 2001
From: Mamata Balakatte <mbalakatte@gmail.com>
Date: Mon, 1 Jun 2026 17:36:43 +0530
Subject: [PATCH 1/2] Enhance README with service details and future plans

Added sections on how the service works, security features, and future improvements.
---
 README.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/README.md b/README.md
index cb00af79..3accb986 100644
--- a/README.md
+++ b/README.md
@@ -58,9 +58,36 @@ make lint         # run static analysis
 ├── cmd/goboxd/   binary entry point
 ├── internal/     private application packages
 ├── docs/         api, languages, security, benchmarks, architecture
+
 └── tests/        integration tests
 ```
 
+
+## How It Works
+
+1. A user sends source code through an HTTP request.
+2. The service creates an isolated sandbox.
+3. The code is compiled and executed safely.
+4. Resource limits are enforced.
+5. Execution results are returned to the user.
+
+## Security Features
+
+- Linux namespaces
+- cgroups isolation
+- Resource limits
+- Bounded concurrency
+- Containerized execution
+
+## Future Improvements
+
+- Support additional programming languages
+- Web dashboard
+- Authentication and authorization
+- Execution history
+- Kubernetes deployment
+
+
 ## Contributing
 
 Contributions are welcome. Open an issue to discuss substantial changes before sending a pull request.

From 46672d147c840ca4a440e62b6b796ece84740c5b Mon Sep 17 00:00:00 2001
From: Mamata Balakatte <mbalakatte@gmail.com>
Date: Mon, 1 Jun 2026 17:37:32 +0530
Subject: [PATCH 2/2] Add architecture documentation

---
 docs/ARCHITECTURE.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 docs/ARCHITECTURE.md

diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
new file mode 100644
index 00000000..68c7470a
--- /dev/null
+++ b/docs/ARCHITECTURE.md
@@ -0,0 +1,27 @@
+# Architecture
+
+## Request Flow
+
+User
+  ↓
+HTTP API
+  ↓
+Sandbox Manager
+  ↓
+Language Runtime
+  ↓
+Execution Result
+
+## Components
+
+### HTTP API
+Receives execution requests.
+
+### Sandbox Manager
+Creates isolated execution environments.
+
+### Language Runtime
+Compiles and executes code.
+
+### Result Handler
+Returns output and errors.