mirror of
https://github.com/hcengineering/platform.git
synced 2026-09-26 11:34:58 +02:00
remove to prepare for subtree
Signed-off-by: Denis Bykhov <bykhov.denis@gmail.com>
This commit is contained in:
@@ -1,61 +0,0 @@
|
||||
# Huly Server - Copilot Context
|
||||
|
||||
## Project Overview
|
||||
|
||||
**Monorepo**: Rush-managed backend infrastructure for Huly Platform
|
||||
**Stack**: TypeScript, Node.js v20.11.0+, pnpm 10.15.1, Rush 5.158.1, Jest
|
||||
**License**: Eclipse Public License 2.0 (Hardcore Engineering Inc.)
|
||||
|
||||
## Package Categories
|
||||
|
||||
- **Core**: core, server, client, middleware
|
||||
- **Database**: mongo, postgres, elastic
|
||||
- **Storage**: server-storage, minio, s3, datalake, hulylake
|
||||
- **Infrastructure**: kafka, collaboration
|
||||
|
||||
Standard structure: `src/` → `lib/` (compiled), `tsconfig.json`, `jest.config.js`, `package.json` with `@hcengineering/` scope
|
||||
|
||||
## Essential Commands
|
||||
|
||||
**Setup & Build:**
|
||||
|
||||
```bash
|
||||
rush install # Install dependencies
|
||||
rush build # Build all packages
|
||||
cd packages/<pkg> && rushx build # Build specific package
|
||||
```
|
||||
|
||||
**Testing:**
|
||||
|
||||
```bash
|
||||
cd tests && ./prepare-tests.sh # First time: start Docker services (Elasticsearch, MongoDB, CockroachDB, Redpanda)
|
||||
rush test # Run all tests
|
||||
npm run test:coverage # With coverage
|
||||
```
|
||||
|
||||
**Common Tasks:**
|
||||
|
||||
- New package: Create dir in `packages/`, add to `rush.json`, run `rush update`
|
||||
- Update deps: Edit `package.json`, run `rush update`, verify with `rush build`
|
||||
- Troubleshoot: Check `packages/<pkg>/rush-logs/` for build errors, `coverage/` for test results
|
||||
|
||||
## Key Concepts
|
||||
|
||||
- **Domain Model**: WorkspaceIds (multi-tenant), Transactions (Tx), Documents (Doc), Domains, Permissions
|
||||
- **Architecture**: Pluggable adapters, middleware pipeline, abstract storage, Kafka messaging, CRDT collaboration
|
||||
- **Testing**: Docker Compose integration tests in `tests/`, `prepare-tests.sh` auto-detects running containers
|
||||
|
||||
## Coding Standards
|
||||
|
||||
- TypeScript strict mode, Prettier formatting
|
||||
- Imports: `@hcengineering/` namespace, named imports, grouped (external/internal/types)
|
||||
- Errors: `PlatformError` from `@hcengineering/platform`, `unknownError` wrapper
|
||||
- Async: `async/await`, `MeasureContext` for cancellation, cleanup in finally blocks
|
||||
- Security: No secrets in code, validate inputs, prepared statements, rate limiting
|
||||
|
||||
## Quick Reference
|
||||
|
||||
- Config: `rush.json`, `.nvmrc`, `common/config/rush/`
|
||||
- Logs: `packages/<pkg>/rush-logs/`, `coverage/html/`
|
||||
- Docs: `docs/tx-ordering-middleware-implementation.md`
|
||||
- Tests: Force restart with `docker compose -p sanity down`
|
||||
Reference in New Issue
Block a user