Angular Material + FastAPI HR Management CLAUDE.md Template

Overview

CLAUDE.md template for Angular Material + FastAPI HR Management provides a copyable Claude Code starter that outlines roles, rules, and project structure for this stack.

Direct answer: this template helps you scaffold an HR management app with an Angular Material frontend and a FastAPI backend, including security, validation, and deployment guidance.

When to Use This CLAUDE.md Template

• Starting a new HR management project with a modern frontend and API backend
• Creating a consistent CLAUDE.md for this stack to share with teammates
• Documenting architecture decisions and coding standards for Angular Material + FastAPI

Copyable CLAUDE.md Template

# CLAUDE.md
# Project role: Full-Stack Engineer for Angular Material frontend + FastAPI backend in an HR management app
# Architecture rules:
- Frontend: Angular Material UI with strict TS typings
- Backend: FastAPI with Pydantic models, connect to PostgreSQL
- API surface: REST endpoints with OpenAPI docs
# File structure rules:
- frontend/
- backend/
- tests/
- docs/
# Authentication rules:
- JWT Bearer tokens; OAuth2PasswordBearer; refresh tokens
- Secure cookies for web clients when applicable
# Database rules:
- PostgreSQL; migrations with Alembic; environment-based config
# Validation rules:
- Pydantic models with explicit validators; clear error messages
# Security rules:
- TLS, CORS restrictions, CSRF off for APIs, no hard-coded secrets
- Apply rate limiting on mutating endpoints
# Testing rules:
- Pytest for backend; httpx for API tests; frontend tests with Angular testing utilities
# Deployment rules:
- Docker Compose for local dev; Dockerfiles for frontend and backend; CI/CD pipelines
# Things Claude must not do:
- Do not embed secrets in code; Do not expose admin endpoints publicly; Do not bypass input validation

Recommended Project Structure

frontend/
  angular.json
  package.json
  src/
    app/
      core/
      features/
        hr/
          components/
          views/
      shared/
backend/
  main.py
  api/
    v1/
      endpoints/
      models/
  services/
  database/
  requirements.txt

Core Engineering Principles

• Explicit contracts between frontend and backend via REST/OpenAPI
• Strong typing with TypeScript on the frontend and Pydantic on the backend
• Maintainable code via modular structure and clear boundaries
• Security by default: proper authentication, authorization, and secrets management
• Test-driven development with unit and integration tests

Code Construction Rules

• Frontend uses Angular Material components with strict TS configuration
• Backend uses FastAPI with Pydantic models for validation
• Database access via SQLAlchemy/SQLModel; migrations with Alembic
• OpenAPI docs generation and versioning for endpoints
• Environment variables for config; no hard-coded credentials

Security and Production Rules

• Use TLS in all environments; enable proper CORS settings
• JWT access tokens with short lifetimes; rotate refresh tokens
• Do not expose admin endpoints; log sensitive events securely
• Secrets management via vault or CI secret store
• Audit logging and monitoring in production

Testing Checklist

• Unit tests for Pydantic models and FastAPI routers
• Integration tests for DB interactions with a test PostgreSQL instance
• End-to-end tests for critical HR flows
• Static type checks and linting in CI

Common Mistakes to Avoid

• Hard-coding credentials or secrets
• Skipping input validation on API boundaries
• Overexposing sensitive endpoints or insufficient authorization checks
• Neglecting proper Docker and environment parity between dev and prod

FAQ

What is this CLAUDE.md Template for Angular Material + FastAPI HR Management?

This page provides a copyable Claude Code block and stack-specific guidance to scaffold an HR system using Angular Material for the frontend and FastAPI for the backend.

Which stack does this template cover?

Angular Material on the frontend and FastAPI with PostgreSQL on the backend for HR management tasks.

How do I use the copyable CLAUDE.md Template?

Copy the block under Copyable CLAUDE.md Template into CLAUDE.md at your repo root, adjust paths and secrets, then run the project per the Deployment rules.

What files should I create according to this template?

Frontend and backend folders with modules for HR features, plus tests, docs, and a Docker-based deployment setup.

What security practices are recommended?

Use TLS, JWT-based authentication, proper CORS, rotate tokens, and never store secrets in code.