# BlackOptic Atlas Documentation (llm.txt)

Generated at: 2026-02-15T14:57:33.400Z
Docs index: https://localhost:3001/docs

This file provides a text-first map of the Atlas docs for LLM ingestion.
Use each section URL for full content and anchor URLs for scoped retrieval.

Sections:

1. Getting Started
Section URL: https://localhost:3001/docs/getting-started
Summary: Platform overview, first-question flow, and recommended onboarding sequence.
Anchor 1: Overview -> https://localhost:3001/docs/getting-started#getting-started-overview
Anchor 2: Quick Start Guide -> https://localhost:3001/docs/getting-started#getting-started-quick-start
Anchor 3: Next Steps -> https://localhost:3001/docs/getting-started#getting-started-next-steps

2. Chat Interface
Section URL: https://localhost:3001/docs/chat-interface
Summary: How to ask questions, use follow-ups, upload files, and interpret generated outputs.
Anchor 1: Asking Questions -> https://localhost:3001/docs/chat-interface#chat-asking-questions
Anchor 2: How It Works -> https://localhost:3001/docs/chat-interface#chat-how-it-works
Anchor 3: Follow-up Questions -> https://localhost:3001/docs/chat-interface#chat-follow-ups
Anchor 4: Uploading Files -> https://localhost:3001/docs/chat-interface#chat-uploading-files
Anchor 5: Visualizations -> https://localhost:3001/docs/chat-interface#chat-visualizations
Anchor 6: Tips for Better Results -> https://localhost:3001/docs/chat-interface#chat-tips

3. Dashboards
Section URL: https://localhost:3001/docs/dashboards
Summary: Dashboard creation paths, widget operations, sharing options, and design best practices.
Anchor 1: Creating a Dashboard -> https://localhost:3001/docs/dashboards#dashboards-creating
Anchor 2: Adding Widgets -> https://localhost:3001/docs/dashboards#dashboards-widgets
Anchor 3: Layout & Filters -> https://localhost:3001/docs/dashboards#dashboards-layout
Anchor 4: Dashboard Copilot -> https://localhost:3001/docs/dashboards#dashboards-copilot
Anchor 5: Sharing & Export -> https://localhost:3001/docs/dashboards#dashboards-sharing
Anchor 6: Best Practices -> https://localhost:3001/docs/dashboards#dashboards-best-practices

4. Data Modeling
Section URL: https://localhost:3001/docs/data-modeling
Summary: Semantic model management across visual builder, code editor, and visibility controls.
Anchor 1: Overview -> https://localhost:3001/docs/data-modeling#data-modeling-overview
Anchor 2: Visual Model Builder -> https://localhost:3001/docs/data-modeling#data-modeling-visual-builder
Anchor 3: Calculated Fields -> https://localhost:3001/docs/data-modeling#data-modeling-calculated-fields
Anchor 4: AI Code Editor -> https://localhost:3001/docs/data-modeling#data-modeling-code-editor
Anchor 5: Visibility Controls -> https://localhost:3001/docs/data-modeling#data-modeling-visibility

5. CSV Datasets
Section URL: https://localhost:3001/docs/csv-datasets
Summary: Upload, analyze, curate, and publish CSV-based datasets for ad-hoc and shared workflows.
Anchor 1: Overview -> https://localhost:3001/docs/csv-datasets#csv-overview
Anchor 2: Uploading Files -> https://localhost:3001/docs/csv-datasets#csv-uploading
Anchor 3: Analyzing Data -> https://localhost:3001/docs/csv-datasets#csv-analyzing
Anchor 4: Curating & Publishing -> https://localhost:3001/docs/csv-datasets#csv-curating

6. Advanced Analytics
Section URL: https://localhost:3001/docs/advanced-analytics
Summary: When the assistant switches to Python analysis and how to frame advanced requests.
Anchor 1: Overview -> https://localhost:3001/docs/advanced-analytics#analytics-overview
Anchor 2: Example Questions -> https://localhost:3001/docs/advanced-analytics#analytics-examples
Anchor 3: Tips & Limitations -> https://localhost:3001/docs/advanced-analytics#analytics-tips

7. Spaces
Section URL: https://localhost:3001/docs/spaces
Summary: Knowledge organization and context attachment workflows for chat sessions.
Anchor 1: Overview -> https://localhost:3001/docs/spaces#spaces-overview
Anchor 2: User Flows -> https://localhost:3001/docs/spaces#spaces-workflows

8. BI Tool SQL API
Section URL: https://localhost:3001/docs/bi-tool-sql-api
Summary: Connection details for external BI tools using Atlas SQL API access.
Anchor 1: Overview -> https://localhost:3001/docs/bi-tool-sql-api#bi-overview
Anchor 2: Connection Parameters -> https://localhost:3001/docs/bi-tool-sql-api#bi-connection

9. Roles & Permissions
Section URL: https://localhost:3001/docs/roles-permissions
Summary: RBAC model, role definitions, and row/column-level data controls.
Anchor 1: Overview -> https://localhost:3001/docs/roles-permissions#rbac-overview
Anchor 2: Predefined Roles -> https://localhost:3001/docs/roles-permissions#rbac-roles
Anchor 3: Row & Column Security -> https://localhost:3001/docs/roles-permissions#rbac-rls-cls

10. Billing & Plans
Section URL: https://localhost:3001/docs/billing
Summary: Tier structure, plan comparison, seat billing, and AI credit behavior.
Anchor 1: Overview -> https://localhost:3001/docs/billing#billing-overview
Anchor 2: Pricing Tiers -> https://localhost:3001/docs/billing#billing-plans
Anchor 3: AI Credits -> https://localhost:3001/docs/billing#billing-ai-credits

11. Security Settings
Section URL: https://localhost:3001/docs/security
Summary: Enterprise authentication controls including SSO and MFA policy guidance.
Anchor 1: Single Sign-On (SSO) -> https://localhost:3001/docs/security#security-sso
Anchor 2: MFA / 2FA Policies -> https://localhost:3001/docs/security#security-mfa

12. Audit Logs
Section URL: https://localhost:3001/docs/audit-logs
Summary: Event tracking, filtering, and export workflows for governance and incident review.
Anchor 1: Overview -> https://localhost:3001/docs/audit-logs#audit-overview
Anchor 2: Browsing & Filtering -> https://localhost:3001/docs/audit-logs#audit-usage

13. Troubleshooting
Section URL: https://localhost:3001/docs/troubleshooting
Summary: Common application, query, and schema issues with corrective actions.
Anchor 1: Application Issues -> https://localhost:3001/docs/troubleshooting#troubleshoot-app
Anchor 2: Query Issues -> https://localhost:3001/docs/troubleshooting#troubleshoot-queries
Anchor 3: Display & Schema Issues -> https://localhost:3001/docs/troubleshooting#troubleshoot-display

Canonical docs paths:
/docs
/docs/{section-id}
/docs/llm.txt