-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Welcome to the UrbanAI wiki!
UrbanAI is a comprehensive backend platform and AI-agent service that empowers citizens, investors, and authorities to report, analyze, and resolve urban construction and environmental issues. The platform accepts geo-tagged photos and descriptions, automatically classifies potential code violations, crawls relevant local regulations, and—via an interactive AI agent—guides users through any additional data collection. Finally, it generates and submits compliant reports or documents to the appropriate municipal channels and tracks each case through to resolution.
- Photo-based reporting: Citizens can submit geo-tagged photos of construction irregularities, safety hazards, or environmental violations
- AI-powered classification: Automated analysis of images and descriptions to categorize issues
- Smart prioritization: Risk assessment and urgency classification based on safety impact
- Geo-location integration: Automatic detection of jurisdiction and applicable local regulations
- Regulatory database: Web-crawled repository of municipal laws, building codes, and environmental standards
- Compliance analysis: AI-driven assessment of whether reported issues constitute actual violations
- Guided data collection: Chat-based interface to gather additional information when needed
- Expert consultation: AI agent acts as both civil engineering and legal expert
- Measurement guidance: Interactive assistance for users to collect specific measurements or documentation
- Report generation: Automated creation of compliant reports and documentation
- Municipal integration: Direct submission to appropriate authorities via online forms or prepared documents
- Case tracking: Status monitoring from submission through resolution
- Follow-up management: Automated reminders and status updates
UrbanAI is built using modern software engineering principles with a layered architecture approach:
- Domain Layer: Core business logic and entities
- Application Layer: Use cases and business workflows
- Infrastructure Layer: Data persistence and external integrations
- Web API Layer: RESTful endpoints and API management
- Image Classification Service: Computer vision for construction issue detection
- Regulations Crawler: Web scraping service for municipal law databases
- AI Agent Service: Hugging Face-powered interactive consultation system
- Report Generator: Automated document creation and formatting
Detailed technical architecture including system components, data flow, and integration patterns.
- Component Diagram: Visual overview of system components and their relationships
- Sequence Diagrams: Process flows for key user interactions and system workflows
Complete REST API specification with endpoints, request/response schemas, and integration guidelines.
User experience design documentation including wireframes, user flows, and design system components.
Developer setup instructions, coding standards, and contribution guidelines.
- .NET Core: Latest LTS version for robust, scalable web services
- Entity Framework Core: Object-relational mapping for relational database operations
- NoSQL Integration: MongoDB/Cosmos DB for flexible document storage
- Azure Services: Cloud-native hosting and managed services
- Hugging Face: AI agent framework and model hosting
- Computer Vision APIs: Image classification and analysis
- Natural Language Processing: Text analysis and conversation management
- GitHub: Source code management and collaboration
- GitHub Actions: CI/CD pipeline automation
- GitFlow: Structured branching strategy for collaborative development
- Automated Testing: Unit, integration, and end-to-end test suites
- Infrastructure as Code: Automated deployment and environment management
- Clone the repository from GitHub
- Set up the development environment using the provided configuration
- Review the Architecture documentation for system overview
- Check the API Documentation for endpoint specifications
- Review the UX Design documentation for user workflows
- Contact the development team for integration requirements
- Provide local regulation databases and reporting procedures
- The mobile and web applications will be available upon completion
- Training materials and user guides will be provided with the release
- Support channels will be established for issue reporting and assistance
UrbanAI is currently in active development, combining two key deliverables:
- Performance API Task: Building a production-ready RESTful .NET Core Web API with comprehensive testing
- Hugging Face AI-Agent Integration: Implementing intelligent conversation and analysis capabilities
The project follows agile development practices with continuous integration and deployment pipelines.
This project follows enterprise-grade development practices:
- Code Quality: SOLID principles, design patterns, and comprehensive testing
- Documentation: Living documentation with architecture decision records (ADRs)
- Security: Secure credential management and compliance with data protection standards
- Performance: Scalable design with monitoring and observability built-in
UrbanAI represents the future of citizen-driven urban development oversight, combining cutting-edge AI technology with practical municipal governance to create safer, more compliant urban environments.