docs: Rebuild documentation as enterprise-grade TLAS platform

- Migrate from custom HTTP server to VitePress framework
- Rename project to Tokenized License Approval System (TLAS)
- Add comprehensive documentation for all stakeholders:
  - Business: Executive summary, value proposition, governance
  - Operations: Infrastructure, installation, monitoring, backup
  - Departments: User guide, workflows, verification, issuance
  - Developers: API reference, authentication, webhooks, SDKs
  - Compliance: OWASP, DPDP Act, IT Act, audit framework
- Add modern theme with dark mode and full-text search
- Update Dockerfile for VitePress build process

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Mahi
2026-02-10 00:05:20 -04:00
parent 4a5bf16827
commit 435889ee79
65 changed files with 6324 additions and 8342 deletions

View File

@@ -0,0 +1,88 @@
# Error Handling
## Error Response Format
```json
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Human-readable error message",
"details": [
{ "field": "email", "message": "Invalid email format" }
],
"requestId": "req_abc123"
}
}
```
## HTTP Status Codes
| Code | Meaning |
|------|---------|
| 200 | Success |
| 201 | Created |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 409 | Conflict |
| 422 | Validation Error |
| 429 | Rate Limited |
| 500 | Internal Error |
## Error Codes
### Authentication Errors
| Code | Description |
|------|-------------|
| `AUTH_INVALID_TOKEN` | Token is invalid or malformed |
| `AUTH_EXPIRED_TOKEN` | Token has expired |
| `AUTH_MISSING_TOKEN` | No token provided |
| `AUTH_INSUFFICIENT_SCOPE` | Token lacks required permissions |
### Validation Errors
| Code | Description |
|------|-------------|
| `VALIDATION_ERROR` | Input validation failed |
| `VALIDATION_REQUIRED` | Required field missing |
| `VALIDATION_FORMAT` | Invalid field format |
| `VALIDATION_RANGE` | Value out of allowed range |
### Resource Errors
| Code | Description |
|------|-------------|
| `RESOURCE_NOT_FOUND` | Requested resource doesn't exist |
| `RESOURCE_CONFLICT` | Resource state conflict |
| `RESOURCE_LOCKED` | Resource is locked |
### Business Logic Errors
| Code | Description |
|------|-------------|
| `APPLICATION_INVALID_STATE` | Action not allowed in current state |
| `DOCUMENT_TYPE_MISMATCH` | Wrong document type |
| `WORKFLOW_ERROR` | Workflow processing error |
## Handling Errors
```javascript
try {
const result = await client.applications.create(data);
} catch (error) {
if (error.code === 'VALIDATION_ERROR') {
// Handle validation errors
error.details.forEach(d => console.log(`${d.field}: ${d.message}`));
} else if (error.code === 'AUTH_EXPIRED_TOKEN') {
// Refresh token and retry
await client.refreshToken();
return retry();
} else {
// Log and report
console.error('Unexpected error:', error.requestId);
}
}
```