chore(docs): update documentation

Author: Thavarshan

docs/api/index.md

@@ -11,17 +11,25 @@ Altus 4 provides a RESTful API for managing database connections, executing sear
 
 ## Authentication
 
-All API endpoints require API key authentication for B2B service integration.
+Altus 4 uses **dual authentication** depending on the endpoint type:
+
+- **JWT Tokens**: For user management, account operations, API key management, database management, and analytics
+- **API Keys**: For search operations and B2B service integration
 
 ### Authentication Flow
 
 1. **Register** a new user account
-2. **Create** your first API key using the management endpoint
-3. **Include API key** in `Authorization` header for all subsequent requests
+2. **Login** to receive a JWT token
+3. **Create** your first API key using the JWT token
+4. **Use JWT tokens** for account management (profile, API key management)
+5. **Use API keys** for search operations and analytics
 
 ```bash
-# Include API key in all requests
-Authorization: Bearer <your-api-key>
+# Use JWT token for account management
+Authorization: Bearer <jwt-token>
+
+# Use API key for search operations
+Authorization: Bearer <api-key>
 ```
 
 **API Key Format**: `altus4_sk_live_abc123def456...` (live) or `altus4_sk_test_xyz789abc123...` (test)
@@ -40,12 +48,12 @@ Authorization: Bearer <your-api-key>
 | `DELETE` | `/api/v1/auth/account`                | Deactivate account      | JWT Token     | Tested                    |
 | `POST`   | `/api/v1/management/setup`            | Create first API key    | JWT Token     | Tested                    |
 | `GET`    | `/api/v1/management/migration-status` | Check migration status  | JWT Token     | Tested                    |
-| `POST`   | `/api/v1/keys`                        | Create new API key      | API Key       | Requires admin permission |
-| `GET`    | `/api/v1/keys`                        | List API keys           | API Key       | Tested                    |
-| `PUT`    | `/api/v1/keys/:keyId`                 | Update API key          | API Key       | Requires admin permission |
-| `DELETE` | `/api/v1/keys/:keyId`                 | Revoke API key          | API Key       | Requires admin permission |
-| `GET`    | `/api/v1/keys/:keyId/usage`           | Get API key usage stats | API Key       | Not tested                |
-| `POST`   | `/api/v1/keys/:keyId/regenerate`      | Regenerate API key      | API Key       | Requires admin permission |
+| `POST`   | `/api/v1/keys`                        | Create new API key      | JWT Token     | Requires admin permission |
+| `GET`    | `/api/v1/keys`                        | List API keys           | JWT Token     | Tested                    |
+| `PUT`    | `/api/v1/keys/:keyId`                 | Update API key          | JWT Token     | Requires admin permission |
+| `DELETE` | `/api/v1/keys/:keyId`                 | Revoke API key          | JWT Token     | Requires admin permission |
+| `GET`    | `/api/v1/keys/:keyId/usage`           | Get API key usage stats | JWT Token     | Not tested                |
+| `POST`   | `/api/v1/keys/:keyId/regenerate`      | Regenerate API key      | JWT Token     | Requires admin permission |
 
 [**→ Complete API Key Authentication Guide**](./authentication.md)
 
@@ -78,7 +86,7 @@ Execute searches across connected databases with AI enhancements.
 | ------ | ---------------------------- | ------------------------- | ------------------- | ---------- |
 | `POST` | `/api/v1/search`             | Execute search            | API Key             | Tested     |
 | `GET`  | `/api/v1/search/suggestions` | Get search suggestions    | API Key             | Tested     |
-| `POST` | `/api/v1/search/analyze`     | Analyze query performance | API Key (analytics) | Not tested |
+| `POST` | `/api/v1/search/analyze`     | Analyze query performance | API Key (analytics) | Tested     |
 | `GET`  | `/api/v1/search/history`     | Get search history        | API Key             | Tested     |
 | `GET`  | `/api/v1/search/trends`      | Get user search trends    | API Key (analytics) | Tested     |
 
@@ -159,7 +167,7 @@ interface ApiResponse<T> {
   "meta": {
     "timestamp": "2025-09-06T16:19:56.197Z",
     "requestId": "1b53d9d6-ca2e-4b99-959b-8459820475b4",
-    "version": "0.1.0"
+    "version": "0.3.0"
   }
 }
 ```
@@ -185,7 +193,7 @@ interface ApiResponse<T> {
   "meta": {
     "timestamp": "2025-09-06T16:20:01.403Z",
     "requestId": "fb62455b-8ccd-4cbb-898a-606ba936e25c",
-    "version": "0.2.1"
+    "version": "0.3.0"
   }
 }
 ```
@@ -206,7 +214,7 @@ interface ApiResponse<T> {
   "meta": {
     "timestamp": "2024-01-15T10:30:00.000Z",
     "requestId": "req_abc123",
-    "version": "0.1.0"
+    "version": "0.3.0"
   }
 }
 ```
@@ -467,4 +475,4 @@ The Altus4 Core API is now fully functional and ready for production deployment.
 
 ---
 
-**Need help?** Check out the [examples section](../examples/) for practical implementations or [report issues](https://github.com/altus4/core/issues) if you find any problems.
+**Need help?** Check out the [examples section](../examples/) for practical implementations or [report issues](https://github.com/anthropics/claude-code/issues) if you find any problems.

docs/deployment/local.md

@@ -11,8 +11,8 @@ This guide walks you through setting up Altus 4 for local development on your ma
 
 ### System Requirements
 
-- **Node.js**: Version 18 or higher
-- **npm**: Version 9 or higher (comes with Node.js)
+- **Node.js**: Version 20 or higher
+- **npm**: Version 10 or higher (comes with Node.js)
 - **Git**: For version control
 - **MySQL**: Version 8.0 or higher
 - **Redis**: Version 6.0 or higher (optional but recommended)

docs/index.md

@@ -24,10 +24,10 @@ Altus 4 is an advanced AI-powered MySQL full-text search engine that enhances tr
 Get Altus 4 running locally in under 5 minutes:
 
 ```bash
