A comprehensive platform built with deaf-first principles, providing accessible financial services, AI-powered assistance, and decentralized governance.
This repository contains OpenAPI specifications for all five core services of the MBTQ.dev:
Secure authentication system designed with deaf-first principles.
- Location:
services/deafauth/ - Base URL:
https://api.mbtq.dev/authauth.mbtq.dev - Documentation: DeafAUTH README
- OpenAPI Spec: openapi.yaml
Real-time accessibility features and synchronization.
- Location:
services/pinksync/ - Base URL:
https://api.mbtq.dev/syncsync.mbtq.dev - Documentation: PinkSync README
- OpenAPI Spec: openapi.yaml
Decentralized trust and verification layer.
- Location:
services/fibonrose/ - Base URL:
https://api.mbtq.dev/trusttrust.mbtq.dev - Documentation: Fibonrose README
- OpenAPI Spec: openapi.yaml
- Location:
services/magicians/ - Base URL:
https://api.mbtq.dev/magiciansmagicians.mbtq.dev - Documentation: 360Magicians README
- OpenAPI Spec: openapi.yaml
Decentralized governance and community management.
- Location:
services/dao/ - Base URL:
https://api.mbtq.dev/dao - Documentation: DAO README
- OpenAPI Spec: openapi.yaml
✔ All endpoints documented with OpenAPI 3.1
✔ Standardized responses across all services
✔ Shared DeafAUTH paseto security scheme
✔ Tags, components, pagination, error schemas
✔ Cloudflare-friendly JSON-only style
✔ Automated API testing with Jest
✔ SDK generation (TypeScript + Python)
✔ Interactive HTML documentation
✔ Fetch API examples for browsers
✔ Architecture documentation
✔ Production-ready specifications
- Architecture Documentation - System architecture, service relationships, and data flows
- Fetch API Examples - Browser-compatible API examples
- SDK Guide - TypeScript & Python SDK generation
- Interactive HTML Docs - Interactive API documentation (run
npm run docs:serveto view) - Quick Start Guide - Get up and running quickly
npm run generate:docs # Generate interactive HTML docs
npm run docs:serve # Serve docs at http://localhost:3000All MBTQ Universe services use DeafAUTH for authentication. Include the Bearer token in the Authorization header:
Authorization: Bearer <your_token>- Register a new user:
curl -X POST https://api.mbtq.dev/auth/register \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com", "password": "secure_password"}'- Login to get tokens:
curl -X POST https://api.mbtq.dev/auth/login \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com", "password": "secure_password"}'- Use the access token for API calls:
curl -X GET https://api.mbtq.dev/sync/status \
-H "Authorization: Bearer <your_access_token>"Note: The endpoints below show full paths including the service prefix (e.g., /auth/, /sync/). In the OpenAPI specifications, these are defined as relative paths (e.g., /register, /status) with the base URL specified in the servers section.
POST /auth/register- User registrationPOST /auth/login- User authenticationGET /auth/verify- Token verificationPOST /auth/refresh- Token refresh
GET /sync/status- Check synchronization statusPOST /sync/preferences- Update accessibility preferencesGET /sync/features- List available accessibility features
POST /trust/blockchain/verify- Verify blockchain transactionGET /trust//trust-score- Get trust scorePOST /trust/blockchain/record- Record new transaction
Comprehensive AI agent platform with 60+ endpoints including:
- Agent management (CRUD operations)
- Task execution and workflow orchestration
- Memory and context management
- File ingestion and RAG search
- Tool registration and management
- Scheduling and webhooks
- Analytics and cost tracking
See 360Magicians README for complete endpoint list.
GET /dao/proposals- List governance proposalsPOST /dao/vote- Submit voteGET /dao/members- List DAO members
Copy .env.example to .env and configure your environment variables:
cp .env.example .envSee .env.example for all required configuration options.
Google Cloud Integration:
- Google Cloud Vision API for visual accessibility features
- Google Speech-to-Text for real-time captioning
- Google Translate API for multi-language support
- PinkSync API acts as an API broker network for partners' APIs that enhance deaf accessibility
AI SDK Integration:
The platform uses multiple AI models for comprehensive coverage:
- OpenAI: GPT-4, GPT-4 Turbo for natural language processing
- Anthropic: Claude 3 for advanced reasoning
- Google: Gemini Pro for multimodal tasks
- TensorFlow.js: Client-side AI processing
- Hugging Face Transformers: Specialized accessibility models
This platform integrates with several related repositories:
- pinkycollie/pinksync - Fastify-based accessibility engine
- pinkycollie/deafauth-ecosystem - Authentication ecosystem
- pinkycollie/fibonrose - Blockchain trust layer
- pinkycollie/pinkflow - Hub pipeline integrator
Run comprehensive API tests for all services:
# Install dependencies
npm install
# Run all tests
npm test
# Run tests with coverage
npm run test:coverage
# Run specific service tests
npm test -- tests/deafauth
npm test -- tests/pinksync
npm test -- tests/magiciansSee tests/README.md for detailed testing documentation.
Validate all OpenAPI specifications:
# Validate specs
npm run validate:openapiAll specifications are validated and ready for:
- Documentation generation
- SDK generation (TypeScript, Python, Go, etc.)
- API gateway configuration
- Testing and mocking
Generate client SDKs from OpenAPI specifications:
# Generate TypeScript SDK
npm run generate:sdk:typescript
# Generate Python SDK
npm run generate:sdk:python
# Generate all SDKs
npm run generate:sdkGenerated SDKs will be in the sdks/ directory. See SDK.md for detailed documentation and usage examples.
const deafAuthMiddleware = async (req, res, next) => {
const token = req.headers.authorization?.split(' ')[1];
if (!token) {
return res.status(401).json({ error: 'No token provided' });
}
try {
const decoded = await verifyDeafAuthToken(token);
req.user = decoded;
next();
} catch (error) {
return res.status(403).json({ error: 'Invalid token' });
}
};
module.exports = deafAuthMiddleware;const pinkSyncMiddleware = async (req, res, next) => {
const userId = req.user?.id;
if (userId) {
const preferences = await getPinkSyncPreferences(userId);
req.accessibilityPrefs = preferences;
}
next();
};
module.exports = pinkSyncMiddleware;# Clone the repository
git clone https://github.com/pinkycollie/DEAF-FIRST-PLATFORM.git
cd DEAF-FIRST-PLATFORM
# Install dependencies
npm installnpm run validate:openapi# Run all tests
npm test
# Run with coverage
npm run test:coverage# Generate TypeScript SDK
npm run generate:sdk:typescript
# Generate Python SDK
npm run generate:sdk:pythonSee SDK.md for usage examples with TypeScript and Python.
Generate interactive API documentation:
# TypeScript SDK
openapi-generator-cli generate \
-i services/deafauth/openapi/openapi.yaml \
-g typescript-axios \
-o sdks/typescript/deafauth
# Python SDK
openapi-generator-cli generate \
-i services/deafauth/openapi/openapi.yaml \
-g python \
-o sdks/python/deafauthEach service can be deployed as a Cloudflare Worker for edge computing benefits.
Use Redoc, Swagger UI, or other documentation tools to generate interactive API documentation.
Implement automated testing, validation, and deployment for all services.
- Complete Infrastructure Overview
- Individual service README files in each service directory
- OpenAPI specifications in
services/*/openapi/openapi.yaml
Contributions are welcome! Please ensure all changes maintain accessibility standards and deaf-first principles.
See LICENSE file for details.
Built with deaf-first principles and a commitment to accessibility for all.
A deaf-first SaaS ecosystem with AI-powered workflows and comprehensive accessibility features.
🌐 View Live Demo on GitHub Pages
The DEAF-FIRST Platform is a monorepo containing multiple services designed with accessibility as the primary focus. It includes authentication, real-time synchronization, AI workflows, and specialized accessibility nodes.
The platform features a modern, cutting-edge showcase interface that demonstrates all services and capabilities. See GITHUB-PAGES-SETUP.md for deployment details.
- ♿ Accessibility First: WCAG 2.1 AAA compliant design throughout
- 🔐 Secure Authentication: JWT-based auth with DeafAUTH service
- 🔄 Real-time Sync: WebSocket-based synchronization with PinkSync
- 📊 AI-Powered: OpenAI integration for intelligent workflows
- 🏗️ Microservices Architecture: Independent, scalable services
- 🚀 CI/CD Pipeline: Automated testing, security scans, and deployment
- 🐳 Docker Ready: Full containerization support
- ☁️ Infrastructure as Code: Terraform templates included
- Architecture - Detailed system architecture and design
- Contributing Guide - How to contribute to this project
- Quick Start - Get up and running quickly
- GitHub Pages Setup - Deploy the showcase site
- Webhook API - Webhook system documentation
- MCP Servers - Model Context Protocol integration
- Security - Security policies and reporting
This is a monorepo managed with npm workspaces containing:
- frontend: React-based accessible user interface
- backend: Express API server
- services/deafauth: DeafAUTH authentication service with MCP server support
- services/pinksync: Real-time synchronization service
- services/fibonrose: Mathematical optimization engine
- services/accessibility-nodes: Modular accessibility features
- ai: AI services for deaf-first workflows
- Node.js >= 20.0.0
- npm >= 10.0.0
- PostgreSQL (for backend and deafauth)
- Redis (for pinksync)
- Clone the repository:
git clone https://github.com/pinkycollie/Deaf-First-Platform.git
cd Deaf-First-Platform- Install dependencies:
npm install- Set up environment variables:
cp .env.example .env
# Edit .env with your configuration- Run all services in development mode:
npm run devnpm run devnpm run dev:frontend # Frontend only
npm run dev:backend # Backend only
npm run dev:deafauth # DeafAUTH only
npm run dev:pinksync # PinkSync only
npm run dev:fibonrose # FibonRose only
npm run dev:a11y # Accessibility nodes onlynpm run build # Build all workspacesnpm run test # Run all tests
npm run test:e2e # Run end-to-end testsnpm run lint # Lint all workspaces
npm run format # Format code with Prettier
npm run type-check # TypeScript type checkingnpm run db:setup # Setup databases
npm run db:migrate # Run migrations
npm run db:seed # Seed databasesnpm run docker:up # Start all services with Docker
npm run docker:down # Stop Docker services
npm run docker:logs # View Docker logs
npm run build:docker # Build Docker imagesThe platform includes a comprehensive webhook system for real-time event notifications:
# Start backend with webhook support
npm run dev:backend
# Access webhook API at http://localhost:3000/api/webhooksFeatures:
- Register and manage webhooks via REST API
- Receive webhooks from external services (Xano, Stripe, etc.)
- HMAC-SHA256 signature verification
- 12 predefined event types (user, auth, document, accessibility, sync, AI)
- Webhook delivery tracking and history
- Test endpoints for development
Documentation:
- Quick Start Guide - Get started in minutes
- API Reference - Complete API documentation
- Migration Guide - Migrate from Xano
The platform includes Model Context Protocol (MCP) server support in several services:
- DeafAUTH: Authentication and user management
- PinkSync: Real-time data synchronization
- FibonRose: Mathematical optimization
- Accessibility Nodes: Accessibility features API
- AI Services: AI-powered workflows
To run MCP servers individually:
npm run mcp --workspace=services/deafauth
npm run mcp --workspace=services/pinksync
npm run mcp --workspace=services/fibonrose
npm run mcp --workspace=services/accessibility-nodes
npm run mcp --workspace=aiEach workspace is independently versioned and can be developed, tested, and deployed separately.
- React 18 with TypeScript
- Vite for fast development
- Accessible UI components
- Sign language support
- Express.js REST API
- PostgreSQL database
- JWT authentication
- RESTful endpoints
- Specialized authentication service
- Accessible authentication flows
- MCP server for auth operations
- User preference management
- Real-time WebSocket synchronization
- Redis-based pub/sub
- MCP server for sync operations
- Event-driven architecture
- Mathematical optimization algorithms
- Fibonacci-based scheduling
- MCP server for optimization queries
- Performance analytics
- Modular accessibility features
- Sign language interpretation
- Visual accessibility enhancements
- MCP server for accessibility APIs
- AI-powered workflows
- Natural language processing
- Sign language generation
- MCP server for AI operations
Create a .env file in the root directory:
# Database
DATABASE_URL=postgresql://user:password@localhost:5432/deafirst
DEAFAUTH_DATABASE_URL=postgresql://user:password@localhost:5432/deafauth
# Redis
REDIS_URL=redis://localhost:6379
# JWT
JWT_SECRET=your-secret-key
JWT_EXPIRY=7d
#Paseto
# Frontend
VITE_API_URL=http://localhost:3000
VITE_WS_URL=ws://localhost:3001
# Services Pending
DEAFAUTH_PORT=3002
PINKSYNC_PORT=3003
FIBONROSE_PORT=3004
A11Y_PORT=3005
AI_PORT=8###
# MagicianCore Services
OPENAI_API_KEY=your-openai-key
# Webhook Configuration
WEBHOOK_SECRET=your-webhook-secret-key-hereWe welcome contributions! Please read our CONTRIBUTING.md guide before submitting PRs.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes following our code standards
- Run tests and linting (
npm run lint && npm run test) - Commit your changes (
git commit -m 'feat: add amazing feature') - Push to your branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow the Conventional Commits specification
- Maintain WCAG 2.1 AAA accessibility compliance
- Write tests for new features
- Update documentation as needed
- Ensure all CI checks pass
MIT License - see LICENSE file for details
360 Magicians
- Deaf-first design
- Accessibility
- SaaS ecosystem
- modules workflows
- http platform management
- Real-time synchronization
- Sign language support =======
A comprehensive platform built with deaf-first principles, providing accessible financial services, AI-powered assistance, and decentralized governance.
This repository contains OpenAPI specifications for all five core services of the MBTQ Universe:
Secure authentication system designed with deaf-first principles.
- Location:
services/deafauth/ - Base URL:
https://api.mbtquniverse.com/auth - Documentation: DeafAUTH README
- OpenAPI Spec: openapi.yaml
Real-time accessibility features and synchronization.
- Location:
services/pinksync/ - Base URL:
https://api.mbtquniverse.com/sync - Documentation: PinkSync README
- OpenAPI Spec: openapi.yaml
Decentralized trust and verification layer.
- Location:
services/fibonrose/ - Base URL:
https://api.mbtquniverse.com/blockchain - Documentation: Fibonrose README
- OpenAPI Spec: openapi.yaml
Intelligent automation and assistance agents.
- Location:
services/magicians/ - Base URL:
https://api.mbtquniverse.com/ai - Documentation: 360Magicians README
- OpenAPI Spec: openapi.yaml
Decentralized governance and community management.
- Location:
services/dao/ - Base URL:
https://api.mbtquniverse.com/dao - Documentation: DAO README
- OpenAPI Spec: openapi.yaml
✔ All endpoints documented with OpenAPI 3.1
✔ Standardized responses across all services
✔ Shared DeafAUTH security scheme
✔ Tags, components, pagination, error schemas
✔ Cloudflare-friendly JSON-only style
✔ Automated API testing with Jest
✔ SDK generation (TypeScript + Python)
✔ Production-ready specifications
All MBTQ Universe services use DeafAUTH for authentication. Include the Bearer token in the Authorization header:
Authorization: Bearer <your_token>- Register a new user:
curl -X POST https://api.mbtquniverse.com/auth/register \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com", "password": "secure_password"}'- Login to get tokens:
curl -X POST https://api.mbtquniverse.com/auth/login \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com", "password": "secure_password"}'- Use the access token for API calls:
curl -X GET https://api.mbtquniverse.com/sync/status \
-H "Authorization: Bearer <your_access_token>"Note: The endpoints below show full paths including the service prefix (e.g., /auth/, /sync/). In the OpenAPI specifications, these are defined as relative paths (e.g., /register, /status) with the base URL specified in the servers section.
POST /auth/register- User registrationPOST /auth/login- User authenticationGET /auth/verify- Token verificationPOST /auth/refresh- Token refresh
GET /sync/status- Check synchronization statusPOST /sync/preferences- Update accessibility preferencesGET /sync/features- List available accessibility features
POST /blockchain/verify- Verify blockchain transactionGET /blockchain/trust-score- Get trust scorePOST /blockchain/record- Record new transaction
Comprehensive AI agent platform with 60+ endpoints including:
- Agent management (CRUD operations)
- Task execution and workflow orchestration
- Memory and context management
- File ingestion and RAG search
- Tool registration and management
- Scheduling and webhooks
- Analytics and cost tracking
See 360Magicians README for complete endpoint list.
GET /dao/proposals- List governance proposalsPOST /dao/vote- Submit voteGET /dao/members- List DAO members
Copy .env.example to .env and configure your environment variables:
cp .env.example .envSee .env.example for all required configuration options.
Google Cloud Integration:
- Google Cloud Vision API for visual accessibility features
- Google Speech-to-Text for real-time captioning
- Google Translate API for multi-language support
- PinkSync API acts as an API broker network for partners' APIs that enhance deaf accessibility
AI SDK Integration:
The platform uses multiple AI models for comprehensive coverage:
- OpenAI: GPT-4, GPT-4 Turbo for natural language processing
- Anthropic: Claude 3 for advanced reasoning
- Google: Gemini Pro for multimodal tasks
- TensorFlow.js: Client-side AI processing
- Hugging Face Transformers: Specialized accessibility models
This platform integrates with several related repositories:
- pinkycollie/pinksync - Fastify-based accessibility engine
- pinkycollie/deafauth-ecosystem - Authentication ecosystem
- pinkycollie/fibonrose - Blockchain trust layer
- pinkycollie/pinkflow - Hub pipeline integrator
Run comprehensive API tests for all services:
# Install dependencies
npm install
# Run all tests
npm test
# Run tests with coverage
npm run test:coverage
# Run specific service tests
npm test -- tests/deafauth
npm test -- tests/pinksync
npm test -- tests/magiciansSee tests/README.md for detailed testing documentation.
Validate all OpenAPI specifications:
# Validate specs
npm run validate:openapiAll specifications are validated and ready for:
- Documentation generation
- SDK generation (TypeScript, Python, Go, etc.)
- API gateway configuration
- Testing and mocking
Generate client SDKs from OpenAPI specifications:
# Generate TypeScript SDK
npm run generate:sdk:typescript
# Generate Python SDK
npm run generate:sdk:python
# Generate all SDKs
npm run generate:sdkGenerated SDKs will be in the sdks/ directory. See SDK.md for detailed documentation and usage examples.
const deafAuthMiddleware = async (req, res, next) => {
const token = req.headers.authorization?.split(' ')[1];
if (!token) {
return res.status(401).json({ error: 'No token provided' });
}
try {
const decoded = await verifyDeafAuthToken(token);
req.user = decoded;
next();
} catch (error) {
return res.status(403).json({ error: 'Invalid token' });
}
};
module.exports = deafAuthMiddleware;const pinkSyncMiddleware = async (req, res, next) => {
const userId = req.user?.id;
if (userId) {
const preferences = await getPinkSyncPreferences(userId);
req.accessibilityPrefs = preferences;
}
next();
};
module.exports = pinkSyncMiddleware;# Clone the repository
git clone https://github.com/pinkycollie/DEAF-FIRST-PLATFORM.git
cd DEAF-FIRST-PLATFORM
# Install dependencies
npm installnpm run validate:openapi# Run all tests
npm test
# Run with coverage
npm run test:coverage# Generate TypeScript SDK
npm run generate:sdk:typescript
# Generate Python SDK
npm run generate:sdk:pythonSee SDK.md for usage examples with TypeScript and Python.
Generate interactive API documentation:
# TypeScript SDK
openapi-generator-cli generate \
-i services/deafauth/openapi/openapi.yaml \
-g typescript-axios \
-o sdks/typescript/deafauth
# Python SDK
openapi-generator-cli generate \
-i services/deafauth/openapi/openapi.yaml \
-g python \
-o sdks/python/deafauthEach service can be deployed as a Cloudflare Worker for edge computing benefits.
Use Redoc, Swagger UI, or other documentation tools to generate interactive API documentation.
Implement automated testing, validation, and deployment for all services.
- Complete Infrastructure Overview
- Individual service README files in each service directory
- OpenAPI specifications in
services/*/openapi/openapi.yaml
Contributions are welcome! Please ensure all changes maintain accessibility standards and deaf-first principles.
See LICENSE file for details.
Built with deaf-first principles and a commitment to accessibility for all.
e961430