Add comprehensive documentation for project structure, Pydantic architecture, quick start guide, troubleshooting, and unified architecture

- Created PROJECT_STRUCTURE.md detailing the organization of backend, frontend, tests, and documentation files.
- Introduced PYDANTIC_ARCHITECTURE.md explaining the use of Pydantic for type safety, schema generation, and validation in the backend.
- Added QUICKSTART.md for easy setup instructions to run the application in under 5 minutes.
- Developed TROUBLESHOOTING.md to address common issues encountered during setup and development.
- Established UNIFIED_ARCHITECTURE.md to describe the zero-duplication approach for REST and MCP integration using shared metadata.

Signed-off-by: Andre Bossard <anbossar@microsoft.com>

Author: abossard

README.md

@@ -13,6 +13,18 @@
 - Frontend: React 18, Vite, FluentUI components, feature-first structure under `frontend/src/features`
 - Tests: Playwright E2E (`tests/e2e/app.spec.js`)
 
+## Documentation
+
+All deep-dive guides now live under `docs/` for easier discovery:
+
+- [Quick Start](docs/QUICKSTART.md) – fastest path from clone to running servers
+- [Learning Guide](docs/LEARNING.md) – principles behind the architecture and code style
+- [Project Structure](docs/PROJECT_STRUCTURE.md) – file-by-file overview of the repo
+- [Pydantic Architecture](docs/PYDANTIC_ARCHITECTURE.md) – how models, validation, and operations fit together
+- [Unified Architecture](docs/UNIFIED_ARCHITECTURE.md) – REST + MCP integration details and extension ideas
+- [Troubleshooting](docs/TROUBLESHOOTING.md) – common issues and fixes for setup, dev, and tests
+
+
 ## 5-minute quick start (TL;DR)
 1. Clone the repo: `git clone <your-fork-url> && cd python-quart-vite-react`
 2. Run the automated bootstrap: `./setup.sh` (creates the backend venv, installs frontend deps, installs Playwright)

LEARNING.md docs/LEARNING.mdLEARNING.md renamed to docs/LEARNING.md

@@ -55,10 +55,14 @@ python-quart-vite-react/
 ├── setup.sh                     # Automated setup script
 ├── start-dev.sh                 # Development server launcher
 │
-├── README.md                    # Main documentation
-├── QUICKSTART.md               # Quick start guide
-├── LEARNING.md                 # Learning guide and principles
-└── PROJECT_STRUCTURE.md        # This file
+├── docs/                       # Supplemental documentation
+│   ├── LEARNING.md             # Learning guide and principles
+│   ├── PROJECT_STRUCTURE.md    # This file
+│   ├── PYDANTIC_ARCHITECTURE.md # Deep dive into Pydantic models
+│   ├── QUICKSTART.md           # Quick start guide
+│   ├── TROUBLESHOOTING.md      # Common issues and fixes
+│   └── UNIFIED_ARCHITECTURE.md # REST + MCP architecture guide
+└── README.md                   # Main documentation
 ```
 
 ## File Purposes
@@ -111,10 +115,13 @@ python-quart-vite-react/
 
 | File | Purpose |
 |------|---------|
-| `README.md` | Complete documentation with setup instructions |
+| `../README.md` | Complete documentation with setup instructions |
 | `QUICKSTART.md` | Fast setup guide for quick start |
 | `LEARNING.md` | Explains code principles and patterns |
 | `PROJECT_STRUCTURE.md` | This file - project organization |
+| `PYDANTIC_ARCHITECTURE.md` | Deep dive into Pydantic models and validation |
+| `UNIFIED_ARCHITECTURE.md` | Unified REST + MCP architecture reference |
+| `TROUBLESHOOTING.md` | Common setup, dev, and test fixes |
 
 ### Scripts
 
@@ -230,6 +237,6 @@ If a file grows beyond these guidelines, consider splitting it into smaller modu
 ## Questions?
 
 Refer to:
-- [README.md](README.md) for setup and running
+- [README.md](../README.md) for setup and running
 - [QUICKSTART.md](QUICKSTART.md) for fast setup
 - [LEARNING.md](LEARNING.md) for understanding the code principles

PROJECT_STRUCTURE.md docs/PROJECT_STRUCTURE.mdPROJECT_STRUCTURE.md renamed to docs/PROJECT_STRUCTURE.md

@@ -105,7 +105,7 @@ npm install
 
 ## Next Steps
 
-- Read the full [README.md](README.md) for detailed documentation
+- Read the full [README.md](../README.md) for detailed documentation
 - Run tests: `npm run test:e2e:ui`
 - Explore the code and try modifying it!
 

PYDANTIC_ARCHITECTURE.md docs/PYDANTIC_ARCHITECTURE.mdPYDANTIC_ARCHITECTURE.md renamed to docs/PYDANTIC_ARCHITECTURE.md

@@ -487,7 +487,7 @@ test('my test', async ({ page }) => {
 
 ### Get More Help
 
-1. Read the full [README.md](README.md)
+1. Read the full [README.md](../README.md)
 2. Check [LEARNING.md](LEARNING.md) for code explanations
 3. Review [PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md) for file locations
 

QUICKSTART.md docs/QUICKSTART.mdQUICKSTART.md renamed to docs/QUICKSTART.md

@@ -310,4 +310,4 @@ All without duplicating business logic or metadata!
 - See [app.py](backend/app.py) for the implementation
 - See [api_decorators.py](backend/api_decorators.py) for the decorator system
 - See [tasks/service.py](backend/tasks/service.py) for business logic
-- See [README.md](README.md) for usage instructions
+- See [README.md](../README.md) for usage instructions