Ecosystem Overview

The Toto ecosystem consists of multiple interconnected projects, each serving specific purposes while maintaining a clean architecture and unified technology stack.

📘 Integration Guide: For detailed integration patterns and cross-project communication, see Ecosystem Integration Guide.

🏗 Core Projects

Project	Purpose	Technology	URL
toto-app	Main application	Next.js + API Routes + App Hosting	https://app.betoto.pet
toto-bo	Backoffice management	Next.js + API Routes + App Hosting	https://bo.betoto.pet
toto-ai-hub	AI-powered assistance	Multi-agent AI system	Integrated with main app
toto-wallet	Payment processing	React + Stellar blockchain	Standalone component

🏗 Architecture Highlights

Clean Architecture Implementation

• Separation of Concerns: Core data in main app, backoffice-specific data locally
• API-First Design: All data access through well-defined APIs
• Unified Technology Stack: Next.js API Routes + App Hosting across all projects
• Security by Design: JWT + Session-based authentication with role-based access

Technology Stack

• Frontend: Next.js with TypeScript
• Backend: Next.js API Routes (current implementation)
• Deployment: Firebase App Hosting
• Database: Firestore with security rules
• Authentication: Firebase Auth + NextAuth.js
• AI: Multi-agent AI system (toto-ai-hub)
• Payments: Stellar blockchain integration (toto-wallet)

🔗 Integration Features

Cross-Project Communication

• API Integration: RESTful APIs for data exchange
• Authentication: Cross-project token sharing
• Real-time Updates: Firestore listeners for live data
• Event-Driven Architecture: Event bus for component communication

Data Architecture

• Main App (toto-f9d2f): Core business data (cases, users, donations)
• Backoffice (toto-bo): Administrative data (audit logs, analytics)
• Shared Knowledge Base: Centralized KB in toto-bo for all environments

Security & Access

• Role-Based Access Control: Permission-based data access
• Cross-Project Authentication: JWT token validation across projects
• Isolated Projects: Separate Firebase projects for security

📚 Documentation

• Ecosystem Integration - Integration patterns and architecture

📊 Key Features

Main Application

• ✅ Interactive pet rescue feed
• ✅ Secure donation system
• ✅ Guardian tools in backoffice
• ✅ Social sharing integration
• ✅ Real-time updates and notifications
• ✅ Role-based access control

Backoffice

• ✅ Comprehensive backoffice dashboard
• ✅ Analytics and reporting
• ✅ User management
• ✅ Payment processing
• ✅ AI agent analysis
• ✅ Audit logging

AI Agent System

• ✅ Multi-agent architecture
• ✅ Conversational AI
• ✅ Intelligent recommendations
• ✅ Case assistance
• ✅ User support automation

Wallet System

• ✅ Blockchain integration
• ✅ Secure payment processing
• ✅ Component library
• ✅ Balance management

🚀 Quick Navigation

For Users

• User Guide - Complete user manual
• Main App Guide - Core application features
• Backoffice Guide - Administrative interface

For Developers

• Architecture Overview - System design
• API Reference - Complete API documentation
• Development Guide - Development setup

For DevOps

• Deployment Guide - Production deployment
• Configuration Guide - Environment setup