エンジニア向けガイド
このセクションでは、Jeliqで生成されたプロトタイプを引き継ぎ、品質保証や本番化を行うエンジニア向けの情報を提供します。Jeliqとは
Jeliqは、AI対話型のアプリケーション開発ツールです。非エンジニアでもAIとの対話を通じてフルスタックのWebアプリケーションを生成できます。 生成されるもの：- Reactベースのフロントエンド
- TypeScriptによる型安全なコード
- PostgreSQL（Supabase）によるデータベース
- 認証・認可の基本実装
エンジニアの役割
Jeliqでプロトタイプを作成した後、エンジニアは以下の役割を担います。品質保証
コードレビュー、セキュリティ監査、テストの追加
本番化
環境構築、デプロイ、運用設定
追加開発
Jeliqでは実現できない機能の追加実装
保守運用
バグ修正、パフォーマンス改善、依存関係の更新
技術スタック
Jeliqで生成されるアプリケーションは、以下の技術スタックで構成されています。| カテゴリ | 技術 | バージョン |
|---|---|---|
| フレームワーク | Next.js (App Router) | 14.x |
| 言語 | TypeScript | 5.x |
| UIライブラリ | React | 18.x |
| スタイリング | Tailwind CSS | 3.x |
| データベース | PostgreSQL | 15.x |
| BaaS | Supabase | Latest |
| 認証 | Supabase Auth | Latest |
ドキュメント構成
引き継ぎの流れ
ローカル環境のセットアップ
ローカル環境セットアップに従って開発環境を構築します。
品質保証
品質保証チェックリストに従ってレビューとテストを実施します。
よくある質問
生成されたコードの品質は？
生成されたコードの品質は？
Jeliqは、クリーンアーキテクチャの原則に基づいたコードを生成します。ただし、プロトタイプ段階のため、本番利用前にはエンジニアによるレビューと改善が必要です。注意点：
- エラーハンドリングの強化が必要な場合あり
- テストコードは含まれていない
- パフォーマンス最適化が必要な場合あり
どこまでカスタマイズできますか？
どこまでカスタマイズできますか？
生成されたコードは標準的なNext.js/Reactアプリケーションなので、自由にカスタマイズできます。可能なカスタマイズ例：
- UIデザインの変更
- 機能の追加・修正
- 外部APIとの連携
- 認証方式の変更
- データベーススキーマの変更
Jeliqとの継続的な連携は可能ですか？
Jeliqとの継続的な連携は可能ですか？
現在のバージョンでは、一方向（Jeliq→リポジトリ）のエクスポートのみサポートしています。エンジニアが行った変更をJeliqに取り込む機能は今後のアップデートで予定しています。推奨の運用方法：
- Jeliqからは専用ブランチにエクスポート
- エンジニアは別ブランチで開発
- 必要に応じてマージ
セキュリティは大丈夫ですか？
セキュリティは大丈夫ですか？
基本的なセキュリティ対策（認証、認可、入力バリデーション）は実装されていますが、本番利用前には以下の確認を推奨します。
- 認証・認可のロジック確認
- SQLインジェクション対策の確認
- XSS対策の確認
- 機密情報の取り扱い確認
- 依存パッケージの脆弱性スキャン