docs(licensedb): Add documentation for LicenseDB integration

[ADITYA-CODE-SOURCE]

Summary

This issue tracks the documentation for LicenseDB integration as part of the GSoC 2026 project (Discussion #3631).

Documentation Requirements

1. Architecture Documentation

• Overview of LicenseDB integration architecture
• Data flow diagrams showing synchronization process
• Component interactions (REST client, transformers, conflict resolvers)

2. Configuration Guide

• How to enable LicenseDB integration
• OAuth2 client setup instructions
• Configuration properties reference
• Sync schedule configuration

3. API Documentation

• REST endpoints for LicenseDB operations
• Request/response schemas
• Authentication requirements

4. User Guide

• How to trigger manual sync
• How to view sync status
• How to resolve conflicts
• Best practices for LicenseDB usage

5. Developer Guide

• How to extend transformers
• How to add custom conflict resolution strategies
• Testing guide for LicenseDB integration

Documentation Location

• docs/licensedb/ - New documentation directory
• Update to main README.md

Related

• Depends on: PR feat(config): Add LicenseDB connection configuration properties #3686 (Configuration)
• Related PR: feat(licensedb): Add data transformation layer for LicenseDB integration #3898 (Data transformers), feat(licensedb): Add exception handling classes for error management #3894 (Exception handling)

Part of

• GSoC 2026: Integration of SW360 and LicenseDB

[SouravVerma-art]

Hi, I'm interested in working on this documentation issue as part of GSoC 2026. I've reviewed the related PRs (#3686, #3898, #3894) to understand the integration architecture and I'm confident I can cover all five documentation areas outlined above. Could you please assign this issue to me? Happy to share a draft outline for feedback before writing the full docs.

[SouravVerma-art]

Hi, I'd like to work on this documentation issue as part of GSoC 2026.

I've studied the related PRs (#3686, #3898, #3894) and have already drafted all 5 documentation sections:

• architecture.md — data flow diagram, component descriptions, field mappings
• configuration.md — all 10 config properties, OAuth2 setup, cron examples
• api.md — REST endpoints with request/response schemas
• user-guide.md — manual sync, conflict resolution, best practices
• developer-guide.md — transformer extension, custom strategies, testing guide

I'll finalize the content once the related PRs are merged and submit a proper PR to docs/licensedb/.

Could you please assign this issue to me? @amritkv @deo002