Bygg NeuroSemantics AI: minimal mobilapp, en backend, IaC och CI/CD
Ersätter den tidigare webappen på denna branch med ett fokuserat monorepo: - apps/mobile: Expo/React Native med tre vyer (Welcome, Chat, Paywall), Cognito hosted UI-inloggning (Apple/Google/e-post) och In-App Purchase/Play Billing via en gemensam purchases-modul. - services/api: en enda Lambda-backend — OpenAI Responses API med Markdown-kunskapsbas som systeminstruktioner, free tier-gräns i PostgreSQL (HTTP 402 -> paywall) och kvittoverifiering bakom ett delat PaymentProvider-interface (Apple/Google, Stripe kan läggas till för webb senare). - infra: AWS CDK-stack med API Gateway (JWT-authorizer), Lambda, Cognito, Aurora Serverless v2 och Secrets Manager. - db/migrations: minimal datamodell (users + usage), inga konversationer sparas. - GitHub Actions: CI (lint, typecheck, test) och deploy från main. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0118DaxZR36RpnY524vRqx3z
This commit is contained in:
Claude
@@ -1,73 +1,112 @@
|
||||
# Welcome to your Lovable project
|
||||
# NeuroSemantics AI
|
||||
|
||||
## Project info
|
||||
A minimalist mobile app for iOS and Android. The product is one thing only:
|
||||
an intelligent conversation partner with a specialized knowledge base in
|
||||
neurosemantics and NLP. No course portal, no CRM, no community.
|
||||
|
||||
**URL**: https://lovable.dev/projects/REPLACE_WITH_PROJECT_ID
|
||||
Design language: calm, simple, clear. Off-white background, near-black text,
|
||||
one dark blue-green accent. No animations, no gradients.
|
||||
|
||||
## How can I edit this code?
|
||||
## System overview
|
||||
|
||||
There are several ways of editing your application.
|
||||
|
||||
**Use Lovable**
|
||||
|
||||
Simply visit the [Lovable Project](https://lovable.dev/projects/REPLACE_WITH_PROJECT_ID) and start prompting.
|
||||
|
||||
Changes made via Lovable will be committed automatically to this repo.
|
||||
|
||||
**Use your preferred IDE**
|
||||
|
||||
If you want to work locally using your own IDE, you can clone this repo and push changes. Pushed changes will also be reflected in Lovable.
|
||||
|
||||
The only requirement is having Node.js & npm installed - [install with nvm](https://github.com/nvm-sh/nvm#installing-and-updating)
|
||||
|
||||
Follow these steps:
|
||||
|
||||
```sh
|
||||
# Step 1: Clone the repository using the project's Git URL.
|
||||
git clone <YOUR_GIT_URL>
|
||||
|
||||
# Step 2: Navigate to the project directory.
|
||||
cd <YOUR_PROJECT_NAME>
|
||||
|
||||
# Step 3: Install the necessary dependencies.
|
||||
npm i
|
||||
|
||||
# Step 4: Start the development server with auto-reloading and an instant preview.
|
||||
npm run dev
|
||||
```
|
||||
apps/mobile Expo / React Native app (three views: Welcome, Chat, Paywall)
|
||||
services/api One Lambda backend (chat, usage, subscription verification)
|
||||
infra AWS CDK stack (the entire cloud environment)
|
||||
db/migrations SQL schema (two tables: users, usage)
|
||||
```
|
||||
|
||||
**Edit a file directly in GitHub**
|
||||
A new developer should understand the whole system in under an hour. Every
|
||||
piece exists for a reason; if a feature does not make the core product better,
|
||||
it is not built.
|
||||
|
||||
- Navigate to the desired file(s).
|
||||
- Click the "Edit" button (pencil icon) at the top right of the file view.
|
||||
- Make your changes and commit the changes.
|
||||
### Request flow
|
||||
|
||||
**Use GitHub Codespaces**
|
||||
1. The app signs in via the **Cognito** hosted UI (Apple / Google / email)
|
||||
and receives a JWT.
|
||||
2. `POST /chat` goes through **API Gateway** (JWT authorizer) to the single
|
||||
**Lambda**.
|
||||
3. The Lambda checks the free-tier quota in **PostgreSQL** (Aurora
|
||||
Serverless v2). Over the limit and not subscribed → HTTP 402 → the app
|
||||
shows the paywall.
|
||||
4. Otherwise it calls the **OpenAI Responses API** with the Markdown
|
||||
knowledge base (`services/api/knowledge/`) as system instructions and
|
||||
returns the reply.
|
||||
|
||||
- Navigate to the main page of your repository.
|
||||
- Click on the "Code" button (green button) near the top right.
|
||||
- Select the "Codespaces" tab.
|
||||
- Click on "New codespace" to launch a new Codespace environment.
|
||||
- Edit files directly within the Codespace and commit and push your changes once you're done.
|
||||
Conversations are never stored server-side; the client holds them in memory
|
||||
and sends the running transcript with each request. The database stores the
|
||||
absolute minimum: `users` (id, email, provider, subscription_status,
|
||||
created_at) and `usage` (messages_used, last_reset). No profiling, no
|
||||
training on user data. Error logging is anonymized (no message content).
|
||||
|
||||
## What technologies are used for this project?
|
||||
### Payments
|
||||
|
||||
This project is built with:
|
||||
Subscription logic is shared (`services/api/src/subscription/`); the payment
|
||||
provider differs per platform behind one `PaymentProvider` interface:
|
||||
|
||||
- Vite
|
||||
- TypeScript
|
||||
- React
|
||||
- shadcn-ui
|
||||
- Tailwind CSS
|
||||
- **iOS** — In-App Purchase; the backend verifies the app receipt with Apple.
|
||||
- **Android** — Google Play Billing; the backend verifies the purchase token
|
||||
with the Play Developer API.
|
||||
- **Web (future)** — a Stripe adapter slots into the same interface.
|
||||
|
||||
## How can I deploy this project?
|
||||
Plans: Monthly and Yearly. Nothing else.
|
||||
|
||||
Simply open [Lovable](https://lovable.dev/projects/REPLACE_WITH_PROJECT_ID) and click on Share -> Publish.
|
||||
Free tier: `FREE_MESSAGE_LIMIT` messages (default 50 ≈ 5–10 conversations),
|
||||
resetting every `USAGE_RESET_DAYS` days.
|
||||
|
||||
## Can I connect a custom domain to my Lovable project?
|
||||
## Getting started
|
||||
|
||||
Yes, you can!
|
||||
```sh
|
||||
npm install # installs all workspaces
|
||||
npm run lint
|
||||
npm run typecheck
|
||||
npm test
|
||||
```
|
||||
|
||||
To connect a domain, navigate to Project > Settings > Domains and click Connect Domain.
|
||||
### Mobile app
|
||||
|
||||
Read more here: [Setting up a custom domain](https://docs.lovable.dev/features/custom-domain#custom-domain)
|
||||
```sh
|
||||
cd apps/mobile
|
||||
npm start # Expo dev server
|
||||
```
|
||||
|
||||
Fill in `extra` in `app.json` (API URL, Cognito domain and client id) from
|
||||
the CDK stack outputs. In-app purchases require a development build
|
||||
(`expo run:ios` / `expo run:android`), not Expo Go.
|
||||
|
||||
### Backend + infrastructure
|
||||
|
||||
```sh
|
||||
cd infra
|
||||
npx cdk deploy
|
||||
```
|
||||
|
||||
After the first deploy:
|
||||
|
||||
1. Put values into the `neurosemantics/app` secret in Secrets Manager:
|
||||
`OPENAI_API_KEY`, `APPLE_SHARED_SECRET`, `GOOGLE_SERVICE_ACCOUNT_JSON`.
|
||||
2. Run `db/migrations/001_init.sql` against the cluster (credentials are in
|
||||
the RDS-managed secret).
|
||||
3. Optional: enable Apple/Google sign-in by passing CDK context
|
||||
(`googleClientId`, `googleClientSecret`, `appleTeamId`, `appleKeyId`,
|
||||
`applePrivateKeySecretName`). Email sign-in works out of the box.
|
||||
|
||||
### CI/CD
|
||||
|
||||
GitHub Actions: `ci.yml` lints, type-checks and tests every PR;
|
||||
`deploy.yml` deploys the CDK stack on every push to `main` (set the
|
||||
`AWS_DEPLOY_ROLE_ARN` secret for OIDC). Store builds ship via EAS
|
||||
(`eas build`) when you choose to release.
|
||||
|
||||
## Security
|
||||
|
||||
- All traffic over HTTPS; every API route requires a Cognito JWT.
|
||||
- Secrets live in AWS Secrets Manager only — no API keys in the client.
|
||||
- The Lambda runs in private subnets; the database is not publicly reachable.
|
||||
|
||||
## Product philosophy
|
||||
|
||||
Every new feature must justify itself. The allowed AWS surface is
|
||||
API Gateway, Lambda, Cognito, S3, Secrets Manager and CloudWatch — and V1
|
||||
does not even need S3. No Redis, no Kubernetes, no Kafka, no Elasticsearch,
|
||||
no queues, no microservices. One backend. Maximal simplicity.
|
||||
|
||||
Reference in New Issue
Block a user