Add comprehensive JWT authentication documentation

[Copilot]

User requested documentation explaining how authentication works in this FastAPI project.

Changes

• Added DOCS/AUTHENTICATION.MD - Comprehensive guide covering:

  • JWT token lifecycle (generation, validation, expiration)
  • BCrypt password hashing implementation
  • OAuth2 password flow endpoints
  • Integration with RBAC authorization system
  • Security configuration (secret keys, token expiration)
  • Code examples in cURL, Python, JavaScript
  • Architecture overview (router → controller → security utilities)

• Updated README.MD - Added reference to authentication documentation in technical docs section

Key Implementation Details

The authentication system uses:

• python-jose for JWT encoding/decoding with HS256
• bcrypt for password hashing with automatic salting
• FastAPI's OAuth2PasswordBearer dependency for token extraction
• 30-minute default token expiration (configurable)

Token payload structure:

{
  "sub": "username",
  "exp": 1234567890,
  "iat": 1234567890,
  "nbf": 1234567890,
  "iss": "FA-Backend"
}

Documentation written in Portuguese to match existing project docs.

Original prompt

como funciona a parte de authentication desse projeto?

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[jvras58]

LTTM

[Copilot]

Pull request overview

This PR adds comprehensive documentation for the JWT authentication system in response to a user inquiry about how authentication works in the project. The documentation is written in Portuguese to align with existing project documentation.

Key Changes:

• Created detailed authentication guide covering JWT lifecycle, password security, OAuth2 flow, and RBAC integration
• Added reference to the new authentication documentation in the main README

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
README.MD	Added new section referencing the authentication documentation with links and overview bullets
DOCS/AUTHENTICATION.MD	Comprehensive guide documenting JWT authentication implementation, security practices, code examples, and integration with the authorization system

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.