{"id":30558287,"url":"https://github.com/cameronthecoder/vroom","last_synced_at":"2026-02-13T21:36:59.256Z","repository":{"id":310426489,"uuid":"1039795911","full_name":"cameronthecoder/vroom","owner":"cameronthecoder","description":"Full-stack insurance platform with policy management, claims processing, and complex relational data modeling. Built with Nuxt.js, Nuxt UI, and PostgreSQL.","archived":false,"fork":false,"pushed_at":"2025-08-24T06:46:36.000Z","size":467,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-30T08:23:28.201Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Vue","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/cameronthecoder.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,"zenodo":null}},"created_at":"2025-08-18T01:52:06.000Z","updated_at":"2025-08-24T06:46:40.000Z","dependencies_parsed_at":"2025-08-28T08:25:09.270Z","dependency_job_id":null,"html_url":"https://github.com/cameronthecoder/vroom","commit_stats":null,"previous_names":["cameronthecoder/vroom"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cameronthecoder/vroom","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cameronthecoder%2Fvroom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cameronthecoder%2Fvroom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cameronthecoder%2Fvroom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cameronthecoder%2Fvroom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cameronthecoder","download_url":"https://codeload.github.com/cameronthecoder/vroom/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cameronthecoder%2Fvroom/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29418652,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-13T06:24:03.484Z","status":"ssl_error","status_checked_at":"2026-02-13T06:23:12.830Z","response_time":78,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2025-08-28T08:20:00.780Z","updated_at":"2026-02-13T21:36:59.246Z","avatar_url":"https://github.com/cameronthecoder.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vroom! Auto Insurance Platform\n\nFull-stack insurance management system built with Nuxt.js, Nuxt UI, and PostgreSQL. Features complex relational data modeling with temporal relationships, policy lifecycle management, claims processing, and multi-role party management.\n\n\n# TODO List\n\n## 📋 Policies\n### Database \u0026 Models\n- [x] Set up policy table schema with sequences\n- [x] Configure policy status enum validation\n- [x] Create policy-party relationship tables\n- [x] Create database indexes for performance\n\n### API Routes\n- [ ] `POST /api/policies` - Create new policy\n- [ ] `GET /api/policies/:id` - Get policy with relationships\n- [ ] `PUT /api/policies/:id` - Update policy details\n- [ ] `GET /api/policies` - List/search policies\n- [ ] `POST /api/policies/:id/renew` - Policy renewal\n- [ ] `DELETE /api/policies/:id` - Cancel policy\n- [ ] `GET /api/policies/:id/history` - Policy change history\n\n### Stores \u0026 State\n- [ ] Main policy store with CRUD operations\n- [ ] Policy wizard store for creation flow\n- [ ] Policy search/filter state management\n- [ ] Coverage selection state management\n\n### UI Components\n- [ ] Policy creation wizard (7-step stepper)\n  - [ ] Basic info step\n  - [ ] Named insured step\n  - [ ] Vehicle details step\n  - [ ] Additional parties step\n  - [ ] Coverage selection step\n  - [ ] Review step\n  - [ ] Confirmation step\n- [ ] Policy dashboard/list view\n- [ ] Policy detail view\n- [ ] Policy renewal interface\n- [ ] Coverage modification forms\n\n### Business Logic\n- [ ] Policy number generation\n- [ ] State-specific coverage requirements\n- [ ] Premium calculation logic\n- [ ] Policy validation rules\n- [ ] Renewal date calculations\n\n## 🚗 Vehicles\n### Database \u0026 Models\n- [ ] Vehicle table with policy relationships\n- [ ] Vehicle-party relationship management\n- [ ] Vehicle coverage selection\n- [ ] VIN validation and uniqueness\n- [ ] Vehicle history tracking\n\n### API Routes\n- [ ] `POST /api/vehicles` - Add vehicle to policy\n- [ ] `GET /api/vehicles/:id` - Get vehicle details\n- [ ] `PUT /api/vehicles/:id` - Update vehicle info\n- [ ] `DELETE /api/vehicles/:id` - Remove from policy\n- [ ] `POST /api/vehicles/:id/parties` - Assign drivers/owners\n- [ ] `GET /api/vehicles/:id/coverages` - Get vehicle coverages\n\n### Stores \u0026 State\n- [ ] Vehicle management store\n- [ ] Vehicle search and filtering\n- [ ] Driver assignment state\n- [ ] Vehicle coverage state\n\n### UI Components\n- [ ] Vehicle add/edit forms\n- [ ] VIN decoder integration\n- [ ] Vehicle card display\n- [ ] Driver assignment interface\n- [ ] Vehicle coverage selector\n- [ ] Garaging address input\n\n### Business Logic\n- [ ] VIN format validation\n- [ ] Vehicle value estimation\n- [ ] Driver eligibility checks\n- [ ] Vehicle-specific coverage rules\n- [ ] Usage type validation\n\n## 📄 Claims\n### Database \u0026 Models\n- [ ] Claims table with policy references\n- [ ] Claim-vehicle relationships\n- [ ] Claim-party relationships (claimants, witnesses)\n- [ ] Claim status workflow\n- [ ] Coverage snapshot preservation\n- [ ] Claim documents/attachments\n\n### API Routes\n- [ ] `POST /api/claims` - File new claim\n- [ ] `GET /api/claims/:id` - Get claim details\n- [ ] `PUT /api/claims/:id` - Update claim\n- [ ] `GET /api/claims` - List/search claims\n- [ ] `POST /api/claims/:id/status` - Update claim status\n- [ ] `POST /api/claims/:id/documents` - Upload documents\n- [ ] `GET /api/claims/:id/timeline` - Claim activity log\n\n### Stores \u0026 State\n- [ ] Claims management store\n- [ ] Claim filing workflow state\n- [ ] Claim status tracking\n- [ ] Document upload state\n\n### UI Components\n- [ ] Claim filing wizard\n- [ ] Claims dashboard\n- [ ] Claim detail view\n- [ ] Status update interface\n- [ ] Document upload component\n- [ ] Claim timeline view\n- [ ] Claimant information forms\n\n### Business Logic\n- [ ] Claim validation rules\n- [ ] Status workflow enforcement\n- [ ] Coverage verification\n- [ ] Settlement calculations\n- [ ] Deductible applications\n\n## 👥 Customers (Parties)\n### Database \u0026 Models\n- [ ] Parties table (people/organizations)\n- [ ] People table with personal details\n- [ ] Organizations table for commercial entities\n- [ ] Contact information management\n- [ ] License information tracking\n- [ ] Customer relationships\n\n### API Routes\n- [ ] `POST /api/customers` - Create new customer\n- [ ] `GET /api/customers/:id` - Get customer profile\n- [ ] `PUT /api/customers/:id` - Update customer info\n- [ ] `GET /api/customers` - Search customers\n- [ ] `GET /api/customers/:id/policies` - Customer policies\n- [ ] `GET /api/customers/:id/claims` - Customer claims\n- [ ] `POST /api/customers/:id/contacts` - Add contact method\n\n### Stores \u0026 State\n- [ ] Customer management store\n- [ ] Customer search functionality\n- [ ] Contact information state\n- [ ] Customer relationship tracking\n\n### UI Components\n- [ ] Customer profile view\n- [ ] Customer creation/edit forms\n- [ ] Customer search interface\n- [ ] Contact management\n- [ ] Customer policy history\n- [ ] Customer claims history\n- [ ] Relationship mapping\n\n### Business Logic\n- [ ] Customer deduplication\n- [ ] Contact validation (email, phone)\n- [ ] License validation by state\n- [ ] Customer risk assessment\n- [ ] Communication preferences\n\n## 👤 Users (System Users)\n### Database \u0026 Models\n- [ ] Users table with authentication\n- [ ] User roles and permissions\n- [ ] User-customer relationships\n- [ ] Session management\n- [ ] Password security\n- [ ] User activity logging\n\n### API Routes\n- [ ] `POST /api/auth/register` - User registration\n- [ ] `POST /api/auth/login` - User authentication\n- [ ] `POST /api/auth/logout` - Session termination\n- [ ] `GET /api/users/profile` - Get user profile\n- [ ] `PUT /api/users/profile` - Update profile\n- [ ] `POST /api/users/password` - Change password\n- [ ] `GET /api/users/:id/activity` - User activity log\n\n### Stores \u0026 State\n- [ ] Authentication store\n- [ ] User profile management\n- [ ] Permission checking\n- [ ] Session state management\n\n### UI Components\n- [ ] Login/registration forms\n- [ ] User profile page\n- [ ] Password change interface\n- [ ] User dashboard\n- [ ] Navigation with role-based access\n- [ ] Account settings\n- [ ] Activity history view\n\n### Business Logic\n- [ ] Password strength validation\n- [ ] Role-based access control\n- [ ] Session timeout handling\n- [ ] Account lockout policies\n- [ ] Two-factor authentication (optional)\n\n## 🔧 Cross-Cutting Concerns\n### Global Features\n- [ ] Error handling and logging\n- [ ] Loading states across all modules\n- [ ] Data validation framework\n- [ ] Notification system\n- [ ] Audit trail functionality\n- [ ] PDF generation for documents\n- [ ] Email notifications\n- [ ] Responsive design\n- [ ] Accessibility compliance\n- [ ] Performance optimization\n\n### Testing\n- [ ] Unit tests for all stores\n- [ ] API endpoint testing\n- [ ] Component testing\n- [ ] Integration tests\n- [ ] End-to-end testing for workflows\n\n### Documentation\n- [ ] API documentation\n- [ ] Component documentation\n- [ ] Business rules documentation\n- [ ] User guides\n- [ ] Developer setup instructions\n\n\n\n## Generate Database Types\n```bash\nyarn kysely-codegen --dialect postgres --connectionString \"$DATABSE_URL\" --out-file app/types/db.ts\n```\n\n## Setup\n\nMake sure to install dependencies:\n\n```bash\n# npm\nnpm install\n\n# pnpm\npnpm install\n\n# yarn\nyarn install\n\n# bun\nbun install\n```\n\n## Development Server\n\nStart the development server on `http://localhost:3000`:\n\n```bash\n# npm\nnpm run dev\n\n# pnpm\npnpm dev\n\n# yarn\nyarn dev\n\n# bun\nbun run dev\n```\n\n## Production\n\nBuild the application for production:\n\n```bash\n# npm\nnpm run build\n\n# pnpm\npnpm build\n\n# yarn\nyarn build\n\n# bun\nbun run build\n```\n\nLocally preview production build:\n\n```bash\n# npm\nnpm run preview\n\n# pnpm\npnpm preview\n\n# yarn\nyarn preview\n\n# bun\nbun run preview\n```\n\nCheck out the [deployment documentation](https://nuxt.com/docs/getting-started/deployment) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcameronthecoder%2Fvroom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcameronthecoder%2Fvroom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcameronthecoder%2Fvroom/lists"}