How to Keep Cursor Aligned with Microservices Architecture

1# .cursorrules
2
3## Microservices Architecture
4### Services
5- user-service (port 3001): auth, profiles, preferences
6- order-service (port 3002): orders, cart, checkout
7- payment-service (port 3003): payment processing, refunds
8- notification-service (port 3004): email, push, SMS
9
10### Rules
11- Each service has its OWN database — never share tables
12- Services communicate via REST APIs or event bus (RabbitMQ)
13- Never import code directly from another service
14- API contracts defined in /contracts/{service}.openapi.yml
15- Use service client libraries for inter-service calls
16- Each service is independently deployable

1---
2description: Order service boundaries
3globs: "services/order-service/**"
4alwaysApply: false
5---
6
7- Database: orders_db (PostgreSQL) — only access orders, order_items, cart tables
8- API base: /api/orders
9- Dependencies: @company/user-client for user lookups, @company/payment-client for payments
10- NEVER import from services/user-service/ or services/payment-service/ directly
11- Publish events: OrderCreated, OrderCancelled, OrderCompleted
12- Subscribe to: PaymentCompleted, PaymentFailed
13- Port: 3002, configured via ORDER_SERVICE_PORT env var

1// Prompt to type in Cursor Composer (Cmd+I):
2// @contracts/user-service.openapi.yml @services/order-service/src/clients/
3// Generate a function in the order service that:
4// 1. Fetches user details from the user service via REST client
5// 2. Creates an order in the local orders_db
6// 3. Publishes an OrderCreated event to RabbitMQ
7// 4. Returns the created order with user name
8// Use the existing service client pattern from the clients/ directory.
9// Handle: user not found, service unavailable, timeout scenarios.

1// Prompt to type in Cursor Composer (Cmd+I):
2// @services/order-service/src/routes/
3// Generate an OpenAPI 3.1 specification for the order service.
4// Include all endpoints from the routes directory.
5// For each endpoint: path, method, request body, response schema, error responses.
6// Save to contracts/order-service.openapi.yml