# Bussola Capo

> **Bussola Capo** is a Progressive Web App (PWA) designed to support AGESCI scout leaders in managing the personal progression of youth members across all branches (L/C, E/G, R/S). The app is built with a strong emphasis on pedagogical continuity, historical data preservation, and extreme security (strict data isolation per Scout Group). It is constantly updated with new features to improve the scouting experience.

For comprehensive instructions on how to use the application, navigate its screens, manage accounts, groups, members, youth profiles, badges, and understand core systems like historical year transitions (Passaggi), please refer to the complete manual: [llms-full.txt](llms-full.txt).

## Key Concepts
- **Educational Progression**: Data is not just biographical; it tracks the educational journey of each scout.
- **Bussola Luoghi**: A shared map and list of scouting locations (bases, campsites) with advanced filters.
- **Comunità Capi Documents**: Shared pedagogical documents (PEG, PDU) and Personal Projects with version history.
- **E2E Encrypted Notes**: Zero-knowledge private notes for youth members, protected by the Web Crypto API (ECDH + AES-GCM).
- **Modular Data Export**: Full branch data export to multi-sheet Excel (.xlsx) files with built-in GDPR compliance checks.
- **Legal & Privacy Compliance**: Integrated Terms of Service (ToS) and Data Processing Agreement (DPA) available in-app for full transparency.
- **Historical Memory**: Data is historically versioned year by year during the "Passaggi" (Transitions).
- **Extreme Security**: Every Scout Group is an independent, isolated silo. Access is strictly controlled.
- **Methodological Consistency**: Language and UI adapt to the specific branch (L/C: Jungle/Wood, E/G: Troop, R/S: Clan/Fire).

## Technologies
- **Frontend**: Vanilla JavaScript (ES Modules), Tailwind CSS, Leaflet (Maps), Web Crypto API, ExcelJS (Export), PWA.
- **Backend**: Firebase (Authentication, Firestore, Cloud Functions).