PowderCoatingLogix/QUICK_START.md

QUICK START GUIDE - Get Running in 5 Minutes

🚀 Follow These Steps Exactly

Step 1: Create the Database (2 minutes)

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)

# 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:

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:

# 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:

"Server=(localdb)\\mssqllocaldb;Database=PowderCoatingDb;Trusted_Connection=true;MultipleActiveResultSets=true"

---

📋 Complete Command Reference

Create Database:

cd src/PowderCoating.Web
dotnet ef migrations add InitialCreate --project ../PowderCoating.Infrastructure
dotnet ef database update --project ../PowderCoating.Infrastructure

Run Web App:

cd src/PowderCoating.Web
dotnet run

Run API (Optional):

cd src/PowderCoating.Api
dotnet run

Run with Auto-Reload:

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:

# 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! 🎉