Initial commit: CityTrack MVP with documentation, templates, and license

.gitattributes

@@ -0,0 +1,35 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,37 @@
+# Code of Conduct
+
+## Our Commitment
+
+We are committed to providing a welcoming and inclusive environment for all contributors, regardless of their background or experience level.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+- Being respectful and inclusive
+- Using welcoming and inclusive language
+- Being open to constructive criticism
+- Focusing on what is best for the community
+- Showing empathy toward others
+
+Examples of unacceptable behavior include:
+
+- Harassment or discrimination of any kind
+- Trolling, insulting, or derogatory comments
+- Unwelcome sexual attention
+- Publishing private information
+- Other conduct that could negatively impact others
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project maintainers at [@0xarchit](https://github.com/0xarchit).
+
+All complaints will be reviewed and investigated fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/version/2/0/code_of_conduct.html).
+
+---
+
+**Together, we build a better community.**

.github/CONTRIBUTING.md

@@ -0,0 +1,58 @@
+# Contributing to CityTrack
+
+Thank you for your interest in contributing to CityTrack! We welcome all contributions to help improve urban infrastructure reporting.
+
+## Getting Started
+
+1. Fork the repository
+2. Clone your fork: `git clone https://github.com/0xarchit/CityTrack.git`
+3. Create a feature branch: `git checkout -b feature/your-feature`
+4. Make your changes
+5. Push to your branch and open a Pull Request
+
+## Development Setup
+
+```bash
+git clone https://github.com/0xarchit/CityTrack.git
+cd CityTrack
+docker-compose up -d
+npm install && pip install -r requirements.txt
+```
+
+## Code Style
+
+- Follow PEP 8 for Python code
+- Use ESLint for JavaScript/TypeScript
+- Write clear, meaningful commit messages
+- Add tests for new features
+
+## Pull Request Process
+
+1. Update documentation if applicable
+2. Add tests for new functionality
+3. Ensure all tests pass locally
+4. Provide a clear description of changes
+5. Reference any related issues
+
+## Reporting Bugs
+
+Use GitHub Issues to report bugs. Include:
+- Clear description of the bug
+- Steps to reproduce
+- Expected vs. actual behavior
+- System information
+
+## Suggesting Features
+
+We're open to new ideas! Create an issue with:
+- Clear feature description
+- Use cases
+- Any implementation suggestions
+
+## Questions?
+
+Feel free to open a discussion or issue if you have questions. We're here to help!
+
+---
+
+Built by BitBots | Team Lead: [@0xarchit](https://github.com/0xarchit)

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: 0xarchit
+buy_me_a_coffee: 0xarchit

.github/ISSUE_TEMPLATE/BUG_REPORT.md

@@ -0,0 +1,56 @@
+---
+name: Bug Report
+about: Report a bug you found in CityTrack
+title: "[BUG] "
+labels: bug
+assignees: 0xarchit
+---
+
+## Description
+Briefly describe the bug. What happened that shouldn't have?
+
+## Reproduction Steps
+Steps to reproduce the issue:
+
+1. Go to...
+2. Click on...
+3. See error...
+
+## Expected Behavior
+What did you expect to happen?
+
+## Actual Behavior
+What actually happened instead?
+
+## Environment
+- **OS:** (e.g., Windows 10, macOS 13, Ubuntu 22.04)
+- **Browser:** (e.g., Chrome 120, Firefox 121, Safari 17)
+- **Component:** (e.g., Mobile App, Admin Dashboard, Backend API)
+- **Version:** (e.g., v0.1.0)
+- **Device:** (e.g., iPhone 14, Desktop)
+
+## Screenshots or Logs
+If applicable, add screenshots or error logs here:
+
+```
+Paste error message or log output here
+```
+
+## Additional Context
+Add any other context about the problem here (network conditions, specific data, etc.)
+
+## Priority
+- [ ] Critical (App crash/data loss)
+- [ ] High (Feature broken)
+- [ ] Medium (Unexpected behavior)
+- [ ] Low (Minor issue)
+
+## Possible Solution
+If you have suggestions on how to fix this, describe them here.
+
+---
+
+**Checklist:**
+- [ ] I've searched existing issues to ensure this isn't a duplicate
+- [ ] I've provided clear steps to reproduce
+- [ ] I've included relevant environment information

.github/ISSUE_TEMPLATE/FEATURE_REQUEST.md

@@ -0,0 +1,80 @@
+---
+name: Feature Request
+about: Suggest a new feature or improvement for CityTrack
+title: "[FEATURE] "
+labels: enhancement
+assignees: 0xarchit
+---
+
+## Description
+Provide a clear and detailed description of the feature you'd like to see.
+
+## Problem It Solves
+What problem does this feature address? Why is it needed?
+
+- Current workflow pain point:
+- User frustration:
+- Impact:
+
+## Proposed Solution
+Describe how you envision this feature working:
+
+1. User would...
+2. System would...
+3. Result would be...
+
+## Alternatives Considered
+Have you thought of alternative solutions or features?
+
+- Option A: ...
+- Option B: ...
+
+## Use Cases
+Describe real-world scenarios where this feature would be useful:
+
+**Use Case 1:** 
+- Actor: (e.g., Citizen, Worker, Admin)
+- Action: ...
+- Expected outcome: ...
+
+**Use Case 2:**
+- Actor: ...
+- Action: ...
+- Expected outcome: ...
+
+## Affected Components
+Which parts of CityTrack would this feature affect?
+
+- [ ] Mobile App (Citizen)
+- [ ] Admin Dashboard
+- [ ] Worker Portal
+- [ ] Backend API
+- [ ] Database
+- [ ] AI/ML Pipeline
+
+## Acceptance Criteria
+What would make this feature "done"?
+
+- [ ] Criterion 1
+- [ ] Criterion 2
+- [ ] Criterion 3
+
+## Additional Context
+Add any other context, mockups, or references here.
+
+## Priority
+- [ ] Critical (Blocking other features)
+- [ ] High (High user impact)
+- [ ] Medium (Nice to have)
+- [ ] Low (Enhancement)
+
+## Related Issues
+Link to any related issues: #123
+
+---
+
+**Checklist:**
+- [ ] I've checked if this feature already exists
+- [ ] I've searched for existing feature requests
+- [ ] I've provided clear use cases
+- [ ] The scope is well-defined

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,93 @@
+# Pull Request: [Brief Title]
+
+## Description
+Please include a summary of the changes and related context. Why is this change being made?
+
+## Type of Change
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] Documentation update
+- [ ] Performance improvement
+- [ ] Code refactoring
+- [ ] Testing enhancement
+
+## Related Issue
+Closes #(issue number)
+
+## Changes Made
+Describe the specific changes in this PR:
+
+- Change 1: ...
+- Change 2: ...
+- Change 3: ...
+
+## Testing
+Describe what tests you've run and how to reproduce them:
+
+### Test Cases
+- [ ] Test case 1: ...
+- [ ] Test case 2: ...
+- [ ] Edge case: ...
+
+### Manual Testing Steps
+1. Step 1
+2. Step 2
+3. Expected result: ...
+
+## Affected Components
+Which parts of CityTrack are affected?
+
+- [ ] Mobile App
+- [ ] Admin Dashboard
+- [ ] Worker Portal
+- [ ] Backend API
+- [ ] Database
+- [ ] AI/ML Pipeline
+- [ ] Documentation
+- [ ] Other: ___________
+
+## Breaking Changes
+List any breaking changes and migration steps if applicable:
+
+- Breaking change 1:
+  - Migration: ...
+
+## Checklist
+- [ ] My code follows the code style of this project
+- [ ] I have performed a self-review of my own code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix/feature works
+- [ ] New and existing unit tests passed locally with my changes
+- [ ] Any dependent changes have been merged and published
+- [ ] I've updated the CHANGELOG (if applicable)
+
+## Performance Impact
+- [ ] No performance impact
+- [ ] Performance improvement (describe: ...)
+- [ ] Performance impact (describe: ... and why it's necessary)
+
+## Security Considerations
+Are there any security implications?
+
+- [ ] No security concerns
+- [ ] Security improvement (describe the fix: ...)
+- [ ] Requires security review (describe the change: ...)
+
+## Screenshots (if applicable)
+Add screenshots for UI changes:
+
+| Before | After |
+|--------|-------|
+| [Screenshot] | [Screenshot] |
+
+## Additional Notes
+Any additional information reviewers should know?
+
+---
+
+**Reviewer Notes:**
+- Review focus areas: ...
+- Questions for reviewers: ...

.github/SECURITY.md

@@ -0,0 +1,57 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+We take security vulnerabilities seriously. If you discover a security issue, please follow responsible disclosure practices:
+
+**Do not open a public GitHub issue for security vulnerabilities.**
+
+Instead, email your findings directly to the team lead:
+- **Archit Jain** (@0xarchit) - Team Lead
+
+Include:
+- Description of the vulnerability
+- Steps to reproduce (if applicable)
+- Potential impact
+- Suggested fix (if you have one)
+
+## Security Best Practices
+
+When contributing to CityTrack, please follow these security guidelines:
+
+### Authentication & Authorization
+- Never hardcode credentials or API keys
+- Use environment variables for sensitive data
+- Implement proper role-based access control (RBAC)
+
+### Data Protection
+- All images and GPS data must be encrypted in transit (HTTPS/TLS)
+- User authentication must use [Supabase Auth](https://supabase.com)
+- Implement rate limiting on API endpoints
+
+### Code
+- Keep dependencies updated
+- Run security audits regularly
+- Use parameterized queries to prevent SQL injection
+- Validate all user inputs
+
+### Infrastructure
+- Deploy in secure, containerized environments
+- Use environment variables for configuration
+- Implement proper logging and monitoring
+- Regular security updates for all services
+
+## Supported Versions
+
+- **MVP Release (v0.1.x):** Security updates will be provided
+
+## Disclosure Timeline
+
+- **Report:** Contact the team immediately
+- **Acknowledgment:** Within 48 hours
+- **Fix & Release:** Target 7-14 days for critical issues
+- **Public Disclosure:** After fix is released
+
+---
+
+Thank you for helping keep CityTrack secure!

LICENSE

@@ -0,0 +1,45 @@
+MIT License
+
+Copyright (c) 2026 BitBots Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+## Summary
+
+You are free to:
+- **Use** the software for any purpose, commercial or non-commercial
+- **Copy, modify, and distribute** the software
+- **Include** the software in proprietary applications
+
+You must:
+- **Include a copy** of this license and copyright notice in any distribution
+- **State significant changes** made to the software
+
+You cannot:
+- Hold the authors liable for any issues that arise from using this software
+- Use the authors' or contributors' names to endorse derivative works without permission
+
+## Contributors
+
+**Team Lead:** Archit Jain (@0xarchit)
+**Contributors:** Rachit Verma (@vxrachit), Pushpendra Sharma (@synapticpush), Deepti Yadav (@DeeptiYadav10648)
+
+Built by BitBots | HackTheThrone 2026

README.md

@@ -0,0 +1,95 @@
+---
+title: citytrack
+emoji: 🌆
+colorFrom: green
+colorTo: blue
+sdk: docker
+app_port: 7860
+pinned: true
+---
+
+# CityTrack
+
+> **Governance at the Speed of Software**
+
+CityTrack is an AI-powered urban issue reporting and management platform that transforms how cities handle infrastructure problems. Citizens report issues with AI validation, and autonomous agents route them to the right departments in real-time.
+
+## Quick Overview
+
+**The Problem:** Traditional city issue reporting systems are slow, manual, and prone to duplicates.
+
+**The Solution:** CityTrack uses AI agents to instantly validate, deduplicate, and intelligently route urban issues—turning citizens into real-time sensors for city infrastructure.
+
+## Key Features (MVP)
+
+- 📸 **Live Camera Capture:** Mandatory camera verification to prevent fake reports
+- 📍 **GPS Validation:** High-precision location data (< 10m accuracy)
+- 🤖 **AI Issue Classification:** Automatic detection of potholes, debris, and damaged infrastructure
+- 🔄 **Smart Deduplication:** Groups similar reports and prevents redundant tickets
+- 👷 **Worker Dashboard:** Task list with instant notifications and routing
+- 📱 **Citizen Tracking:** Real-time updates on report status
+
+## Getting Started
+
+### Prerequisites
+- Node.js 20+
+- Python 3.11+
+- Docker & Docker Compose
+- PostgreSQL with PostGIS extension
+
+### Installation
+
+```bash
+git clone https://github.com/0xarchit/CityTrack.git
+cd CityTrack
+
+docker-compose up -d
+
+npm install
+pip install -r requirements.txt
+```
+
+### Running the Project
+
+```bash
+docker-compose up
+
+npm run dev         # Frontend
+python main.py      # Backend
+```
+
+## Tech Stack
+
+- **Backend:** FastAPI, Python, SQLAlchemy, PostgreSQL
+- **Frontend:** Next.js, Tailwind CSS
+- **Mobile:** React Native, Expo
+- **AI/ML:** YOLOv8 (Issue Detection)
+- **Authentication:** Supabase
+- **Infrastructure:** Docker
+
+## The Autonomous Pipeline
+
+1. **Vision Agent** → Validates and classifies uploaded images
+2. **Geo-Dedup Agent** → Merges duplicate reports in the same area
+3. **Priority Agent** → Assigns urgency levels based on context
+4. **Routing Agent** → Matches issues to departments and workers
+5. **Notification Agent** → Sends updates to all stakeholders
+
+## Contributing
+
+We welcome contributions! Please read [CONTRIBUTING.md](.github/CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
+
+## Team
+
+Built by **BitBots** at IIIT Una, HackTheThrone 2026
+
+| Role | Name | GitHub |
+|------|------|--------|
+| Lead Developer | Archit Jain | [@0xarchit](https://github.com/0xarchit) |
+| Developer | Rachit Verma | [@vxrachit](https://github.com/vxrachit) |
+| Developer | Pushpendra Sharma | [@synapticpush](https://github.com/synapticpush) |
+| Developer | Deepti Yadav | [@DeeptiYadav10648](https://github.com/DeeptiYadav10648) |
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.