184 lines
3.6 KiB
Markdown
184 lines
3.6 KiB
Markdown
# QUICK START GUIDE - Get Running in 5 Minutes
|
|
|
|
## 🚀 Follow These Steps Exactly
|
|
|
|
### Step 1: Create the Database (2 minutes)
|
|
|
|
```bash
|
|
cd src/PowderCoating.Web
|
|
|
|
# Create the migration
|
|
dotnet ef migrations add InitialCreate --project ../PowderCoating.Infrastructure
|
|
|
|
# Create the database
|
|
dotnet ef database update --project ../PowderCoating.Infrastructure
|
|
```
|
|
|
|
**Expected Output:**
|
|
```
|
|
Build succeeded.
|
|
Applying migration '20250204_InitialCreate'.
|
|
Done.
|
|
```
|
|
|
|
✅ **Success!** The database is now created with all tables and seed data.
|
|
|
|
---
|
|
|
|
### Step 2: Run the Application (1 minute)
|
|
|
|
```bash
|
|
# Still in src/PowderCoating.Web
|
|
dotnet run
|
|
```
|
|
|
|
**Expected Output:**
|
|
```
|
|
info: Microsoft.Hosting.Lifetime[14]
|
|
Now listening on: https://localhost:7001
|
|
info: Microsoft.Hosting.Lifetime[0]
|
|
Application started. Press Ctrl+C to shut down.
|
|
```
|
|
|
|
✅ **Success!** The app is running!
|
|
|
|
---
|
|
|
|
### Step 3: Open in Browser (30 seconds)
|
|
|
|
1. Open your browser
|
|
2. Navigate to: **https://localhost:7001**
|
|
3. You should see the home page
|
|
|
|
---
|
|
|
|
### Step 4: Login (1 minute)
|
|
|
|
1. Click **"Login"** in the top right
|
|
2. Use these credentials:
|
|
- **Email:** `admin@powdercoating.com`
|
|
- **Password:** `Admin123!`
|
|
|
|
✅ **Success!** You're logged in as administrator!
|
|
|
|
---
|
|
|
|
## ✅ You're Done!
|
|
|
|
The application is now running. Next steps:
|
|
|
|
1. **Change the admin password** (important!)
|
|
2. **Start building features** - See `NEXT_STEPS.md`
|
|
3. **Create your first customer** - Follow the guide in NEXT_STEPS.md
|
|
|
|
---
|
|
|
|
## 🐛 Troubleshooting
|
|
|
|
### Problem: "dotnet ef command not found"
|
|
|
|
**Fix:**
|
|
```bash
|
|
dotnet tool install --global dotnet-ef
|
|
```
|
|
|
|
### Problem: App hangs when starting
|
|
|
|
**Cause:** SQL Server isn't running or connection failed.
|
|
|
|
**Fix:**
|
|
1. Make sure SQL Express is running
|
|
2. Or switch to LocalDB (see `TROUBLESHOOTING_STARTUP.md`)
|
|
|
|
### Problem: "Database already exists" error
|
|
|
|
**Fix:**
|
|
```bash
|
|
# Drop the database and start over
|
|
dotnet ef database drop --project ../PowderCoating.Infrastructure
|
|
dotnet ef database update --project ../PowderCoating.Infrastructure
|
|
```
|
|
|
|
### Problem: Can't connect to database
|
|
|
|
**Try LocalDB instead:**
|
|
|
|
Edit `appsettings.json` and change connection string to:
|
|
```json
|
|
"Server=(localdb)\\mssqllocaldb;Database=PowderCoatingDb;Trusted_Connection=true;MultipleActiveResultSets=true"
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 Complete Command Reference
|
|
|
|
**Create Database:**
|
|
```bash
|
|
cd src/PowderCoating.Web
|
|
dotnet ef migrations add InitialCreate --project ../PowderCoating.Infrastructure
|
|
dotnet ef database update --project ../PowderCoating.Infrastructure
|
|
```
|
|
|
|
**Run Web App:**
|
|
```bash
|
|
cd src/PowderCoating.Web
|
|
dotnet run
|
|
```
|
|
|
|
**Run API (Optional):**
|
|
```bash
|
|
cd src/PowderCoating.Api
|
|
dotnet run
|
|
```
|
|
|
|
**Run with Auto-Reload:**
|
|
```bash
|
|
dotnet watch run
|
|
```
|
|
|
|
**Stop the App:**
|
|
Press `Ctrl + C` in the terminal
|
|
|
|
---
|
|
|
|
## 🎯 Default Credentials
|
|
|
|
**Admin User:**
|
|
- Email: `admin@powdercoating.com`
|
|
- Password: `Admin123!`
|
|
|
|
**⚠️ IMPORTANT:** Change this password after first login!
|
|
|
|
---
|
|
|
|
## 📖 More Help
|
|
|
|
- **Startup Issues:** See `TROUBLESHOOTING_STARTUP.md`
|
|
- **Next Features:** See `NEXT_STEPS.md`
|
|
- **Development Guide:** See `DEVELOPMENT.md`
|
|
- **Full README:** See `README.md`
|
|
|
|
---
|
|
|
|
## ✅ Quick Verification
|
|
|
|
Run these to verify everything is working:
|
|
|
|
```bash
|
|
# 1. Check database was created
|
|
dotnet ef database update --project src/PowderCoating.Infrastructure --startup-project src/PowderCoating.Web
|
|
|
|
# 2. Build the solution
|
|
dotnet build
|
|
|
|
# 3. Run the app
|
|
cd src/PowderCoating.Web
|
|
dotnet run
|
|
|
|
# 4. Open browser to https://localhost:7001
|
|
|
|
# 5. Login with admin@powdercoating.com / Admin123!
|
|
```
|
|
|
|
If all of these work, you're ready to start building! 🎉
|