-# Prerequisites: Node.js 18+, MySQL 8.0+, Redis 6.0+
+# Prerequisites: Node.js 20+, MySQL 8.0+, Redis 6.0+
 
 # Clone and install
-git clone https://github.com/altus4/core.git
+git clone <repository-url>
 cd altus4
 npm install
 
@@ -91,8 +91,8 @@ Need help with Altus 4?
 
 - **Documentation**: You're in the right place!
 - **Examples**: Check out the [examples section](examples/)
-- **Issues**: [GitHub Issues](https://github.com/altus4/core/issues)
-- **Community**: [GitHub Discussions](https://github.com/altus4/core/discussions)
+- **Issues**: [GitHub Issues](https://github.com/anthropics/claude-code/issues)
+- **Community**: [GitHub Discussions](https://github.com/anthropics/claude-code/discussions)
 
 ---
 

docs/setup/quickstart.md

@@ -13,7 +13,7 @@ This guide will get you up and running with Altus 4 as quickly as possible. For
 
 Before starting, ensure you have:
 
-- **Node.js 18+** installed
+- **Node.js 20+** installed
 - **MySQL 8.0+** running and accessible
 - **Redis 6.0+** running (optional but recommended)
 - **OpenAI API key** (optional, for AI features)
@@ -22,7 +22,7 @@ Before starting, ensure you have:
 
 ```bash
 # Clone the repository
-git clone https://github.com/altus4/core.git
+git clone <repository-url>
 cd altus4
 
 # Install dependencies
@@ -47,17 +47,30 @@ DB_HOST=localhost
 DB_PORT=3306
 DB_USERNAME=root
 DB_PASSWORD=
-DB_DATABASE=altus4
+DB_DATABASE=altus4_metadata
 
 # Authentication
 JWT_SECRET=your_very_long_and_secure_jwt_secret_key_here_at_least_32_characters
 
 # Redis Configuration (optional but recommended)
 REDIS_HOST=localhost
 REDIS_PORT=6379
+REDIS_PASSWORD=
 
 # OpenAI Integration (optional - for AI features)
 OPENAI_API_KEY=sk-your_openai_api_key_here
+OPENAI_MODEL=gpt-3.5-turbo
+OPENAI_TIMEOUT_MS=30000
+
+# CORS Configuration (optional - for frontend integration)
+ALLOWED_ORIGINS=http://localhost:3000,http://localhost:3001
+
+# Rate Limiting (optional - customize rate limits)
+RATE_LIMIT_WINDOW_MS=900000
+RATE_LIMIT_MAX_REQUESTS=100
+
+# Application Configuration (optional)
+PORT=3000
 ```
 
 ## Step 3: Database Setup
@@ -85,7 +98,7 @@ Create the MySQL database manually:
 mysql -u root -p
 
 -- Create database
-CREATE DATABASE altus4 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
+CREATE DATABASE altus4_metadata CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
 ```
 
 ## Step 4: Run Migrations
@@ -139,7 +152,7 @@ Expected response:
 {
   "status": "healthy",
   "timestamp": "2024-01-15T10:30:00.000Z",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "uptime": 1.234
 }
 ```
@@ -186,7 +199,7 @@ curl -X POST http://localhost:3000/api/v1/management/setup \
 
 ```bash
 curl -X POST http://localhost:3000/api/v1/databases \
-  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
+  -H "Authorization: Bearer YOUR_JWT_TOKEN_HERE" \
   -H "Content-Type: application/json" \
   -d '{
     "name": "My Test Database",
@@ -244,7 +257,7 @@ You now have Altus 4 running locally! Here's what you can do next:
 sudo systemctl status mysql
 
 # Test connection manually
-mysql -h localhost -u altus4_user -p altus4_meta
+mysql -h localhost -u altus4_user -p altus4_metadata
 ```
 
 **Redis Connection Issues**
@@ -272,7 +285,7 @@ lsof -ti:3000 | xargs kill -9
 
 ```bash
 # Check database exists and user has permissions
-mysql -u altus4_user -p -e "SHOW DATABASES;"
+mysql -u altus4_user -p altus4_metadata -e "SHOW DATABASES;"
 
 # Reset migrations if needed
 npm run migrate:down
@@ -283,8 +296,8 @@ npm run migrate:up
 
 - **[Complete Setup Guide](./index.md)** - Detailed installation instructions
 - **[Development Guide](../development/)** - Development environment setup
-- **[GitHub Issues](https://github.com/altus4/core/issues)** - Report bugs or get help
-- **[GitHub Discussions](https://github.com/altus4/core/discussions)** - Community support
+- **[GitHub Issues](https://github.com/anthropics/claude-code/issues)** - Report bugs or get help
+- **[GitHub Discussions](https://github.com/anthropics/claude-code/discussions)** - Community support
 
 ---