Daily management web app (MVP-1): login, workspaces, members (manual), projects, items, comments, activity log.
codes/web: Next.js webcodes/core-service: FastAPI core API (uv) —make core-servicecodes/app: native client placeholder (iOS, future)- Future backends (e.g.
notification-service,finance-service): each undercodes/<name>/, own Makefile target, Docker service, and nginx/<name>/route
make local # Postgres in Docker
make core-service-install && make core-service # terminal 1
make web-install && make web # terminal 2
make verify # smoke check API (+ Web if running)
make codegen # export OpenAPI → src/types/api/generated.ts (after API changes)make dbmake core-service-install
make core-serviceIf you renamed or moved this repo, delete the stale virtualenv and reinstall:
rm -rf codes/core-service/.venv && make core-service-installIf uv sync times out downloading packages (e.g. cryptography), use a PyPI mirror:
UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple make core-service-installmake web-install
make web- Copy values from
.env.exampleinto:codes/core-service/.envcodes/web/.env.local
See docs/deploy/cloud.md.
| Command | Where | Purpose |
|---|---|---|
bash deploy/local.sh |
production server | git sync → build → up |
bash deploy/remote.sh |
dev machine | build images locally → upload to server |