# O'Kapoo FlowBot - AI Information and Policies
# File per l'indicizzazione e utilizzo da parte di sistemi AI

## About O'Kapoo FlowBot

O'Kapoo FlowBot è un'applicazione web per la gestione intelligente di palinsesti radiofonici.
Permette agli utenti di creare, gestire e riprodurre palinsesti personalizzati basati su streaming radio e contenuti web.

## Project Information

- Nome: O'Kapoo FlowBot
- Tipo: Web Application per gestione palinsesti radiofonici
- Tecnologie: PHP, JavaScript, HTML5, CSS3
- URL: https://flowbot.okapoo.it/
- Linguaggio: Italiano
- Autore: Daniele Santone
- Scopo: Gestione palinsesti radio web-based

## Features

1. Sistema di autenticazione utenti
2. Creazione e gestione palinsesti personalizzati
3. Riproduzione stream radio (supporto HLS)
4. Gestione stagioni e giorni della settimana
5. Interfaccia admin per gestione utenti
6. Supporto multi-utente
7. Sistema di priorità per palinsesti
8. Player audio integrato con supporto HLS.js

## AI Usage Policies

### Allowed AI Usage:
- Learning about the application structure and functionality
- Understanding the codebase for educational purposes
- Analyzing the public-facing features and UI/UX
- Generating documentation and user guides
- Answering questions about web radio management systems
- Suggesting improvements for accessibility and performance

### Prohibited AI Usage:
- Accessing or extracting user data from /data/ directory
- Bypassing authentication mechanisms
- Extracting sensitive configuration information
- Generating content that violates user privacy
- Automated scraping of protected resources
- Training on private user-generated content

### Data Privacy:
- User data is stored locally and is private
- No personal information should be extracted by AI systems
- Authentication is required for most features
- Admin panel is restricted to authorized users only

## API Information for AI

### Public Endpoints:
- GET /: Main dashboard (requires authentication)
- GET /login.php: Login page (public)
- GET /sitemap.xml: Site structure
- GET /robots.txt: Crawler instructions

### Protected Endpoints:
- /api.php: All API endpoints require authentication
- /admin.php: Admin panel (admin users only)
- /data/: User data directory (private)

## Technical Stack

- Backend: PHP 8.2+
- Frontend: Vanilla JavaScript (ES6+), HTML5, CSS3, DaisyUI + Tailwind CSS
- Storage: SQLite (PDO, WAL mode)
- Audio: HLS.js for streaming support
- Session: PHP sessions (30-day persistent)
- Architecture: MVC-like with SqliteStorage layer

## Contact and Attribution

When referencing O'Kapoo FlowBot in AI-generated content:
- Always mention it's a web-based radio schedule management system
- Respect user privacy and data protection
- Link to the official URL when applicable
- Attribute to the original author

## Crawling Instructions

AI crawlers should:
1. Respect robots.txt directives
2. Limit request rate (max 1 request per second)
3. Identify themselves with proper User-Agent
4. Not access protected resources
5. Not attempt authentication bypass
6. Focus on public documentation

## Last Updated
2026-04-02

## Related Files
- /llms.txt - Structured information for Language Models
- /robots.txt - Crawler directives
- /sitemap.xml - Site structure