vgvengi/crm-full-stack

Purpose and Shape

This is a small CRM-style dashboard with Companies and Contacts management views, plus dashboard widgets for tasks, meetings, and sales pipeline. It is split into a React/Vite frontend and a Node/TypeScript backend with database-backed resource routes.

Runtime Entry Points

• Frontend bootstraps React from frontend/src/main.tsx, renders the application shell in frontend/src/App.tsx, and defines page selection in frontend/src/routes/AppRoutes.tsx.

• Backend starts its HTTP server in backend/server.ts; database connectivity is centralized in backend/config/db.ts.

Frontend Application Shell

• The dashboard layout is the main UI composition boundary in frontend/src/layouts/dashboard/Dashboard.tsx.

• Navigation is represented by side-navigation and top-bar components, notably frontend/src/components/side-nav/SideNav.tsx and frontend/src/components/top-bar/TopBar.tsx.

• The UI uses local reusable primitives under frontend/@/components/ui/button.tsx and frontend/src/ui/tooltip.tsx; these are presentation infrastructure rather than domain ownership.

Companies Domain Flow

• The Companies page is rooted at frontend/src/pages/companies/Companies.tsx.

• Table-based display and row rendering are separated into frontend/src/pages/companies/components/CompaniesTable.tsx and frontend/src/pages/companies/components/CompaniesTableRow.tsx.

• Company creation/editing is represented by frontend/src/pages/companies/components/CompanyForm.tsx.

• Backend company HTTP handling is isolated in backend/routes/companies.routes.ts, forming the frontend-to-server domain boundary.

Contacts Domain Flow

• Contacts are rendered from frontend/src/pages/contact/Contacts.tsx and frontend/src/pages/contact/ContactsTable.tsx.

• Contact and related company edits have dedicated screens in frontend/src/pages/contact/EditContacts.tsx and frontend/src/pages/contact/EditCompanies.tsx.

• New-contact/account workflows are grouped under frontend/src/pages/contact/create-new/CreateNew.tsx and frontend/src/pages/contact/create-new/NewAccounts.tsx.

• Backend contact endpoints are owned by backend/routes/contacts.routes.ts.

Dashboard Modules

• The home/dashboard content begins at frontend/src/pages/home/Home.tsx.

• Domain widgets are independently composed for meetings, tasks, and pipeline: frontend/src/components/meetings/MeetingCard.tsx, frontend/src/components/tasks/Tasks.tsx, and frontend/src/components/sales-pipe-line/SalesPipeline.tsx.

• These appear to be frontend presentation modules; no corresponding backend routes are present in the supplied tree.

Data and Infrastructure Boundaries

• Browser navigation and component composition stay in the React frontend; resource persistence/API access should cross to the Node backend only through its Companies and Contacts routes.

• The backend database boundary is backend/config/db.ts; the specific database engine and ORM/driver are not identifiable from the supplied tree.

• Material runtimes are Vite/React/TypeScript in frontend/ and Node/TypeScript in backend/, with no external SaaS integrations visible.