Charles BochetandGitHub
9d57bc39e5
## Summary Fully replaces ESLint with OxLint across the entire monorepo: - **Replaced all ESLint configs** (`eslint.config.mjs`) with OxLint configs (`.oxlintrc.json`) for every package: `twenty-front`, `twenty-server`, `twenty-emails`, `twenty-ui`, `twenty-shared`, `twenty-sdk`, `twenty-zapier`, `twenty-docs`, `twenty-website`, `twenty-apps/*`, `create-twenty-app` - **Migrated custom lint rules** from ESLint plugin format to OxLint JS plugin system (`@oxlint/plugins`), including `styled-components-prefixed-with-styled`, `no-hardcoded-colors`, `sort-css-properties-alphabetically`, `graphql-resolvers-should-be-guarded`, `rest-api-methods-should-be-guarded`, `max-consts-per-file`, and Jotai-related rules - **Migrated custom rule tests** from ESLint `RuleTester` + Jest to `oxlint/plugins-dev` `RuleTester` + Vitest - **Removed all ESLint dependencies** from `package.json` files and regenerated lockfiles - **Updated Nx targets** (`lint`, `lint:diff-with-main`, `fmt`) in `nx.json` and per-project `project.json` to use `oxlint` commands with proper `dependsOn` for plugin builds - **Updated CI workflows** (`.github/workflows/ci-*.yaml`) — no more ESLint executor - **Updated IDE setup**: replaced `dbaeumer.vscode-eslint` with `oxc.oxc-vscode` extension, configured `source.fixAll.oxc` and format-on-save with Prettier - **Replaced all `eslint-disable` comments** with `oxlint-disable` equivalents across the codebase - **Updated docs** (`twenty-docs`) to reference OxLint instead of ESLint - **Renamed** `twenty-eslint-rules` package to `twenty-oxlint-rules` ### Temporarily disabled rules (tracked in `OXLINT_MIGRATION_TODO.md`) | Rule | Package | Violations | Auto-fixable | |------|---------|-----------|-------------| | `twenty/sort-css-properties-alphabetically` | twenty-front | 578 | Yes | | `typescript/consistent-type-imports` | twenty-server | 3814 | Yes | | `twenty/max-consts-per-file` | twenty-server | 94 | No | ### Dropped plugins (no OxLint equivalent) `eslint-plugin-project-structure`, `lingui/*`, `@stylistic/*`, `import/order`, `prefer-arrow/prefer-arrow-functions`, `eslint-plugin-mdx`, `@next/eslint-plugin-next`, `eslint-plugin-storybook`, `eslint-plugin-react-refresh`. Partial coverage for `jsx-a11y` and `unused-imports`. ### Additional fixes (pre-existing issues exposed by merge) - Fixed `EmailThreadPreview.tsx` broken import from main rename (`useOpenEmailThreadInSidePanel`) - Restored truthiness guard in `getActivityTargetObjectRecords.ts` - Fixed `AgentTurnResolver` return types to match entity (virtual `fileMediaType`/`fileUrl` are resolved via `@ResolveField()`) ## Test plan - [x] `npx nx lint twenty-front` passes - [x] `npx nx lint twenty-server` passes - [x] `npx nx lint twenty-docs` passes - [x] Custom oxlint rules validated with Vitest: `npx nx test twenty-oxlint-rules` - [x] `npx nx typecheck twenty-front` passes - [x] `npx nx typecheck twenty-server` passes - [x] CI workflows trigger correctly with `dependsOn: ["twenty-oxlint-rules:build"]` - [x] IDE linting works with `oxc.oxc-vscode` extension
104 lines
2.6 KiB
Plaintext
104 lines
2.6 KiB
Plaintext
---
|
||
title: Backend Komutları
|
||
---
|
||
|
||
## Faydalı Komutlar
|
||
|
||
Bu komutlar packages/twenty-server klasöründen çalıştırılmalıdır.
|
||
Diğer herhangi bir klasörden `npx nx {command} twenty-server` (veya `npx nx run twenty-server:{command}`) çalıştırabilirsiniz.
|
||
|
||
### İlk Kurulum
|
||
|
||
```
|
||
npx nx database:reset twenty-server # veritabanını geliştirme tohum verileriyle kur
|
||
```
|
||
|
||
### Sunucuyu Başlatma
|
||
|
||
```
|
||
npx nx run twenty-server:start
|
||
```
|
||
|
||
### Kod Temizleme
|
||
|
||
```
|
||
npx nx run twenty-server:lint # lint hatalarını düzeltmek için --fix'i geç
|
||
```
|
||
|
||
### Test
|
||
|
||
```
|
||
npx nx run twenty-server:test:unit # birim testleri çalıştır
|
||
npx nx run twenty-server:test:integration # entegrasyon testlerini çalıştır
|
||
```
|
||
|
||
Not: Entegrasyon testlerini çalıştırmadan önce veritabanını sıfırlamanız gerekirse `npx nx run twenty-server:test:integration:with-db-reset` komutunu kullanabilirsiniz.
|
||
|
||
### Veritabanını Sıfırlama
|
||
|
||
Veritabanını sıfırlamak ve tohum yüklemek istiyorsanız, aşağıdaki komutu kullanabilirsiniz:
|
||
|
||
```bash
|
||
npx nx run twenty-server:database:reset
|
||
```
|
||
|
||
### Geçişler
|
||
|
||
#### Core/Metadata şemalarında (TypeORM) nesneler için
|
||
|
||
```bash
|
||
npx nx run twenty-server:typeorm migration:generate src/database/typeorm/core/migrations/nameOfYourMigration -d src/database/typeorm/core/core.datasource.ts
|
||
```
|
||
|
||
#### Çalışma Alanı Nesneleri İçin
|
||
|
||
Çalışma alanı için geçiş dosyaları yoktur; her çalışma alanı için otomatik olarak oluşturulur,
|
||
veritabanında depolanır ve bu komut ile uygulanır.
|
||
|
||
```bash
|
||
npx nx run twenty-server:command workspace:sync-metadata -f
|
||
```
|
||
|
||
<Warning>
|
||
|
||
Bu işlem veritabanını siler, migrasyonları ve tohumlamayı yeniden çalıştırır.
|
||
|
||
Bu komutu çalıştırmadan önce saklamak istediğiniz verileri yedeklediğinizden emin olun.
|
||
|
||
</Warning>
|
||
|
||
## Teknoloji Yığını
|
||
|
||
Twenty, arka uç için öncelikle NestJS kullanır.
|
||
|
||
Prisma, kullandığımız ilk ORM idi. Ancak, kullanıcıların özel alanlar ve özel nesneler oluşturmasına izin vermek için, ince ayar kontrolü gerektirdiği için alt düzey bir seviye daha mantıklı geldi. Proje şu anda TypeORM kullanmaktadır.
|
||
|
||
İşte teknoloji yığını artık böyle görünüyor.
|
||
|
||
**Çekirdek**
|
||
|
||
* [NestJS](https://nestjs.com/)
|
||
* [TypeORM](https://typeorm.io/)
|
||
* [GraphQL Yoga](https://the-guild.dev/graphql/yoga-server)
|
||
|
||
**Veritabanı**
|
||
|
||
* [Postgres](https://www.postgresql.org/)
|
||
|
||
**Üçüncü Şahıs Entegrasyonları**
|
||
|
||
* [Sentry](https://sentry.io/welcome/) hataları izlemek için
|
||
|
||
**Test**
|
||
|
||
* [Jest](https://jestjs.io/)
|
||
|
||
**Araçlar**
|
||
|
||
* [Yarn](https://yarnpkg.com/)
|
||
* [Oxlint](https://oxc.rs/docs/guide/usage/linter.html)
|
||
|
||
**Geliştirme**
|
||
|
||
* [AWS EKS](https://aws.amazon.com/eks/)
|