Merge pull request #2 from BlackRoad-OS/blackboxprogramming-patch-1

Add detailed README with API Gateway description, table, and roadmap

README.md

@@ -1,2 +1,38 @@
-# blackroad-os-api
+# BlackRoad OS — API Gateway  
-Create a minimal Operator service skeleton:  - app/: FastAPI or plain Python entrypoint with a /health endpoint - workers/: placeholder module for background jobs and agent orchestration - infra/: Dockerfile, requirements.txt, and a sample railway.toml with no secrets Use simple placeholder code only. Do not add complex business logic.
+
+## Short Description  
+
+Unified FastAPI backend for routing, auth, services, and shared API contracts.  
+
+## Long Description  
+
+API Gateway is the canonical service defining routes, schemas, validation, identity tokens, auth flows, and service-to-service communication. Every other component — Web, Prism, Core, Operator — calls into this.  
+
+## Structured Table  
+
+| Field          | Value                                   |  
+| -------------- | --------------------------------------- |  
+| **Purpose**    | Routing, shared schemas, identity, auth |  
+| **Depends On** | None (root backend)                     |  
+| **Used By**    | All components                          |  
+| **Owner**      | Cece + Alexa                            |  
+| **Status**     | Active — always evolving                |  
+
+## Roadmap Board (API)  
+
+Columns:  
+
+* **Schema Planning**  
+* **Routes**  
+* **Auth**  
+* **Testing**  
+* **Deploy**  
+* **Stable**  
+
+Sample tasks:  
+
+* /health and version endpoints  
+* Identity/token lifecycle  
+* Route coverage expansion  
+* Agent protocol endpoints  
+* Pocket OS API handler