{"id":21342803,"url":"https://github.com/colburncodes/oasistrack","last_synced_at":"2025-03-16T03:12:21.759Z","repository":{"id":253319941,"uuid":"843155043","full_name":"colburncodes/oasistrack","owner":"colburncodes","description":"This system caters to both drivers and administrators, providing tools for route management, inventory tracking, and data analysis.","archived":false,"fork":false,"pushed_at":"2024-09-28T15:25:28.000Z","size":108,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-15T20:14:45.137Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/colburncodes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-08-15T22:41:51.000Z","updated_at":"2024-09-28T03:33:11.000Z","dependencies_parsed_at":"2024-09-07T23:27:10.328Z","dependency_job_id":"fb103778-9300-4bc4-8b13-9e6b1e935bab","html_url":"https://github.com/colburncodes/oasistrack","commit_stats":null,"previous_names":["colburncodes/oasistrack"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colburncodes%2Foasistrack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colburncodes%2Foasistrack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colburncodes%2Foasistrack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colburncodes%2Foasistrack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/colburncodes","download_url":"https://codeload.github.com/colburncodes/oasistrack/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235143691,"owners_count":18942798,"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","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":[],"created_at":"2024-11-22T01:10:04.212Z","updated_at":"2025-01-22T15:43:58.606Z","avatar_url":"https://github.com/colburncodes.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OasisTrack: Food Inventory Management System\n\nOasisTrack is a comprehensive solution designed to address the challenges of food deserts by efficiently managing inventory and deliveries for stores in underserved areas. This system caters to both drivers and administrators, providing tools for route management, inventory tracking, and data analysis.\n\n## Table of Contents\n\n- [Features](#features)\n- [Project Structure](#project-structure)\n- [Getting Started](#getting-started)\n    - [Prerequisites](#prerequisites)\n    - [Installation](#installation)\n- [Usage](#usage)\n- [API Endpoints](#api-endpoints)\n- [Mobile App](#mobile-app)\n- [Admin Web Interface](#admin-web-interface)\n- [Technologies Used](#technologies-used)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Features\n\n### For Drivers\n- Secure account login\n- Daily route and store information access\n- Real-time price change notifications\n- Inventory management (par levels, sales, shrinkage)\n- Delivery comments and data submission\n- Data correction capabilities\n- Maintenance request submission (optional)\n\n### For Administrators\n- Store and route management\n- Sales agreement administration\n- Global and local item pricing control\n- Weekly invoice generation\n- Comprehensive data access and analysis\n\n## Project Structure\n\n```\nOasisTrack/\n├── src/\n│   ├── OasisTrack.Core/\n│   ├── OasisTrack.Infrastructure/\n│   ├── OasisTrack.Application/\n│   └── OasisTrack.WebApi/\n├── tests/\n└── README.md\n```\n\nFor a detailed breakdown of the project structure, please refer to the [Project Structure Document](PROJECT_STRUCTURE.md).\n\n## Getting Started\n\n### Prerequisites\n\n- .NET 8 SDK\n- Node.js (v14 or later)\n- Postgresql (or your preferred database)\n- Android Studio (for mobile app development)\n\n### Installation\n\n1. Clone the repository:\n   ```\n   git clone https://github.com/yourusername/oasistrack.git\n   cd oasistrack\n   ```\n\n2. Set up the .NET backend:\n   ```\n   cd src\n   dotnet restore\n   dotnet build\n   ```\n\n3. Set up the Next.js frontend (for admin interface):\n   ```\n   cd OasisTrack.Application\n   npm install\n   ```\n\n4. Configure your database connection in `appsettings.json` in the API project.\n\n5. Run database migrations:\n   ```\n   cd ../OasisTrack.WebApi\n   dotnet ef database update\n   ```\n\n6. For the Android app, open the mobile project in Android Studio and follow the setup wizard.\n\n## Usage\n\n### Running the API\n\n1. Start the API:\n   ```\n   dotnet run --project OasisTrack.API\n   ```\n\n### Running the Admin Web Interface\n\n1. In a new terminal, start the Next.js dev server:\n   ```\n   cd src/OasisTrack.Web\n   npm run dev\n   ```\n\n2. Open your browser and navigate to `http://localhost:3000`\n\n### Deploying the Mobile App\n\n1. Build the Android app in Android Studio\n2. Deploy to tablets using your preferred method (e.g., Google Play Store, direct APK installation)\n\n## API Endpoints\n\n- `POST /api/auth/login` - User authentication\n- `GET /api/driver/route` - Get driver's daily route\n- `GET /api/driver/store/{id}` - Get store details\n- `POST /api/driver/delivery` - Submit delivery data\n- `PUT /api/driver/delivery/{id}` - Update delivery data\n- `GET /api/admin/stores` - List all stores\n- `POST /api/admin/store` - Create a new store\n- `PUT /api/admin/store/{id}` - Update store information\n- `GET /api/admin/invoices` - Generate store invoices\n\nFor a complete list of endpoints, refer to the API documentation.\n\n## Mobile App\n\nThe Android mobile app is designed for drivers to:\n- View their daily route\n- Access store information\n- Input delivery data\n- Submit maintenance requests\n\n## Admin Web Interface\n\nThe web interface allows administrators to:\n- Manage stores and routes\n- Control pricing and inventory\n- Generate invoices\n- Access and analyze data\n\n## Technologies Used\n\n- Backend: .NET 8, Entity Framework Core\n- API: ASP.NET Core\n- Admin Frontend: Next.js, React\n- Mobile App: Android (Kotlin/Java)\n- Database: Postgresql\n- Authentication: JWT (JSON Web Tokens)\n\n## Contributing\n\nWe welcome contributions to OasisTrack! Please read our [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolburncodes%2Foasistrack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcolburncodes%2Foasistrack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolburncodes%2Foasistrack/lists"}