- Backend: FastAPI app with all models, services, schemas, routes - Admin Panel: Next.js dashboard with all modules (CRM, POS, repairs, warranties, billing, notifications, etc.) - Ecommerce: storefront (submodule) + product catalog - AI Agents: .agents/ skill library for Antigravity IDE - Docs: architecture, billing, notification gateway markdown - Submodules: Backend/OpenWA, Ecommerce/File 2/storefront
1.2 KiB
1.2 KiB
| name | description |
|---|---|
| Logging Observability | Enforce structured logging standards and telemetry collection |
Skill: Logging Observability
1. Purpose
Provide tracking logs during production runtime operations to simplify troubleshooting.
2. When to Use
When writing new controllers, background tasks, or async events.
3. Preconditions
- Standard JSON logging system instantiated in backend/frontend context.
4. Step-by-Step Checklist
- Instantiate standard logger instances (do not use print statements).
- Write structured log statements detailing action context.
- Log exception details under error severity levels.
- Propagate request correlation IDs through downstream calls.
5. Validation Checklist
- Logs write in standard JSON format containing execution metadata.
- Errors capture clear call stack tracebacks.
6. Examples
logger.info("creating_booking_initiated", extra={"customer_id": payload.customer_id})
try:
db.commit()
except Exception as e:
logger.exception("creating_booking_failed", extra={"customer_id": payload.customer_id})
raise e
7. Failure Cases
- Logging plaintext password fields, payment hashes, or personally identifiable information (PII).