Project Map (Codebase)

Questi contenuti non sono ancora disponibili nella tua lingua.

🏗️ Project Map (Codebase)

Living Document - Questa mappa riflette la struttura del repository BLACKTRAILS-PLATFORM.

🌳 Albero Strutturale

BLACKTRAILS-PLATFORM/
│
├── 📄 ROOT DOCS                     # Documentazione di Progetto
│   ├── ANTHROPIC_MIGRATION.md       # Migrazione a Claude
│   ├── DEPLOY_CHECKLIST.md          # Checklist Deploy
│   ├── PRODUCTION_AUDIT.md          # Audit Produzione
│   ├── PRODUCTION_READY.txt         # Status Produzione
│   ├── PRODUCTION_TEST_GUIDE.md     # Guida Test Produzione
│   └── SUMMARY.md                   # Sommario Generale
│
├── 🗄️ db/                           # Database Schema
│   └── schema.sql                   # Schema PostgreSQL (Neon)
│
├── 📚 docs/                         # Documentazione Tecnica
│   ├── DATABASE.md                  # ⭐ Schema Multi-Database
│   ├── DB_MIGRATION_PLAN.md         # Piano Migrazione DB
│   ├── GITHUB_AUDIT_2025-12-18.md   # Audit GitHub Repos
│   ├── in1_algoritmo.md             # Algoritmo IN-1 (ALMA)
│   ├── LIBRARY_PIPELINE_ANALYSIS.md # Analisi Pipeline Docs
│   ├── MIGRATION_REPORT_2025-12-18.md
│   └── structure.md                 # Struttura Generale
│
├── 📖 library/                      # 🎯 Source of Truth (Docs as Code)
│   ├── public/                      # Docs Pubblici (Sync DB)
│   │   ├── en/                      # English Docs
│   │   │   ├── algorithms/
│   │   │   ├── legal/
│   │   │   ├── philosophy/
│   │   │   │   ├── rhama.md
│   │   │   │   └── rhama-paradigm.md
│   │   │   └── projects/
│   │   └── it/                      # Italian Docs
│   │       ├── algoritmi/
│   │       ├── filosofia/
│   │       │   ├── manifesto.md
│   │       │   ├── rhama.md
│   │       │   └── rhama-paradigm.md
│   │       ├── legal/
│   │       └── progetti/
│   ├── private/                     # Docs Privati (Solo Git)
│   │   ├── finanza/
│   │   └── strategie/
│   └── README.md
│
├── 🛠️ maintenance/                  # Script Manutenzione
│   ├── deploy-worker.ps1            # Deploy Cloudflare Worker
│   ├── deploy.ps1                   # Deploy Generale
│   ├── maintenance-*.html           # Pagine Manutenzione Brand
│   ├── worker-split.js              # Split Worker Code
│   └── README.md
│
├── 📦 scripts/                      # Automation Scripts
│   ├── sync-library.js              # ⭐ Sync Docs → DB
│   ├── migrate-haiku-to-rhama.js    # Migrazione Haiku → Rhama
│   ├── setup-production-db.js       # Setup DB Produzione
│   ├── cloudflare-deploy-v2.js      # Deploy Cloudflare Pages
│   ├── generate-phonetics.js        # Generazione Fonetiche
│   ├── translate-rhamas.js          # Traduzione Rhama
│   ├── verify-production.js         # Verifica Produzione
│   └── [altri 15+ script utility]
│
├── 🎨 src/                          # Codice Sorgente
│   ├── brands/                      # Multi-Brand Architecture
│   │   ├── blacktrails/
│   │   │   ├── routes.js
│   │   │   └── views/
│   │   ├── elements/
│   │   │   ├── routes.js
│   │   │   └── views/
│   │   ├── forest/
│   │   │   ├── routes.js
│   │   │   └── views/
│   │   ├── gcore/
│   │   │   ├── routes.js
│   │   │   └── views/ [9 *.ejs]
│   │   └── in1/
│   │       ├── routes.js                # 14 endpoints (Rhama, Soul Card, API)
│   │       ├── services/
│   │       │   ├── almaOrchestrator.js  # ALMA orchestration layer
│   │       │   ├── almaRhama.js         # Rhama generation logic
│   │       │   ├── almaService.js       # ALMA API client
│   │       │   ├── poetService.js       # Poet model integration
│   │       │   ├── config/
│   │       │   │   └── almaConfig.js
│   │       │   └── prompts/
│   │       │       ├── alma.js          # ⭐ ALMA system prompt (Alchemy Detection)
│   │       │       ├── alma_BACKUP_PRE_ZENSPHERE.js
│   │       │       └── poeta.js
│   │       └── views/
│   │           ├── index.ejs            # IN-1 homepage
│   │           ├── rhama.ejs            # Rhama generator UI
│   │           ├── soul-card.ejs        # ⭐ Soul Card (Aurora Boreale)
│   │           ├── vision.ejs           # Vision page
│   │           └── legal.ejs            # Legal docs
│   │
│   ├── core/                        # Core System
│   │   ├── index.js                 # Entry Point
│   │   ├── db.js                    # Database Client
│   │   ├── auth.js                  # Authentication
│   │   ├── middleware.js            # Express Middleware
│   │   ├── permissions.js           # RBAC Permissions
│   │   └── email.js                 # Email Service
│   │
│   └── public/                      # Public Assets
│       ├── routes/
│       │   ├── auth.js
│       │   └── landing.js
│       ├── server.js                # Main Server
│       ├── utils/core/
│       ├── views/
│       ├── content/ [3 *.md]
│       ├── css/ [4 *.css]
│       ├── js/ [7 *.js]
│       └── favicons/
│
├── 🧪 tests/                        # Test Suite
│   ├── test-alma-*.js               # ALMA AI Tests
│   ├── test-poeta.js                # Poet Model Test
│   ├── test-emotion-analyzer.js     # Emotion Analysis
│   ├── test-conversation.js         # Conversation Flow
│   ├── test-end-to-end.js           # E2E Test
│   └── [altri 30+ test files]
│
├── 📋 package.json                  # Dependencies
├── package-lock.json
└── server.log                       # Runtime Log

