{"id":30034202,"url":"https://github.com/mrj0nesmtl/sheltr-ai","last_synced_at":"2025-08-06T23:12:29.404Z","repository":{"id":305973468,"uuid":"1024523771","full_name":"mrj0nesmtl/sheltr-ai","owner":"mrj0nesmtl","description":"An ecosystem where every donation creates immediate, transparent impact through direct participant empowerment.","archived":false,"fork":false,"pushed_at":"2025-08-06T19:23:38.000Z","size":130266,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-06T21:14:35.539Z","etag":null,"topics":["anthropic-claude","banking","base","big-data","cursor","firebase","firestore","fundraising","housing-affordability","impact-service","python-3","qr-code","tech4good","tech4impact","unhoused"],"latest_commit_sha":null,"homepage":"https://sheltr-ai.web.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mrj0nesmtl.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-22T20:50:00.000Z","updated_at":"2025-08-06T19:23:42.000Z","dependencies_parsed_at":"2025-08-06T21:20:06.006Z","dependency_job_id":null,"html_url":"https://github.com/mrj0nesmtl/sheltr-ai","commit_stats":null,"previous_names":["mrj0nesmtl/sheltr-ai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mrj0nesmtl/sheltr-ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrj0nesmtl%2Fsheltr-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrj0nesmtl%2Fsheltr-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrj0nesmtl%2Fsheltr-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrj0nesmtl%2Fsheltr-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrj0nesmtl","download_url":"https://codeload.github.com/mrj0nesmtl/sheltr-ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrj0nesmtl%2Fsheltr-ai/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269170586,"owners_count":24372066,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-06T02:00:09.910Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anthropic-claude","banking","base","big-data","cursor","firebase","firestore","fundraising","housing-affordability","impact-service","python-3","qr-code","tech4good","tech4impact","unhoused"],"created_at":"2025-08-06T23:12:24.194Z","updated_at":"2025-08-06T23:12:29.386Z","avatar_url":"https://github.com/mrj0nesmtl.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🏠 SHELTR-AI\n**Hacking homelessness through technology.** \n\nThe next generation platform for transparent charitable giving and homelessness support built on modern cloud infrastructure.\n\n[![Firebase](https://img.shields.io/badge/Firebase-FFCA28?style=for-the-badge\u0026logo=firebase\u0026logoColor=black)](https://firebase.google.com)\n[![FastAPI](https://img.shields.io/badge/FastAPI-009688?style=for-the-badge\u0026logo=fastapi\u0026logoColor=white)](https://fastapi.tiangolo.com)\n[![React](https://img.shields.io/badge/React-20232A?style=for-the-badge\u0026logo=react\u0026logoColor=61DAFB)](https://reactjs.org)\n[![Expo](https://img.shields.io/badge/Expo-000020?style=for-the-badge\u0026logo=expo\u0026logoColor=white)](https://expo.dev)\n[![GitHub Stars](https://img.shields.io/github/stars/mrj0nesmtl/sheltr-ai?style=for-the-badge)](https://github.com/mrj0nesmtl/sheltr-ai)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg?style=for-the-badge)](https://www.python.org/downloads/)\n[![Last Updated](https://img.shields.io/badge/Last%20Updated-August%204%2C%202025-brightgreen?style=for-the-badge)](https://github.com/mrj0nesmtl/sheltr-ai)\n\n---\n\n## 🎯 Mission\n\n**Hacking homelessness through technology.** SHELTR-AI empowers direct, transparent charitable giving through QR-code enabled donations, blockchain verification, and AI-driven insights. Every donation follows our SmartFund™ distribution: 80% direct to participants, 15% to sustainable housing, 5% to platform operations.\n\n## 🚀 Quick Start\n\n- **New to SHELTR-AI?** → Start with [Overview \u0026 Vision](docs/01-overview/README.md)\n- **Want to develop?** → Check [Development Roadmap](docs/04-development/dev-roadmap.md)\n- **Need API docs?** → Visit [API Documentation](docs/03-api/README.md)\n- **User guidance?** → See [User Guides](docs/06-user-guides/participant-guide.md)\n\n---\n\n## 📚 Documentation Sections\n\n### 🌟 [01. Overview](docs/01-overview/)\n- [Getting Started \u0026 Vision](docs/01-overview/README.md)\n- [Mission: Hacking Homelessness](docs/01-overview/hacking_homelessness.md)\n- [Documentation Strategy](docs/01-overview/SHELTR-AI-DOCS-PLAN.md)\n- [Implementation Roadmap](docs/01-overview/SHELTR-AI-IMPLEMENTATION-PLAN.md)\n\n### 🏗️ [02. Architecture](docs/02-architecture/)\n- [System Design](docs/02-architecture/system-design.md)\n- [Official Whitepaper](docs/02-architecture/whitepaper_final.md)\n- [Blockchain Integration](docs/02-architecture/technical/blockchain.md)\n- [SHELTR Tokenomics](docs/02-architecture/tokenomics/sheltr-tokenomics.md)\n\n### 🔌 [03. API Documentation](docs/03-api/)\n- [FastAPI Overview](docs/03-api/README.md)\n- [Authentication Endpoints](docs/03-api/README.md#authentication)\n- [User Management APIs](docs/03-api/README.md#user-management)\n- [Donation System APIs](docs/03-api/README.md#donations)\n\n### 👩‍💻 [04. Development](docs/04-development/)\n- [Development Roadmap](docs/04-development/dev-roadmap.md)\n- [Session 5.5: About \u0026 Solutions Redesign](docs/04-development/SESSION-05.5-ABOUT-SOLUTIONS-REDESIGN.md)\n- [Session 6: Multi-Dashboard Development](docs/04-development/SESSION-06-MULTI-DASHBOARD-DEVELOPMENT.md)\n- [Session 5: GitHub Security \u0026 Super Admin](docs/04-development/SESSION-05-GITHUB-SECURITY-SUPER-ADMIN.md)\n- [Session 4: Super Admin Dashboard](docs/04-development/SESSION-04-SUPER-ADMIN-DASHBOARD.md)\n- [Session 3: Authentication \u0026 RBAC](docs/04-development/SESSION-03-AUTHENTICATION-RBAC.md)\n\n### 👥 [06. User Guides](docs/06-user-guides/)\n- [Participant Guide](docs/06-user-guides/participant-guide.md)\n- Shelter Admin Guide *(Coming Soon)*\n- Donor Guide *(Coming Soon)*\n- SuperAdmin Guide *(Coming Soon)*\n\n### 🔄 [09. Migration](docs/09-migration/)\n- [Database Migration Complete](docs/09-migration/DATABASE_MIGRATION_COMPLETE.md)\n- [Migration Strategy](docs/09-migration/DATABASE_MIGRATION_PLAN.md)\n- [From Supabase Migration](docs/09-migration/from-supabase.md)\n\n### 🤖 AI Agent Documentation\n- [Claude Agent Briefing](docs/CLAUDE-AGENT-BRIEFING.md)\n- [Agent Communication Protocols](docs/CLAUDE-AGENT-COMMUNICATION.md)\n\n---\n\n## 🎯 Four-Role System\n\nSHELTR-AI operates on a comprehensive four-role user system designed for maximum flexibility and security:\n\n| Role | Description | Access Level | Tenant Location | **🆕 New Features** |\n|------|-------------|--------------|-----------------|-------------------|\n| **👑 SuperAdmin** | SHELTR Founders \u0026 Platform Operators | Global system control | `tenants/platform/` | Advanced analytics, blockchain oversight |\n| **👨‍💼 Admin** | Shelter Operators \u0026 Staff | Shelter management | `tenants/shelter-{id}/` | Multi-shelter dashboards, participant management |\n| **👤 Participant** | Donation Recipients (Homeless Individuals) | Personal QR \u0026 donations | `tenants/shelter-{id}/participants/` or `tenants/participant-network/` | **🆕 Independent registration, QR code generation** |\n| **💝 Donor** | People Making Donations | Donation \u0026 impact tracking | `tenants/donor-network/` | Real-time impact tracking, donation history |\n\n### **🆕 Participant Independence**\nParticipants can now register **independently** of shelters, creating a more inclusive network:\n- **Direct Registration**: QR code generation without shelter affiliation\n- **Cross-Shelter Mobility**: Maintain identity across multiple locations\n- **Personal Agency**: Own their donation profile and impact story\n\n---\n\n## 🪙 SHELTR Token \u0026 Blockchain System\n\n### **🆕 Enhanced Token Architecture**\n\nWe've expanded our blockchain integration with multiple token options and enhanced smart contract functionality:\n\n#### **Token Options**\n1. **🔵 USDC Integration** - Price-stable donations with immediate utility\n2. **🟢 Custom SHLTR Token** - Platform-native with governance features  \n3. **🟡 Hybrid System** - USDC for donations + SHLTR for governance + NFT impact certificates\n\n#### **SmartFund™ Smart Contracts**\nEvery donation automatically distributes through audited smart contracts:\n\n```solidity\n// SmartFund™ Distribution\nfunction processDonation(address participant, uint256 amount) external {\n    uint256 toParticipant = (amount * 80) / 100;  // 80% direct\n    uint256 toHousing = (amount * 15) / 100;      // 15% housing fund\n    uint256 toOperations = (amount * 5) / 100;    // 5% platform ops\n    \n    // Instant, transparent distribution\n    token.transfer(participant, toParticipant);\n    token.transfer(housingFund, toHousing);\n    token.transfer(operationsFund, toOperations);\n}\n```\n\n#### **🆕 Blockchain Features**\n- **🔍 Public Explorer**: Real-time transaction tracking\n- **🏆 Impact NFTs**: Donation certificates and achievement badges\n- **🗳️ DAO Governance**: Community-driven platform decisions\n- **⚡ Layer 2**: Polygon integration for low-cost transactions\n- **🛡️ Multi-sig**: Enhanced security for fund management\n\n**→ [Complete Blockchain Documentation](docs/02-architecture/technical/blockchain.md)**\n\n---\n\n## 🛠️ Technology Stack\n\n### **🆕 Updated Stack - SHELTR-AI 2.0**\n\n#### Frontend \u0026 Mobile\n- **Web**: Next.js 15 + React 18 + TypeScript 5.0+\n- **Mobile**: Expo SDK 50 + React Native\n- **UI**: Tailwind CSS + Shadcn/UI + Radix UI\n- **State**: Zustand + React Hook Form + Zod validation\n- **Real-time**: Firebase SDK v9+ with real-time listeners\n\n#### Backend \u0026 Database  \n- **API**: FastAPI + Python 3.11 + Async/Await\n- **Database**: Firebase Firestore (multi-tenant architecture)\n- **Auth**: Firebase Authentication + custom claims + role-based access\n- **Storage**: Firebase Storage + Google Cloud Storage\n- **Queue**: Google Cloud Tasks + Pub/Sub\n\n#### **🆕 Blockchain \u0026 AI**\n- **Blockchain**: Ethereum + Polygon + Smart Contracts (Solidity)\n- **Token**: Multi-option system (USDC/SHLTR/Hybrid)\n- **AI**: OpenAI GPT-4 + LangChain + Custom analytics\n- **ML**: Google Cloud AI for predictive insights\n\n#### **🆕 Infrastructure \u0026 DevOps**\n- **Hosting**: Firebase Hosting + Google Cloud Run (serverless)\n- **Deployment**: Docker + GitHub Actions + automated testing  \n- **Monitoring**: Google Cloud Monitoring + Sentry + custom dashboards\n- **CDN**: Firebase CDN + Cloud Storage global distribution\n- **Security**: Google Cloud Security Command Center + automated audits\n\n#### **🆕 Development Tools**\n- **IDE**: Cursor (Claude 4 Sonnet integration) + VS Code settings\n- **Monorepo**: TurboRepo + shared packages + optimized builds\n- **Testing**: Jest + Cypress + Playwright + Python pytest\n- **Code Quality**: ESLint + Prettier + Black + MyPy + pre-commit hooks\n\n---\n\n## 🌟 Key Features\n\n✅ **QR-Code Donations** - Instant scan-and-give system  \n✅ **Blockchain Verification** - Transparent, immutable transactions  \n✅ **Multi-Tenant SaaS** - Scalable shelter management  \n✅ **AI-Powered Analytics** - Data-driven impact insights  \n✅ **Mobile-First Design** - Native iOS/Android experience  \n✅ **Real-Time Dashboards** - Live donation tracking  \n✅ **SmartFund™ Distribution** - Automated 80/15/5 allocation  \n✅ **Role-Based Access** - Four-tier permission system  \n\n### **🆕 New Features in SHELTR-AI 2.0**\n🆕 **Independent Participant Registration** - No shelter requirement  \n🆕 **Firebase Real-time Sync** - Live updates across all platforms  \n🆕 **Google Cloud Run Backend** - Serverless, auto-scaling API  \n🆕 **Enhanced Blockchain Integration** - Multi-token support + NFTs  \n🆕 **Advanced AI Analytics** - Predictive insights + impact modeling  \n🆕 **Monorepo Architecture** - Streamlined development workflow  \n🆕 **Docker Containerization** - Consistent deployment environments  \n🆕 **Automated CI/CD** - GitHub Actions + automated testing  \n✨ **LIVE AUTHENTICATION** - Complete 4-role RBAC system operational  \n✨ **WORKING DASHBOARDS** - Role-specific interfaces with real data  \n\n---\n\n## 🚀 **Development Status \u0026 Roadmap**\n\n### **🎯 Current Phase: SESSION 8 COMPLETE ✅ - Core Business Logic + Mobile Dashboard Polish**\n- ✅ Repository structure and documentation\n- ✅ Python virtual environment setup  \n- ✅ FastAPI backend foundation\n- ✅ Firebase project configuration\n- ✅ **LIVE WEBSITE**: https://sheltr-ai.web.app\n- ✅ **Complete UI**: All stakeholder pages, tokenomics, impact dashboard\n- ✅ **Professional Design**: Shadcn UI with theme toggle\n- ✅ **COMPLETE AUTHENTICATION**: 4-role RBAC system working\n- ✅ **JOEL'S SUPER ADMIN**: Live dashboard with platform oversight\n- ✅ **LIVE BUTTONS**: All website CTAs now functional\n- ✅ **📱 MOBILE NAVIGATION**: Hamburger menu on all public pages\n- ✅ **🎨 THEME-AWARE LOGOS**: Dynamic logo switching for light/dark modes\n- ✅ **📄 GLOBAL FOOTER**: Standardized footer component across all pages\n- ✅ **🧹 REPOSITORY CLEANUP**: Professional .gitignore and file organization\n- ✅ **🏠 ABOUT PAGE REDESIGN**: Complete overhaul with forward-looking messaging\n- ✅ **💫 IMPACT PAGE**: Internet Angels integration and future vision focus\n- ✅ **📋 SOLUTIONS ENHANCEMENT**: Professional case studies and policy briefs\n- ✅ **📚 DOCUMENTATION HUB**: Enhanced with new docs and fixed links\n- ✅ **📱 MOBILE DASHBOARD POLISH**: All 7 dashboard pages redesigned for mobile perfection\n- ✅ **💬 ENHANCED CHATBOT**: Pop-out windows, fullscreen mode, mobile optimization\n- ✅ **🔧 THEME TOGGLE INTEGRATION**: Dashboard theme switching with perfect positioning\n- ✅ **🚀 SERVICE BOOKING SYSTEM**: Complete backend API with FastAPI endpoints\n- ✅ **📝 FORM PERSISTENCE**: Real-time data saving with Firebase integration\n- ✅ **🐛 PRODUCTION BUILD FIXES**: All TypeScript errors resolved, deployment ready\n- 🔄 Advanced API endpoints expansion\n- ⏳ Blockchain integration phase\n\n### **📅 Upcoming Milestones**\n- **Week 3-4**: ✅ **COMPLETED EARLY** - Authentication system fully operational\n- **Week 5-6**: ✅ **COMPLETED** - Session 5.5 About \u0026 Solutions redesign  \n- **Week 7-8**: ✅ **COMPLETED** - Session 8 Core Business Logic + Mobile Dashboard Polish\n- **Week 9-10**: Advanced API endpoints + File upload system + Donation processing\n- **Week 11-12**: Blockchain integration + Smart contracts deployment\n- **Week 13-14**: Production scaling + Stakeholder onboarding + Mobile app development\n\n**→ [Complete Roadmap](docs/04-development/dev-roadmap.md)**\n\n---\n\n## 📞 Support \u0026 Community\n\n### **For Users \u0026 Organizations**\n- 📧 **General Support**: joel@arcanaconcept.com\n- 🏠 **Shelter Partnerships**: joel@arcanaconcept.com  \n- 📚 **User Guides**: [User Documentation](docs/06-user-guides/participant-guide.md)\n- 🔧 **Technical Support**: joel@arcanaconcept.com\n- 🌐 **Website**: [sheltr-ai.web.app](https://sheltr-ai.web.app)\n\n### **For Developers**\n- 📖 **Documentation Hub**: [Complete Documentation](docs/TABLE_OF_CONTENTS.md)\n- 🐛 **Issues**: [GitHub Issues](https://github.com/mrj0nesmtl/sheltr-ai/issues)\n- 💬 **Discussions**: [GitHub Discussions](https://github.com/mrj0nesmtl/sheltr-ai/discussions)\n- 🔧 **API Reference**: [FastAPI Docs](docs/03-api/README.md)\n- 🏗️ **Development Guide**: [Development Roadmap](docs/04-development/dev-roadmap.md)\n\n---\n\n**📖 \"Great documentation is the foundation of great software - and great impact.\"**\n\n*Last Updated: August 4, 2025 - Session 8 Complete: Core Business Logic + Mobile Dashboard Polish*\n\n**🌐 [Visit Live Site](https://sheltr-ai.web.app) | 🚀 [Get Started](docs/01-overview/README.md) | 🤝 [Contribute](CONTRIBUTING.md) | 💝 [Donate](https://sheltr-ai.web.app/scan-give) | 📖 [Documentation Hub](docs/TABLE_OF_CONTENTS.md)**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrj0nesmtl%2Fsheltr-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrj0nesmtl%2Fsheltr-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrj0nesmtl%2Fsheltr-ai/lists"}