# Atlas Chat API Documentation

Welcome to the Atlas Chat API documentation. This directory contains comprehensive guides for setup, deployment, API usage, and system architecture.

## 📚 Documentation Structure

### 🚀 Getting Started
- **[Setup Guide](setup/SETUP.md)** - Complete setup instructions for local development
- **[Deployment Guide](deployment/DEPLOYMENT.md)** - Hugging Face Spaces deployment guide

### 🔌 API Documentation
- **[API Integration Guide](api/integration-guide.md)** - Complete API integration documentation
- **[Anonymous API Examples](api/anonymous-examples.md)** - Examples for anonymous usage

### 📊 Analytics System
- **[Analytics Overview](analytics/overview.md)** - Analytics system architecture and approach
- **[Analytics Implementation](analytics/implementation-tasks.md)** - Implementation tasks and phases

### 📋 Reference
- **[Migration Guide](reference/migration-guide.md)** - User authentication migration (archived)

## 🎯 Quick Start

1. **New to Atlas?** Start with the [Setup Guide](setup/SETUP.md)
2. **Ready to deploy?** Check the [Deployment Guide](deployment/DEPLOYMENT.md)
3. **Integrating the API?** See the [API Integration Guide](api/integration-guide.md)
4. **Want analytics?** Read the [Analytics Overview](analytics/overview.md)

## 📖 Documentation Categories

### Setup & Deployment
Complete guides for getting Atlas running locally and deploying to production.

### API Usage
Comprehensive API documentation with examples for both anonymous and authenticated usage patterns.

### Analytics System
Documentation for the built-in analytics system including setup, usage, and data export.

### Reference Materials
Historical documentation and migration guides for reference purposes.

## 🔗 External Links

- **[Hugging Face Space](https://findethics-atlas.hf.space/)** - Live deployment
- **[Interactive API Docs](https://findethics-atlas.hf.space/docs)** - Swagger UI
- **[Analytics Dashboard](https://findethics-atlas.hf.space/analytics/dashboard)** - Live analytics

## 📝 Contributing

When adding new documentation:
1. Place files in the appropriate category directory
2. Update this README with links to new documentation
3. Follow the existing documentation format and style
4. Include practical examples where applicable

## 🆘 Support

If you need help:
1. Check the relevant documentation section
2. Review the [Setup Guide](setup/SETUP.md) for troubleshooting
3. Test your setup using the provided examples
4. Check the analytics dashboard for system status