Update README.md

Author: goldlabelapps

README.md

@@ -1,65 +1,119 @@
-## ![Python](/app/static/repoicon.png) Python
+## Python FastAPI/Postgres App
 
-> With FastAPI using Postgres & tsvector. 
+**Production-ready, open-source FastAPI application with PostgreSQL and blazing-fast full-text search.**
 
-Open Source, production ready Python FastAPI/Postgres app.  
+---
 
-[GitHub](https://github.com/goldlabelapps/python) | 
-[onr]Render](https://nx-ai.onrender.com) | 
-[by Goldlabel](https://goldlabel.pro)
+### 🚀 Features
 
 - **Python 3.11+**
-- **Postgres**
-- **tsvector** - Superfast full-text search (with GIN index)
+- **FastAPI** — Modern, high-performance REST API
+- **PostgreSQL** — Robust relational database
+- **tsvector + GIN** — Superfast full-text search
+- **Uvicorn** — Lightning-fast ASGI server
+- **Pytest** — Comprehensive testing
 
-```sh
-uvicorn app.main:app  --reload
-```
+---
+
+## Project Overview
+
+This project provides a scalable API backend using FastAPI and PostgreSQL, featuring:
 
-#### Install
+- Automatic full-text search on all text fields (via tsvector)
+- Endpoints for health checks, product management, prompt handling, and prospect management
+- Efficient ingestion and processing of large CSV files
 
-Create an environment file and add Postgres credentials etc
+---
 
-`cp .env.sample .env`
+## Getting Started
+
+### 1. Clone & Setup Environment
 
 ```bash
+git clone <repo-url>
+cd python
+cp .env.sample .env  # Add your Postgres credentials and settings
 python -m venv venv
 source venv/bin/activate
 pip install -r requirements.txt
+```
+
+### 2. Run the App
+
+```bash
 uvicorn app.main:app --reload
 ```
 
-[localhost](http://localhost:8000) | [onrender](https://nx-ai.onrender.com) 
+Visit [localhost:8000](http://localhost:8000) or [onrender](https://nx-ai.onrender.com)
 
+---
 
-### Full-Text Search (tsvector)
+## API Documentation
 
-The prospects table includes a `search_vector` column (type: tsvector) that is automatically computed from all text fields on insert. A GIN index is created for this column, enabling fast and scalable full-text search queries.
+FastAPI auto-generates interactive docs:
 
-**How it works:**
+- [Swagger UI](http://localhost:8000/docs)
+- [ReDoc](http://localhost:8000/redoc)
 
-- On every insert or update, the `search_vector` is computed from all text columns using PostgreSQL's `to_tsvector('english', ...)`.
-- The GIN index (`idx_prospects_search_vector`) allows efficient search queries like:
+---
+
+## Full-Text Search (tsvector)
+
+The `prospects` table includes a `search_vector` column (type: tsvector) computed from all text fields on insert/update. A GIN index enables fast, scalable full-text search:
 
 ```sql
 SELECT * FROM prospects WHERE search_vector @@ plainto_tsquery('english', 'search terms');
 ```
 
-This makes searching across all text fields in the prospects table extremely fast, even for large datasets.
-- **FastAPI** — RESTful API framework
-- **Uvicorn** — ASGI server
-- **Pytest** — testing framework
-- **HTTPX / TestClient**
+**How it works:**
+- On every insert/update, `search_vector` is computed using PostgreSQL's `to_tsvector('english', ...)`.
+- The GIN index (`idx_prospects_search_vector`) enables efficient search across large datasets.
+
+---
+
+## Processing Large CSV Files
+
+The `/prospects/process` endpoint supports robust ingestion of large CSVs (e.g., 1300+ rows, 300KB+), following the same normalization and insertion pattern as `/prospects/seed` but optimized for scale.
+
+---
+
+## Directory Structure
+
+```
+app/
+	main.py           # FastAPI entrypoint
+	api/              # API endpoints & schemas
+		health.py
+		root.py
+		routes.py
+		products/
+		prompts/
+		prospects/
+		resend/
+		utils/
+	static/           # Static assets (e.g., repoicon.png)
+	utils/            # Utility scripts
+tests/              # Pytest test suite
+requirements.txt    # Python dependencies
+render.yaml         # Deployment config (Render.com)
+```
+
+---
+
+## Contributing
+
+Contributions are welcome! Please open issues or submit pull requests.
+
+---
 
-#### Docs
+## License
 
-FastAPI automatically generates interactive documentation:
+This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.
 
-- Swagger UI: <http://localhost:8000/docs>
-- ReDoc: <http://localhost:8000/redoc>
+---
 
-### Processing Large CSV Files
+## Contact
 
-The `/prospects/process` endpoint is designed for robust, scalable ingestion of large CSV files (e.g., 1300+ rows, 300KB+). It follows the same normalization and insertion pattern as `/prospects/seed`, but is optimized for large files:
+For questions or support, open an issue or contact the maintainer.