PARTs Website

Team 3492's official website for scouting, team management, and public information.

This project was generated with Angular CLI version 18.2.3.

📚 Documentation

Comprehensive documentation is available in the docs/ directory:

• Architecture - Application structure, design patterns, and best practices
• Development - Contributing guide, testing, and development workflow
• Deployment - Docker builds, CI/CD pipeline, and deployment instructions

Quick Links

• Contributing Guide - Start here for contributing
• Angular Best Practices - Coding standards
• Domain Structure - Project organization
• Testing Guide - Running and writing tests
• Dockerfile Usage - Docker build instructions

🏗️ Architecture

This project follows Angular best practices with a domain-driven architecture:

• Domain/feature-based folder structure
• Barrel exports for cleaner imports
• ESLint and Prettier for code quality
• TypeScript strict mode
• Standalone components (Angular 14+)
• Lazy-loaded routes for optimal performance

See docs/architecture/ for detailed architecture documentation.

🚀 Quick Start

Development Server

npm install
npm start

Navigate to http://localhost:4200/. The application will automatically reload when you change source files.

Code Quality

# Lint your code
npm run lint
npm run lint:fix

# Format your code
npm run format:check
npm run format

Testing

# Run tests interactively
npm test

# Run tests once (CI mode)
npm run test:ci

# Generate coverage report
npm run test:coverage

See Testing Guide for detailed testing documentation.

🐳 Docker Builds

This project uses a unified Dockerfile with build arguments for different environments.

Production Build (Python runtime)

docker build --build-arg BUILD_CONFIGURATION=production --target runtime-production -t parts-website:prod .

UAT Build (Nginx runtime)

docker build --build-arg BUILD_CONFIGURATION=uat --target runtime-uat -t parts-website:uat .

For detailed Docker and deployment documentation, see docs/deployment/.

🔧 Additional Commands

Build

npm run build  # Production build

Build artifacts will be stored in the dist/ directory.

Code Scaffolding

ng generate component component-name

You can also use ng generate directive|pipe|service|class|guard|interface|enum|module.

End-to-End Tests

npm run e2e

Note: You need to first add a package that implements end-to-end testing capabilities.

📖 Learn More

• Angular CLI Documentation
• Angular Style Guide
• Project Documentation

🤝 Contributing

We welcome contributions! Please read our Contributing Guide to get started.

Before submitting a pull request:

1. Run npm run lint:fix to fix linting issues
2. Run npm run format to format code
3. Run npm test to ensure tests pass
4. Follow our Angular Best Practices

📄 License

[License information here]