How jesus-alva/rioproyect works
Rio Claro is a branch-scoped distributor operations system with a Next.js role-based workspace and FastAPI backend. Users authenticate, then work through role-specific capabilities: invoice upload/review and director reporting, inventory, agent chat, complaint intake and follow-up, and administrator access management. The excerpts establish backend routing and persistence layers; the README documents key API workflows and Azure integrations. Some frontend-to-API paths and unsampled subsystem internals are therefore omitted or shown only where explicitly documented.
Main entry points: main.py API orchestration · ProtectedDashboard.jsx Role dashboard · auth.py Authentication and roles · page.jsx Login and registration
Components 17
User experience
- Login and registration
frontend/app/login/page.jsx - Role dashboard
frontend/components/ProtectedDashboard.jsx - User administration
frontend/components/AdminUserManagement.jsx - Invoice workspace
frontend/components/InvoiceWorkspace.jsx - Agent chat
frontend/components/ChatPanel.jsx - Complaint inbox
frontend/components/ComplaintInbox.jsx
Identity and access
- Session storage
frontend/lib/authSession.js - Authentication and roles
backend/app/auth.py - Branch authorization
backend/app/branches.py
Operations workflows
- Invoice processing
backend/app/invoice_upload.py - Complaint analysis
backend/app/complaint_analysis.py - Agent roles
backend/app/roles.py
Backend platform
- API orchestration
backend/app/main.py - Application database
backend/app/database.py
Other components
- Staff and customers
- Azure AI Foundry
- Azure storage, search and document AI
Connections 22
- Staff and customers → Login and registration: sign in or register
frontend/app/login/page.jsx - Login and registration → Authentication and roles: authenticates
README.md - Login and registration → Session storage: saves session
frontend/app/login/page.jsx - Role dashboard → Session storage: reads session
frontend/components/ProtectedDashboard.jsx - Role dashboard → User administration: renders admin tools
frontend/components/ProtectedDashboard.jsx - Role dashboard → Invoice workspace: renders invoice tools
frontend/components/ProtectedDashboard.jsx - Role dashboard → Agent chat: renders chat
frontend/components/ProtectedDashboard.jsx - Role dashboard → Complaint inbox: renders inbox
frontend/components/ProtectedDashboard.jsx - User administration → Authentication and roles: updates access
frontend/components/AdminUserManagement.jsx - Invoice workspace → API orchestration: uploads and reviews
- Agent chat → API orchestration: sends chat requests
- Complaint inbox → API orchestration: manages complaints
README.md - Role dashboard → API orchestration: requests sales report
README.md - API orchestration → Authentication and roles: routes authentication
backend/app/main.py - API orchestration → Invoice processing: routes invoice upload
backend/app/main.py - API orchestration → Complaint analysis: analyzes complaints
backend/app/main.py - API orchestration → Application database: reads and writes records
backend/app/main.py - Authentication and roles → Application database: persists accounts
backend/app/auth.py - Authentication and roles → Branch authorization: validates assignments
backend/app/auth.py - API orchestration → Agent roles: selects agent roles
backend/app/main.py - Complaint analysis → Azure AI Foundry: classifies complaints
README.md - Invoice processing → Azure storage, search and document AI: uses document services