📊 Architettura Modulare

1. Multi-Brand System

src/brands/
├── blacktrails/    → blacktrails.io (Hub)
├── elements/       → elements.blacktrails.io (Property Mgmt)
├── forest/         → forest.blacktrails.io (AI Gallery)
├── gcore/          → gcore.blacktrails.io (Analytics)
└── in1/            → in-1.ai (Rhama Generator)

2. Core System

core/db.js → Neon PostgreSQL Client
core/auth.js → JWT + Session Management
core/middleware.js → Express Middleware Layer
core/permissions.js → Role-Based Access Control

3. Library Pipeline

library/public/*.md
    ↓ (Git Commit)
scripts/sync-library.js
    ↓ (Parse Frontmatter + MD5 Hash)
PostgreSQL: library.documents
    ↓ (pgvector Embeddings)
AI RAG Search (IN-1, Forest)

4. Database Architecture

Neon Cluster: blacktrails

Branch: main (Produzione)
Branch: dev (Sviluppo)

Schemas:

auth → Users, Sessions
in1 → Rhamas (with Alchemy Detection: Piombo/Transition/Oro)
elements → Properties, Bookings
finance → Transactions
library → Documents (pgvector for RAG)
ai → Models, Prompts
system → Config, Logs
organization → Teams, Invites

🔑 Entry Points

Brand	Dominio	Entry Point	Tech Stack
BlackTrails	blacktrails.io	`src/brands/blacktrails/routes.js`	Node.js + EJS
IN-1	in-1.ai	`src/brands/in1/routes.js`	ALMA AI + Claude
Elements	elements.blacktrails.io	`src/brands/elements/routes.js`	Property Mgmt
Forest	forest.blacktrails.io	`src/brands/forest/routes.js`	AI Gallery
gCore	gcore.blacktrails.io	`src/brands/gcore/routes.js`	Analytics

🌲 IN-1 Routes Detail

Main Routes (Public):

GET / - Homepage
GET /rhama - Rhama generator UI (main experience)
GET /soul-card - ⭐ Soul Card (collective emotional state visualization)
GET /vision - Vision & philosophy page
GET /legal, /privacy, /terms, /contact - Legal pages

API Routes:

POST /api/rhama - Main Rhama generation API (rate-limited)
- Input: { messages: [...], turn: N }
- Output: { status, response, rhama?, turn, alchemy? }
- Alchemy Detection: Evaluates baseline emotional state (first turn)
- Database: Saves to in1.rhamas with emotion tag
GET /api/rhamas/random - Random Rhama from database
POST /api/tree - Tree planting trigger (future)

User Routes (Auth Required):

GET /app - User dashboard (personal Rhama history)
GET /app/create - New Rhama creation page

Special Features:

Soul Card (/soul-card):
- Queries in1.rhamas for today + historical emotional states
- Calculates weighted color mix (Piombo=indigo, Transition=violet, Oro=gold)
- Renders animated gradient card (Aurora Boreale effect)
- CSS animations: aurora (15s), breathe (4s), cardFloat (4s)
- Interactive 3D flip on click

🧪 Test Coverage

Categoria	File	Focus
AI Flow	`test-alma-v2-flow.js`	ALMA Pipeline Completo
Emotion	`test-emotion-analyzer.js`	Analisi Emotiva
Conversation	`test-conversation.js`	Multi-Turn Dialogue
Safety	`test-safety-keyword.js`	Content Moderation
E2E	`test-end-to-end.js`	Full User Journey

🤖 Agent Update Instructions

AI Assistant: Quando la struttura del codice cambia (nuove cartelle, moduli, brand), esegui:

# 1. Scansiona la root del progetto
list_dir E:\BLACKTRAILS-PLATFORM (ricorsivo, escludi node_modules)

# 2. Aggiorna questo file mantenendo:
#    - Albero ASCII completo
#    - Tabelle Entry Points
#    - Descrizioni moduli chiave

# 3. Commit con messaggio:
git commit -m "docs(truth): update project map"

Last Auto-Update: 2025-12-22 00:30 UTC
Last Changes: IN-1 routes detail (Soul Card, Alchemy Detection)
Next Review: On major refactoring
Maintainer: BlackTrails AI Agent
Source Repo: BLACKTRAILS-PLATFORM