added docker file and README file

Dockerfile

@@ -0,0 +1,27 @@
+# Use a lightweight and stable Python 3.11 base image (Bullseye)
+FROM python:3.11-slim-bullseye AS base
+
+ENV PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PATH="/home/user/.local/bin:$PATH"
+
+RUN apt-get update && apt-get install -y \
+    openssl \
+    ca-certificates \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN useradd -m -u 1000 user
+USER user
+WORKDIR /app
+
+COPY --chown=user ./requirements.txt requirements.txt
+COPY --chown=user ./app/insightfy_utils-0.1.0-py3-none-any.whl insightfy_utils-0.1.0-py3-none-any.whl
+RUN pip install --no-cache-dir --upgrade pip && \
+    pip install --no-cache-dir insightfy_utils-0.1.0-py3-none-any.whl && \
+    pip install --no-cache-dir --upgrade -r requirements.txt
+
+COPY --chown=user . /app
+
+EXPOSE 7860
+
+CMD ["uvicorn", "app.app:app", "--host", "0.0.0.0", "--port", "7860", "--workers", "4", "--log-level", "info"]

README.md

@@ -1,256 +1,98 @@
-# SCM Microservice - Supply Chain Management System
-
-[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
-[![FastAPI](https://img.shields.io/badge/FastAPI-0.104-green.svg)](https://fastapi.tiangolo.com/)
-[![MongoDB](https://img.shields.io/badge/MongoDB-Latest-green.svg)](https://www.mongodb.com/)
-
-Enterprise-grade Supply Chain Management microservice with comprehensive merchant management, hierarchical organization structure, and advanced validation.
-
-## 🚀 Quick Start
-
-```bash
-# Install dependencies
-pip install -r requirements.txt
-
-# Configure environment
-cp .env.example .env  # Edit with your MongoDB URI
-
-# Start the server
-python main.py
-
-# Run example
-python examples/quick_start.py
-```
-
-**API Documentation**: http://localhost:8000/docs
-
-## 📋 Features
-
-### ✨ Enhanced Merchant Module
-
-- **Hierarchical Merchant Management**: National CNF → CNF → Distributor → Salon
-- **Comprehensive Validation**: E.164 phone, Indian pincode, GST/PAN/IFSC patterns
-- **Business Rule Enforcement**: Parent-child relationships, KYC requirements, credit limits
-- **RESTful API**: Complete CRUD operations with filtering and pagination
-- **Geographic Support**: Lat/lng validation for location-based services
-- **Status Lifecycle**: Draft → Submitted → Approved → Active
-- **Soft Delete**: Preserve data integrity with status-based deletion
-
-### 🔒 Validation & Security
-
-- **Contact Information**: Phone (E.164), email normalization, address validation
-- **KYC Documents**: GST (15-char), PAN (10-char), IFSC (11-char) pattern validation
-- **Geographic Data**: Latitude (-90 to 90), Longitude (-180 to 180)
-- **Business Settings**: Payment modes, credit limits, inheritance flags
-- **Document URLs**: HTTPS-only enforcement
-
-### 📊 Merchant Types
-
-| Type | Parent | KYC Requirements | Special |
-|------|--------|------------------|---------|
-| **National CNF** | None (Root) | GST, PAN, Bank, IFSC | Top-level distributor |
-| **CNF** | National CNF | GST, PAN, Bank, IFSC | Regional distributor |
-| **Distributor** | CNF | GST, PAN, Bank, IFSC | Local distributor |
-| **Salon** | Distributor | PAN (GST optional) | Geo-location required |
-
-## 📚 Documentation
-
-- **[Getting Started Guide](GETTING_STARTED.md)** - Installation and setup
-- **[Merchant Module Documentation](MERCHANT_MODULE.md)** - Complete API reference
-- **[Architecture Overview](ARCHITECTURE.md)** - System design and diagrams
-- **[Enhancement Summary](ENHANCEMENT_SUMMARY.md)** - What's new
-
-## 🏗️ Architecture
-
-```
-FastAPI Application
-    ├── Routers (API Endpoints)
-    │   └── Merchant Router
-    ├── Services (Business Logic)
-    │   └── Merchant Service
-    ├── Schemas (Validation)
-    │   └── Pydantic Models
-    ├── Models (Database)
-    │   └── MongoDB Documents
-    └── MongoDB (Data Store)
-```
-
-## 📦 Project Structure
-
-```
-app/
-├── constants/          # Enums, validation patterns
-├── core/              # Configuration, logging
-├── models/            # Database models
-├── schemas/           # Pydantic validation schemas
-├── services/          # Business logic layer
-└── routers/           # API endpoints
-
-tests/                 # Comprehensive test suite
-examples/              # Usage examples
-main.py               # Application entry point
-```
-
-## 🔧 API Endpoints
+---
+title: Insightify ANS
+emoji: 👀
+colorFrom: yellow
+colorTo: green
+sdk: docker
+pinned: false
+short_description: Analytics Notification Services
+---
 
-### Merchant Management
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
-```http
-POST   /merchants                    # Create merchant
-GET    /merchants/{id}               # Get merchant details
-PUT    /merchants/{id}               # Update merchant
-DELETE /merchants/{id}               # Delete merchant (soft)
-GET    /merchants                    # List with filters
-GET    /merchants/{id}/children      # Get child merchants
-GET    /merchants/{id}/hierarchy     # Get full hierarchy path
-```
 
-### Query Parameters
+# Analytics and Notification Service (ANS)
 
-- `merchant_type`: Filter by type (national_cnf, cnf, distributor, salon)
-- `parent_id`: Filter by parent merchant
-- `status`: Filter by status (draft, submitted, approved, active, suspended, rejected)
-- `skip`: Pagination offset
-- `limit`: Results per page (max 500)
+The Analytics and Notification Service (ANS) is a microservice that provides business intelligence, analytics, and notification capabilities for the Insightfy Bloom platform.
 
-## 💡 Usage Examples
+## Features
 
-### Create National CNF
+- **Analytics Dashboard**: Real-time business metrics and KPIs
+- **Reporting**: Generate various business reports
+- **Data Aggregation**: Collect and process data from other microservices
+- **Notifications**: Send alerts and notifications based on business rules
+- **Performance Monitoring**: Track business performance indicators
 
-```python
-POST /merchants
-{
-  "merchant_type": "national_cnf",
-  "merchant_code": "NCNF-001",
-  "merchant_name": "National Distribution",
-  "contact": {
-    "phone": "+919876543210",
-    "email": "contact@national.com",
-    "address_line1": "123 Industrial Area",
-    "city": "Mumbai",
-    "state": "Maharashtra",
-    "pincode": "400001",
-    "country": "India"
-  },
-  "kyc": {
-    "gst_number": "27AAPFU0939F1ZV",
-    "pan_number": "AAPFU0939F",
-    "bank_account_number": "1234567890123",
-    "bank_ifsc": "HDFC0001234"
-  },
-  "created_by": "admin"
-}
-```
+## Architecture
 
-### Create Salon
+ANS integrates with other microservices:
+- **MPMS**: Product and merchant data
+- **RMS**: Resource and employee data  
+- **TMS**: Transaction and sales data
+- **CRM**: Customer relationship data
 
-```python
-POST /merchants
-{
-  "merchant_type": "salon",
-  "parent_merchant_id": "DIST_001",
-  "merchant_code": "SALON-001",
-  "merchant_name": "Glamour Salon",
-  "contact": {...},
-  "geo_location": {"lat": 19.0760, "lng": 72.8777},
-  "kyc": {"pan_number": "AAPFU0939F"},
-  "created_by": "admin"
-}
-```
+## Database Connections
 
-## 🧪 Testing
+- **PostgreSQL**: Primary database for analytics data
+- **MongoDB**: Document storage for flexible analytics
+- **Redis**: Caching and session management
 
-```bash
-# Run all tests
-pytest -v
+## API Endpoints
 
-# Run specific test file
-pytest tests/test_merchant_schemas.py -v
+### Health Checks
+- `GET /health` - Service health status
+- `GET /ready` - Readiness check
+- `GET /live` - Liveness check
 
-# Run with coverage
-pytest --cov=app tests/
-```
+### Analytics
+- `GET /api/v1/analytics/dashboard` - Dashboard data
+- `GET /api/v1/analytics/reports` - Generate reports
 
-**Test Coverage**: Comprehensive validation, business rules, hierarchy enforcement
+## Environment Variables
 
-## 🚀 Deployment
-
-### Development
+Copy `.env.example` to `.env` and configure:
 
 ```bash
-python main.py
-# or
-uvicorn main:app --reload
-```
-
-### Production
+# Database Configuration
+DATABASE_URL=postgresql+asyncpg://user:password@localhost:5432/ans_db
+REDIS_URL=redis://localhost:6379/0
+MONGODB_URL=mongodb://localhost:27017/ans_db
+
+# Service URLs
+MPMS_BASE_URL=http://localhost:8001
+RMS_BASE_URL=http://localhost:8002
+TMS_BASE_URL=http://localhost:8003
+CRM_BASE_URL=http://localhost:8004
+
+# Service Configuration
+SERVICE_NAME=ans
+SERVICE_PORT=8005
+LOG_LEVEL=INFO
 
-```bash
-uvicorn main:app --host 0.0.0.0 --port 8000 --workers 4
+# JWT Configuration
+JWT_SECRET_KEY=your-secret-key
+JWT_ALGORITHM=HS256
 ```
 
-### Docker (Coming Soon)
+## Running the Service
 
 ```bash
-docker build -t scm-microservice .
-docker run -p 8000:8000 scm-microservice
-```
-
-## 🗄️ Database
-
-**MongoDB Collections**:
-- `scm_merchants` - Merchant data with hierarchical structure
-- `scm_employees` - Employee management
-- `scm_roles` - Role definitions
-- `scm_auth_logs` - Authentication logs
-
-**Recommended Indexes**:
-```javascript
-db.scm_merchants.createIndex({"merchant_id": 1}, {unique: true})
-db.scm_merchants.createIndex({"merchant_code": 1, "parent_merchant_id": 1}, {unique: true})
-db.scm_merchants.createIndex({"parent_merchant_id": 1})
-db.scm_merchants.createIndex({"merchant_type": 1})
-db.scm_merchants.createIndex({"status": 1})
-```
-
-## 🔐 Environment Variables
+# Install dependencies
+pip install -r requirements.txt
 
-```env
-MONGODB_URI=mongodb://localhost:27017
-MONGODB_DB_NAME=scm_db
-APP_ENV=development
-LOG_LEVEL=INFO
+# Run the service
+uvicorn app.main:app --host 0.0.0.0 --port 8005 --reload
 ```
 
-## 📊 Tech Stack
-
-- **Framework**: FastAPI 0.104+
-- **Database**: MongoDB (Motor async driver)
-- **Validation**: Pydantic 2.5+
-- **Server**: Uvicorn
-- **Testing**: Pytest
-- **Logging**: insightfy-utils
+## Development
 
-## 🤝 Contributing
-
-1. Follow existing code structure
-2. Add tests for new features
-3. Update documentation
-4. Use type hints
-5. Follow PEP 8 style guide
-
-## 📝 License
-
-Proprietary - Cuatro Labs
-
-## 📞 Support
-
-- **API Documentation**: http://localhost:8000/docs
-- **Interactive Docs**: http://localhost:8000/redoc
-- **Health Check**: http://localhost:8000/health
-
----
+The service follows the standard microservice architecture:
 
-**Version**: 1.0.0  
-**Last Updated**: November 24, 2025  
-**Maintained by**: Cuatro Labs Team
+- `app/routers/` - API route handlers
+- `app/services/` - Business logic
+- `app/repositories/` - Data access layer
+- `app/models/` - Database models
+- `app/schemas/` - Pydantic schemas
+- `app/clients/` - Inter-service communication
+- `app/dependencies/` - FastAPI dependencies (auth, etc.)
+- `app/utils/` - Utility functions