PartsPilot is a full-stack automotive inventory platform built with React, TypeScript, FastAPI, PostgreSQL, Docker, and Power BI.
It combines authenticated inventory and supplier management with stock monitoring, operational analytics, reporting, and business intelligence.
v2.0.0 — Feature complete and moving into maintenance
| Area | Status | Area | Status |
|---|---|---|---|
| Full-stack application | ✅ Complete | Responsive UI | ✅ Complete |
| JWT authentication | ✅ Working | PostgreSQL | ✅ Connected |
| Inventory management | ✅ Complete | Supplier management | ✅ Complete |
| Dashboard analytics | ✅ Complete | Reports & CSV export | ✅ Complete |
| Power BI dashboard | ✅ Complete | Docker Compose | ✅ Working |
| Backend CI | ✅ Passing | Frontend CI | ✅ Passing |
| Docker CI | ✅ Passing | Frontend deployment | ✅ Live |
| Backend deployment | ⏳ Pending | Maintenance | 🔧 Active |
- JWT-authenticated application access
- Automotive inventory CRUD
- Supplier management
- Search, filtering, sorting, and pagination
- Low-stock and out-of-stock monitoring
- Operational dashboard and category insights
- Inventory valuation and reporting
- CSV report export
- Power BI inventory analytics
- Responsive desktop and mobile interfaces
| Area | Technologies |
|---|---|
| Frontend | React, TypeScript, Vite, Tailwind CSS |
| Backend | Python, FastAPI, SQLAlchemy, JWT |
| Database | PostgreSQL |
| Analytics | Power BI |
| Infrastructure | Docker, Docker Compose |
| CI/CD | GitHub Actions |
| Hosting | Vercel |
| Dashboard | Inventory | Mobile |
|---|---|---|
 |
 |
 |
The frontend is deployed on Vercel. Public backend deployment is currently pending.
git clone https://github.com/Iris408/partspilot.git
cd partspilot
docker compose up -d dbStart the API:
cd backend
uvicorn main:app --reload --port 8001Start the frontend:
cd frontend
npm install
npm run dev| Service | URL |
|---|---|
| Frontend | http://localhost:5173 |
| API | http://localhost:8001 |
| Swagger | http://localhost:8001/docs |
Detailed engineering documentation is available in docs/.
| Document | Description |
|---|---|
| Documentation Index | Technical documentation overview |
| API Reference | Authentication, inventory, supplier, and analytics endpoints |
| Architecture | Full-stack application architecture |
| Project Details | Technical decisions, implementation details, and limitations |
| Setup | Local development and environment setup |
| Testing | Automated testing and CI |
| Troubleshooting | Common development issues and fixes |
| Roadmap | Release history and maintenance direction |
PartsPilot was built as a full-stack automotive engineering project covering API development, relational data persistence, authentication, frontend application development, responsive UI, analytics, business intelligence, Docker, testing, and CI/CD.
v2.0.0 completes the project's primary feature-development cycle. Future work is focused on maintenance, automation, testing, dependency updates, and bug fixes.
Built by Iris408
This project is licensed under the MIT License.