Smart Inventory Tracker

A full-stack inventory management system built with Angular frontend and ASP.NET Core Web API backend, integrated with Firebase for real-time data synchronization.

Tech Stack

Frontend (sit-frontend)

• Angular 18+ - Modern web framework with standalone components
• Bootstrap 5 - UI styling and responsive design
• Chart.js & ngx-charts - Data visualization
• Angular Fire - Firebase integration for Angular

Backend (sit-backend)

• ASP.NET Core 8 - Web API framework
• Swagger/OpenAPI - API documentation
• CORS - Configured for Angular frontend integration

Database & Services

• Firebase - Real-time database and authentication

Project Structure

SmartInventory/
├── sit-frontend/          # Angular frontend application
│   ├── src/
│   │   ├── app/
│   │   │   ├── components/    # Feature components
│   │   │   │   ├── login/
│   │   │   │   ├── dashboard/
│   │   │   │   ├── products/
│   │   │   │   ├── notifications/
│   │   │   │   └── chatbot/
│   │   │   ├── services/      # Business logic services
│   │   │   ├── guards/        # Route guards
│   │   │   └── shared/        # Shared components and utilities
│   │   └── styles.css
│   └── angular.json
│
├── sit-backend/           # ASP.NET Core Web API
│   ├── Controllers/       # API controllers
│   ├── Services/          # Business logic services
│   ├── Models/            # Data models
│   ├── Security/          # Authentication & authorization
│   └── Program.cs
│
├── README.md
└── .gitignore

Prerequisites

• Node.js (v18 or higher) and npm
• .NET 8 SDK
• Angular CLI (installed globally or via npx)
• Firebase account (for database and authentication)

Getting Started

Frontend Setup

1. Navigate to the frontend directory:

   cd sit-frontend

2. Install dependencies:

   npm install

3. Start the development server:

   ng serve

4. The application will be available at http://localhost:4200

Backend Setup

1. Navigate to the backend directory:

   cd sit-backend

2. Restore dependencies (usually done automatically):

   dotnet restore

3. Run the API:

   dotnet run

4. The API will be available at https://localhost:5001 or http://localhost:5000

5. Swagger UI will be available at https://localhost:5001/swagger (in development mode)

Health Check

Test the backend API health endpoint:

GET http://localhost:5000/api/health

Expected response:

{
  "status": "ok"
}

Development Notes

• CORS: The backend is configured to allow requests from http://localhost:4200
• Standalone Components: Angular 18+ uses standalone components (no NgModules)
• HttpClient: Already configured in app.config.ts for API calls
• Bootstrap: Global Bootstrap CSS is included via angular.json

Next Steps

• Configure Firebase connection
• Implement authentication
• Set up API services in Angular
• Create data models
• Implement business logic

License

This project is part of the Smart Inventory Tracker system.